زهرتا عباد شمس مقطوعتان على خلفية من الطلاء الأزرق. اطلبهما باللغة الإسبانية وستحصل على بطاقة جدارية للوحة Sunflowers لفنسنت فان جوخ، كاملة مع السنة والمادة المستخدمة ورابط إلى الأصل. أضف كلمة «قطط» إلى الدليل، وسيقودك المسار إلى مروحة يدوية حريرية فرنسية.
ستقوم بإنشاء Collection Detective، وهو روبوت دردشة متحفي متعدد اللغات يبحث في واجهة برمجة تطبيقات (API) مجموعة متحف المتروبوليتان ويكتب بطاقة وصفية موجزة للأعمال الفنية التي يعثر عليها. ابدأ باللوحة أدناه. وبنهاية هذا الدليل، ستتمكن من متابعة أي من الدليلين في Quickchat AI ومقارنة الإجابة مع فهرس المتحف نفسه.
احتفظ Quickchat AI بعنوان Sunflowers وترجم الوسيط إلى «óleo sobre lienzo». قارن الإجابة بلوحة معلومات المتحف في Google Arts & Culture. متحف المتروبوليتان، Rogers Fund, 1949. افتح سجل المتحف.
1. أعطِ روبوت الدردشة المتحفي دليله الأول
يقدم الزائر موضوعًا ولغة. ويجري المحقق عمليتي بحث. الأولى تعثر على مُعرّفات الكائنات المرشحة. والثانية تفتح مُعرّفًا واحدًا وتجلب اسم الفنان والعنوان والتاريخ والوسيط الفني ورابط المصدر. عندها فقط يكتب المحقق البطاقة الوصفية.
- سجّل الدخول أو أنشئ حسابًا على Quickchat AI. استخدم وكيلًا (Agent) فارغًا أو حدد Add new AI Agent → Set up manually. قم بتسميته Collection Detective. ستحتاج إلى أرصدة كافية لإجراء بضع محادثات تجريبية. تعمل عمليات البحث في المتحف دون الحاجة إلى حساب في المتحف أو مفتاح API.
- افتح Identity → AI Persona → Main Prompt. الصق التعليمات أدناه، ثم أغلق اللوحة. يحفظ قسم Identity تعديلاتك تلقائيًا. تخبر هذه التعليمات المحقق بكيفية اختيار سجل وأي التفاصيل يجب الاحتفاظ بها عند تغيير اللغات.
انسخ Main Prompt لـ Collection Detective
Guide visitors through The Met’s online collection. Reply in the visitor’s requested language. For a theme, search the catalogue with a short English equivalent and tell the visitor which term you used. For an explicit object ID, go straight to the object lookup. Fetch the first returned record unless the visitor selects another. Use the record before stating any facts.
Keep original titles and artist names. Translate attribution qualifiers and approximate dates into the visitor’s language, preserving their uncertainty. Give dates and materials in that language. Link the returned objectURL with a short label. If isPublicDomain is true and primaryImageSmall or primaryImage is present, offer a short link to the image. Otherwise give the museum record only. Keep each answer to a short museum label.
For a comparison, check both records and compare their recorded materials. Empty fields are unknown. If a search is empty, ask for a broader term. If a request fails, say which lookup failed. For meaning, intent or today’s gallery location, explain what the record can establish and refer the visitor to the museum.
- في Identity → Languages، أضف الإنجليزية والإسبانية. أضفنا أيضًا اليابانية للتحقق من لغة ثانية. اللغة الأولى هي اللغة الاحتياطية للرسائل الغامضة. كيف تعمل تلميحات اللغة
يوجد اسم الوكيل (Agent) وتعليماته في قسم Identity. وتوضع عمليات البحث في الفهرس في قسم Actions & MCPs في الخطوة التالية.
- احتفظ برسالة الزائر الأولى هذه لـ AI Preview بمجرد تمكين كلا الإجراءين. يطلب الزائر العثور على زهور عباد الشمس وشرح العمل الأول باللغة الإسبانية.
Busca girasoles en la colección del Met y explícame la primera obra en español.
لغة البحث مهمة. في 19 نوفمبر 2026، أعاد المتحف صفر نتائج لكلمة girasoles و153 نتيجة لكلمة sunflowers بنفس المرشحات. دع الزائر يسأل بالإسبانية، وابحث عن مصطلح الفهرس الإنجليزي القصير وأخبره بالكلمة التي استخدمتها.
2. كيف تبحث في واجهة برمجة تطبيقات مجموعة متحف المتروبوليتان؟
امنح الإجراء الأول مُدخلًا واحدًا، وهو الموضوع. اجعل البحث صغيرًا بما يكفي ليتمكن الزائر من تتبُّع المسار. ثلاثة مرشحين يتيحون لك فتح العمل الأول ويبقى لديك عمل آخر للبحث فيه.
- في Actions & MCPs، اختر Add Action → API Action → Create manually. اضبط API Action Name على
search_met_collectionوWhen to run على AI decides. يُظهر دليل إجراءات واجهة برمجة التطبيقات نفس المحرر بطلب أبسط. - تحت What to ask the user first، أضف مُعامل Text مطلوبًا يسمى
theme. لوصفه، أدخل “A short English catalogue search phrase, such as sunflowers or cats and sunflowers.” - في API Endpoint، اختر GET وأدخل
https://collectionapi.metmuseum.org/public/collection/v1.1/search. في Query Params، أنشئ هذه الصفوف الأربعة. استخدم Add AI Data → Parameters للقيمة الأولى بحيث يتم إدراج موضوع الزائر في الطلب.
| مفتاح الاستعلام | القيمة المراد إدخالها |
|---|---|
q | أدخل شريحة المعلمة theme. |
hasImages | true |
limit | 3 |
offset | 0 |

q فقط يأخذ موضوع الزائر. القيم الثلاث الأخرى تبقى ثابتة. اقرأ مرجع Search (v1.1) لمتحف المتروبوليتان.
- تحت Headers، أدخل
Acceptبالقيمةapplication/json. اترك Body فارغًا. الصق ما يلي في API Action Description، اختر Save changes وتأكد من أن مفتاح الإجراء قيد التشغيل.
انسخ وصف إجراء البحث
Search The Met’s online collection for a visitor’s theme, using a short English catalogue term. Return up to three candidate object IDs. Call get_met_object for a selected ID before describing any work. For an empty result, ask for a broader theme.
افتح بحث عباد الشمس في متصفحك. هذا هو الرد الكامل من بحثنا. يشمل العدد كل تطابق. تحتوي القائمة فقط على المُعرّفات الثلاثة التي طلبناها، ويمكن أن يتغير ترتيبها مع تغير الفهرس.
{"total":153,"objectIDs":[436524,480725,484935]}
3. حوِّل مُعرّف كائن إلى بطاقة متحفية إسبانية
ابدأ بـ 436524، وهو أول مُعرّف في ذلك الرد. يبحث الإجراء الثاني عنه مباشرة. يستخدم متحف المتروبوليتان v1.1 للبحث وv1 للكائنات الفردية. إذا أعاد مثال بحث قديم خطأ HTTP 410، فغيّر مسار البحث واترك مسار الكائن عند v1. مرجع واجهة برمجة تطبيقات مجموعة المتروبوليتان
- أنشئ API Action آخر. اضبط API Action Name على
get_met_objectوWhen to run على AI decides. تحت What to ask the user first، أضف Number مطلوبًا باسمobject_id. صفه بأنه “The integer Met object ID from a search result or the visitor.” - في API Endpoint، اختر GET. أدخل
https://collectionapi.metmuseum.org/public/collection/v1/objects/، اترك الشرطة المائلة النهائية في مكانها واستخدم Add AI Data → Parameters لإلحاق شريحةobject_id. مع أول معرف لدينا، ينتهي العنوان بـ/objects/436524. - اترك Query Params وBody فارغين. في Headers استخدم
Acceptمعapplication/json. الصق الوصف أدناه في API Action Description، اختر Save changes وتأكد من أن مفتاح الإجراء قيد التشغيل.
انسخ وصف إجراء الكائن
Retrieve one Met object by a returned or visitor-supplied object ID. Use its title, names and qualifiers, date, medium and objectURL for the label. Offer an image only if the public-domain flag is true and an image URL is present.
في إجراء البحث، تذهب كلمة الزائر في صف استعلام. هنا يصبح الرقم جزءًا من العنوان نفسه.
افتح AI Preview وأرسل الدليل الأول. ابحث عن العنوان الأصلي Sunflowers، وVincent van Gogh، و1887، وóleo sobre lienzo. اتبع رابط المتحف في الإجابة. تسرد الصفحة أيضًا 49.41 كرقم للكائن. هذا هو رقم اقتناء المتحف للعمل. استخدم 436524 في واجهة برمجة التطبيقات. يعود عام 1949 في سطر الإهداء إلى تاريخ اقتناء صندوق روجرز للعمل. أما اللوحة نفسها فتعود إلى عام 1887. اقرأ بيانات الكائن
افتح اللوحة بالعدسة المكبرة وابحث عن “Vincent 87” في الزاوية السفلية اليسرى. في صفحة العمل الفني، انتقل إلى Details وقارن التوقيع بالسنة تحت Date Created. استكشف لوحة Sunflowers لمتحف المتروبوليتان على Google Arts & Culture.
إعداد نفس الإجراءين من مساعد ذكاء اصطناعي متصل
إذا كنت تدير Quickchat AI من خلال ChatGPT أو Claude، يمكنك أيضًا استخدام الوصفتين أعلاه مع طلب الإعداد هذا. راجع الحقول التي تم إنشاؤها، ثم قم بتشغيل القرينة الأولى بنفسك. تعليمات ربط الحساب
Draft the two API Action configurations for my Collection Detective agent here first. Use the supplied names, URLs, required parameters and descriptions. Bind the theme to the search query and the numeric object ID to the object path. Neither request needs authentication or a body. After I approve both configurations, create the Actions.
4. كيف تتحقق من بطاقة وصفية مترجمة لعمل فني؟
في Inbox، افتح المحادثة ووسّع 2 actions called أسفل الإجابة. للحصول على تفاصيل الطلب، انتقل إلى Actions & MCPs → Custom Actions وحدد View logs لكل إجراء. ابحث عن 436524 في استجابة البحث وفي نهاية الطلب التالي. تتيح لك مطابقة هذه الأرقام تتبُّع البطاقة الوصفية الإسبانية إلى كائن واحد حتى لو كان لعمل آخر نفس العنوان.
اتبع المعرف الأول من نتيجة البحث إلى البحث عن الكائن. هذا التسليم هو ما يربط الإجابة باللوحة.
جرب هذه الأدلة في محادثات جديدة. لتكرارها بعد تعديل الموجه، افتح Testing → Create Dataset، وقم بتسمية مجموعة البيانات وأدخل الأسئلة. حدد Run Tests → Start Run، ثم View على نتيجة مكتملة لفتح محادثتها في Inbox.
تحقق من نسبة العمل. اطلب بطاقة وصفية باللغة الإسبانية للكائن 437406. يذكر سجله Rembrandt كالاسم وFollower of كبادئة. أوضح ردنا الأول نسبة العمل بالإسبانية، لكنه ترك سطر الفنان باللغة الإنجليزية. قمنا بتعديل إحدى التعليمات لترجمة الصفة بالإضافة إلى الوسيط. قدم الرد التالي un seguidor de Rembrandt واحتفظ بعدم اليقين في التاريخ، probablemente hacia 1658–62. اقرأ مدخل الفهرس للوحة The Auctioneer.
كلمتان تحملان الإسناد. “Follower of” تنتمي إلى اسم الفنان في كلتا اللغتين. متحف المتروبوليتان، Bequest of Benjamin Altman, 1913.
تحقق من الصورة. اطلب رؤية الكائن 480725، ثاني تطابق لعباد الشمس. لوحة إميل نولده Large Sunflowers مؤرخة بعام 1928 ومرسومة على لوح خشبي. سجلها يحتوي على isPublicDomain: false وعناوين URL فارغة للصور. أعطِ الزائر رابط الفهرس والمادة. هذا المثال يوضح لماذا لا يمكن لـ hasImages=true وحدها تحديد الصورة التي يجب عرضها. اقرأ سجل نولده.
يمكن للمتحف مشاركة تفاصيل الفهرس حتى عندما لا توفر واجهة برمجة التطبيقات (API) صورة قابلة لإعادة الاستخدام. سياسة صور الوصول المفتوح (Open Access) لمتحف المتروبوليتان.
تحقق من بحث فارغ. اطلب المصطلح الدقيق zzzxxyycollectiontest. أعادت واجهة برمجة التطبيقات (API) النتيجة {"total":0,"objectIDs":null}. يمكن للمحقق أن يطلب دليلًا أوسع نطاقًا. البحث الفاشل يحتاج إلى إجابة مختلفة. عندما قمنا بمحاكاة خطأ HTTP 503، طلب المحقق من الزائر المحاولة مرة أخرى لاحقًا ولم يقم بأي طلب كائن.
5. تتبَّع زهور عباد الشمس إلى مروحة يدوية حريرية
احتفظ بالزهور وأضف حيوانًا. أعطِ Collection Detective دليلًا ثانيًا واسأل عن السطح الذي عمل عليه كل فنان. يمكنك استخدام هذه الرسالة كما هي مكتوبة.
Busca «cats and sunflowers» y compara el soporte de la primera obra con el de Sunflowers (436524).
جرب البحث الثاني. كان أول معرفين لدينا هما 705155 و436524. يصنف متحف المتروبوليتان العمل الأول على أنه رسم. على Wikimedia Commons، اختر Open in Media Viewer أسفل صورة المتحف. اتبع القطط البيضاء على طول الريشات وابحث عن اللمعان بين زهور دوار الشمس. افحص المروحة على Wikimedia Commons.
هنري تشارلز جيرار، Fan Design with Cats and Sunflowers، ca. 1885–90. متحف المتروبوليتان، Gift of Robert Tuggle and Paul Jeromack, 2015. استكشف المروحة في متحف المتروبوليتان.
عمل فان جوخ على القماش. عمل جيرار على الحرير المنقوش. اللمعان بين عباد الشمس له تفسير مادي. يسرد المتحف أوراق الذهب بجانب الحبر والغواش. يبقى التاريخ تقريبيًا، ca. 1885–90. لإنشاء بحثك الخاص المكون من محطتين، اختر تفصيلاً من العمل الأول، وأضفه إلى الدليل التالي، واسأل المحقق عن اختلاف واحد يمكنك التحقق منه في كلتا صفحتي القطعة.
الأسئلة الشائعة حول روبوت الدردشة بالمتحف
هل أحتاج إلى مفتاح API للبحث في مجموعة متحف المتروبوليتان؟
يوفر متحف المتروبوليتان للفنون نقاط نهاية للبحث العام والكائنات الفنية دون الحاجة إلى التسجيل أو مفتاح واجهة برمجة التطبيقات (API). يمكنك فتح كلا الطلبين في متصفح. يستخدم Quickchat AI أرصدة الحساب لإجراء محادثة الروبوت.
ما هي نقطة نهاية واجهة برمجة تطبيقات متحف المتروبوليتان (Met API) التي تعرض العمل الفني وصورته؟
استخدم /public/collection/v1.1/search للحصول على مُعرّفات الكائنات المرشحة. مرِّر مُعرّفًا واحدًا إلى /public/collection/v1/objects/{id} للحصول على العنوان، واسم الفنان، والتاريخ، والوسيط الفني، ورابط المتحف، وأي عناوين URL متاحة لصور الوصول المفتوح (Open Access).
هل يمكن لروبوت الدردشة الخاص بالمتحف الإجابة باللغة الإسبانية أو بأي لغة أخرى؟
نعم. اطلب المعلومات بلغة الزائر، وابحث باستخدام مصطلح قصير من الكتالوج باللغة الإنجليزية، ثم ترجم الشرح. احتفظ بالعنوان الأصلي والأسماء ومؤهلات النسب حتى يتمكن الزائر من التحقق من سجل المتحف.
هل يمكنني إعادة استخدام كل صورة تظهر في نتائج بحث متحف المتروبوليتان؟
تحقق من سجل الكائن الفني الفردي. يتيح متحف المتروبوليتان صوره ذات الوصول المفتوح (Open Access) بموجب ترخيص CC0. لا يعرض روبوت الدردشة هذا الصورة إلا عندما تكون قيمة isPublicDomain هي true وعندما يتوفر عنوان URL للصورة الرئيسية. وإلا، فإنه يضع رابطًا إلى صفحة المتحف.
هل يمكن لروبوت الدردشة أن يخبرني ما إذا كان العمل معروضًا اليوم أم لا؟
للزيارة، افتح صفحة الكائن الحالية في موقع المتحف وتحقق من معلومات العرض الخاصة بها. يتيح البحث في المجموعة العثور على الأعمال المفهرسة، بما في ذلك الأعمال الموجودة في المخازن.
هل يمكن لروبوت الدردشة أن يشرح ما قصده الفنان؟
يقدم لك سجل الكائن الفني حقائق من الفهرس مثل الوسيط الفني وتاريخ الإنشاء. لشرح مقاصد الفنان أو رمز ما في العمل الفني، استخدم مصدرًا إضافيًا، مثل مقال لأحد أمناء المتحف حول ذلك العمل الفني بالذات.