Два зрізані соняшники лежать на синьому тлі. Запитайте про них іспанською, і ви можете отримати етикетку для стіни для Sunflowers Вінсента ван Гога, з роком, матеріалом та посиланням на оригінал. Додайте котів до підказки, і слід приведе до французького шовкового віяла.
Ви створите Collection Detective, багатомовний музейний чат-бот, який шукає в The Met Collection API та пише коротку етикетку для знайденого твору мистецтва. Почніть з картини нижче. Зрештою, ви зможете слідувати будь-якій підказці в Quickchat AI та перевіряти відповідь за власним каталогом музею.
Quickchat AI зберегла назву «Sunflowers» і переклала матеріал як «óleo sobre lienzo». Порівняйте відповідь з музейною етикеткою у Google Arts & Culture. Метрополітен-музей, Rogers Fund, 1949. Відкрити музейний запис.
1. Дайте своєму музейному чат-боту першу підказку
Відвідувач надає тему та мову. Детектив робить два пошуки. Перший знаходить потенційні ідентифікатори об’єктів. Другий відкриває один ідентифікатор і повертає художника, назву, дату, техніку та посилання на джерело. Лише тоді детектив пише етикетку.
- Увійдіть або створіть обліковий запис Quickchat AI. Використовуйте порожнього агента або виберіть Add new AI Agent → Set up manually. Назвіть його Collection Detective. Вам знадобиться достатньо кредитів для кількох тестових розмов. Пошуки в музеї працюють без облікового запису The Met або ключа 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 додайте англійську та іспанську. Ми також додали японську для перевірки другої мови. Перша мова є резервною для неоднозначних повідомлень. Як працюють підказки мови
Ім’я та інструкції агента знаходяться в розділі 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. Як шукати в The Met Collection API?
Дайте першій дії один вхідний параметр — тему. Зробіть пошук достатньо малим, щоб відвідувач міг простежити шлях. Три кандидати дозволяють відкрити першу роботу і мати ще одну для дослідження.
- У Actions & MCPs виберіть Add Action → API Action → Create manually. Встановіть API Action Name на
search_met_collection, а When to run на AI decides. Покроковий посібник з дій API показує той самий редактор із простішим запитом. - У розділі 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, першого ідентифікатора в цій відповіді. Друга дія шукає його безпосередньо. The Met використовує v1.1 для пошуку та v1 для окремих об’єктів. Якщо старіший приклад пошуку повертає HTTP 410, змініть маршрут пошуку та залиште маршрут об’єкта на v1. Довідник The Met Collection API
- Створіть ще один 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, Вінсент ван Гог, 1887, та óleo sobre lienzo. Перейдіть за посиланням на музей у відповіді. На сторінці також вказано 49.41 як номер об’єкта. Це інвентарний номер музею. Використовуйте 436524 в API. Рік 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. Прочитайте каталожний запис «Аукціоніста».
Два слова несуть атрибуцію. «Follower of» належить до імені художника обома мовами. The Met, Bequest of Benjamin Altman, 1913.
Перевірте зображення. Попросіть показати об’єкт 480725, другий збіг із соняшниками. Картина Еміля Нольде Large Sunflowers датована 1928 роком і написана на панелі. У її записі є isPublicDomain: false та порожні URL-адреси зображень. Надайте відвідувачу посилання на каталог та матеріал. Цей приклад пояснює, чому лише hasImages=true не може вирішити, яке зображення показувати. Прочитайте запис Нольде.
Музей може ділитися деталями каталогу, навіть якщо API не надає фотографії, яку можна повторно використати. Політика зображень Open Access The Met.
Перевірте порожній пошук. Запитайте точний термін 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.
Чи може музейний чат-бот відповідати іспанською чи іншою мовою?
Так. Запитуйте мовою відвідувача, шукайте за коротким англійським каталожним терміном і перекладайте пояснення. Зберігайте оригінальну назву, імена та кваліфікатори атрибуції, щоб відвідувач міг перевірити музейний запис.
Чи можу я повторно використовувати кожне зображення, отримане в результаті пошуку в The Met?
Перевірте запис окремого об’єкта. Метрополітен-музей надає свої зображення Open Access за ліцензією CC0. Цей чат-бот пропонує зображення лише тоді, коли isPublicDomain є істинним і присутня URL-адреса основного зображення. В іншому випадку він посилається на сторінку музею.
Чи може чат-бот повідомити мені, чи виставляється робота сьогодні?
Для відвідування відкрийте поточну сторінку музейного об’єкта та перевірте інформацію про його експозицію. Пошук у колекції знаходить каталогізовані роботи, включаючи роботи, що зберігаються в сховищі.
Чи може чат-бот пояснити задум художника?
Запис об’єкта надає вам каталожні факти, такі як техніка та дата. Щоб пояснити задуми художника або символ у роботі, використовуйте додаткове джерело, наприклад, есе куратора про цей конкретний твір мистецтва.