Создайте музейный чат-бот для «Охоты за подсолнухами» в Метрополитен-музее

Piotr Grudzień
Опубликовано Время чтения: 7 мин
Испанская этикетка от Collection Detective в Quickchat AI рядом с картиной Ван Гога Sunflowers в окне просмотра Google Arts & Culture

Два срезанных подсолнуха лежат на синем фоне. Спросите о них на испанском, и вы получите этикетку для «Подсолнухов» (Sunflowers) Винсента ван Гога, где будут указаны год, материал и ссылка на оригинал. Добавьте в подсказку кошек, и след приведёт к французскому шёлковому вееру.

Вы создадите Collection Detective — многоязычный музейный чат-бот, который ищет информацию в API коллекции Метрополитен-музея и составляет краткую этикетку для найденного произведения искусства. Начните с картины ниже. К концу руководства вы сможете проследить любую из подсказок в Quickchat AI и сверить ответ с каталогом самого музея.

Ответ на испанском языке о подсолнухах в Quickchat AI и картина Ван Гога Sunflowers в галерее Метрополитен-музея в Google Arts & Culture Quickchat AI сохранил название Sunflowers и перевёл технику как «óleo sobre lienzo». Сравните ответ с музейной этикеткой в Google Arts & Culture. Метрополитен-музей, Rogers Fund, 1949. Открыть запись музея.

1. Дайте музейному чат-боту первую подсказку

Посетитель задаёт тему и язык. Детектив делает два запроса. Первый находит идентификаторы объектов-кандидатов. Второй открывает один из идентификаторов и получает имя художника, название, дату, материал и ссылку на источник. Только после этого детектив составляет этикетку.

  1. Войдите в систему или создайте учётную запись Quickchat AI. Используйте пустого агента или выберите Add new AI Agent → Set up manually. Назовите его Collection Detective. Вам понадобится достаточно кредитов для нескольких тестовых диалогов. Поиск по коллекции музея работает без учётной записи в Метрополитен-музее или ключа API.
  2. Откройте 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.
  1. В Identity → Languages добавьте английский и испанский. Мы также добавили японский для проверки на втором языке. Первый язык является запасным для неоднозначных сообщений. Как работают языковые подсказки

Имя Collection Detective и Main Prompt в настройках Identity в Quickchat AI Имя и инструкции агента хранятся в разделе Identity. Поиск по каталогу настраивается в Actions & MCPs на следующем шаге.

  1. Сохраните это первое сообщение посетителя для AI Preview на тот момент, когда оба действия будут включены. Посетитель просит найти подсолнухи и объяснить первую работу на испанском языке.

Busca girasoles en la colección del Met y explícame la primera obra en español.

Язык поиска имеет значение. 19 ноября 2026 года по запросу girasoles музей вернул ноль совпадений, а по запросу sunflowers с теми же фильтрами — 153. Позвольте посетителю задать вопрос на испанском, а сами выполните поиск по короткому английскому каталожному термину и сообщите, какое слово вы использовали.

2. Как выполнять поиск по API коллекции Метрополитен-музея?

Задайте для первого действия один входной параметр — тему. Ограничьте поиск, чтобы посетитель мог проследить всю цепочку. Трёх кандидатов достаточно, чтобы открыть первое произведение и оставить ещё одно для исследования.

  1. В Actions & MCPs выберите Add Action → API Action → Create manually. Установите для API Action Name значение search_met_collection, а для When to run — AI decides. В пошаговом руководстве по действиям API показан тот же редактор с более простым запросом.
  2. В разделе What to ask the user first добавьте обязательный параметр Text с именем theme. В его описание введите «A short English catalogue search phrase, such as sunflowers or cats and sunflowers.»
  3. В API Endpoint выберите GET и введите https://collectionapi.metmuseum.org/public/collection/v1.1/search. В Query Params создайте эти четыре строки. Используйте Add AI Data → Parameters для первого значения, чтобы тема посетителя была вставлена в запрос.
Ключ запросаЗначение для ввода
qВставьте чип параметра theme.
hasImagestrue
limit3
offset0

Ссылка на Search (v1.1) из Метрополитен-музея и четыре параметра запроса в редакторе действий Quickchat AI Сопоставьте четыре строки в Quickchat AI с параметрами поиска Метрополитен-музея. Только q принимает тему посетителя. Остальные три значения остаются фиксированными. Прочитайте справочник по Search (v1.1) от Метрополитен-музея.

  1. В разделе Headers введите Accept со значением application/json. Оставьте поле Body пустым. Вставьте следующее в API Action Description, выберите Save changes и убедитесь, что переключатель Action включён.
Скопируйте описание действия поиска
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 охватывает все совпадения. Список objectIDs содержит только три запрошенных нами идентификатора, и их порядок может меняться по мере изменения каталога.

{"total":153,"objectIDs":[436524,480725,484935]}

3. Превращаем идентификатор объекта в музейную этикетку на испанском

Начните с 436524 — первого идентификатора в этом ответе. Второе действие ищет его напрямую. Метрополитен-музей использует v1.1 для поиска и v1 для отдельных объектов. Если старый пример поиска возвращает ошибку HTTP 410, измените маршрут поиска, оставив для маршрута объекта версию v1. Справочник по API коллекции Метрополитен-музея

  1. Создайте ещё один 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.»
  2. В API Endpoint выберите GET. Введите https://collectionapi.metmuseum.org/public/collection/v1/objects/, оставьте косую черту в конце и с помощью Add AI Data → Parameters добавьте чип object_id. С нашим первым идентификатором адрес будет заканчиваться на /objects/436524.
  3. Оставьте Query Params и Body пустыми. В Headers используйте Accept с application/json. Вставьте описание ниже в API Action Description, выберите Save changes и убедитесь, что переключатель Action включён.
Скопируйте описание действия объекта
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.

Поиск объекта в Quickchat AI с идентификатором объекта, вставленным в конец URL-адреса API Метрополитен-музея В действии поиска слово посетителя помещается в строку запроса. Здесь число становится частью самого адреса.

Откройте AI Preview и отправьте первую подсказку. Найдите в ответе оригинальное название Sunflowers, Винсент ван Гог, 1887 и óleo sobre lienzo. Перейдите по ссылке на сайт музея. На странице также указан номер объекта 49.41. Это инвентарный номер музея. В API используйте 436524. 1949 год в строке принадлежности относится к приобретению по завещанию из фонда Роджерса. Сама картина датируется 1887 годом. Прочитать данные объекта

Просмотрщик Google Arts & Culture для картины Sunflowers и крупный план подписи «Vincent 87» в левом нижнем углу Откройте картину с помощью лупы и найдите «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 в ответе на поисковый запрос и в конце следующего запроса. Сопоставление этих номеров позволяет отследить испанскую этикетку до конкретного объекта, даже если у другого произведения такое же название.

Результат поиска подсолнухов и последующий поиск объекта 436524 Следуйте первому ID из результата поиска в поиск объекта. Эта передача связывает ответ с картиной.

Попробуйте эти подсказки в новых диалогах. Чтобы повторить их после редактирования запроса, откройте Testing → Create Dataset, назовите набор данных и введите вопросы. Выберите Run Tests → Start Run, затем View для завершенного результата, чтобы открыть его диалог в Inbox.

Проверьте атрибуцию. Запросите испанскую этикетку для объекта 437406. В его записи в качестве имени указан Rembrandt, а в качестве префикса — Follower of. Наш первый ответ объяснил атрибуцию на испанском, но оставил строку с именем художника на английском. Мы изменили одну инструкцию, чтобы переводился как определитель, так и материал. Следующий ответ дал un seguidor de Rembrandt и сохранил неопределённость в дате: probablemente hacia 1658–62. Прочтите каталожную запись «Аукциониста».

«Аукционист» с каталожной атрибуцией «последователь Рембрандта» и соответствующей испанской формулировкой Атрибуция состоит из двух слов. «Follower of» относится к имени художника на обоих языках. Метрополитен-музей, Bequest of Benjamin Altman, 1913.

Проверьте изображение. Попросите показать объект 480725, второе совпадение по подсолнухам. Картина Эмиля Нольде Large Sunflowers («Большие подсолнухи») датирована 1928 годом и написана на доске. В её записи isPublicDomain: false и пустые URL-адреса изображений. Предоставьте посетителю ссылку на каталог и информацию о материале. Этот пример объясняет, почему один лишь параметр hasImages=true не позволяет решить, какое изображение показывать. Прочитайте запись о Нольде.

Текстовый ответ Quickchat AI для Эмиля Нольде рядом с флагом общественного достояния и пустыми полями изображений в записи Метрополитен-музея Музей может предоставлять сведения из каталога, даже когда 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.

Веер Герара с белыми кошками и подсолнухами в 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 использует кредиты учётной записи для разговора с чат-ботом.

Какая конечная точка API Метрополитен-музея возвращает произведение искусства и его изображение?

Используйте /public/collection/v1.1/search, чтобы получить идентификаторы объектов-кандидатов. Передайте один идентификатор в /public/collection/v1/objects/{id}, чтобы получить название, имя художника, дату, материал, ссылку на сайт музея и любые доступные URL-адреса изображений с открытым доступом (Open Access).

Может ли музейный чат-бот отвечать на испанском или другом языке?

Да. Задайте вопрос на языке посетителя, выполните поиск по короткому английскому каталожному термину и переведите объяснение. Сохраните оригинальное название, имена и квалификаторы атрибуции, чтобы посетитель мог проверить музейную запись.

Можно ли повторно использовать все изображения, полученные через поиск по коллекции Метрополитен-музея?

Проверьте запись для каждого отдельного объекта. Метрополитен-музей предоставляет изображения из своей коллекции Open Access по лицензии CC0. Этот чат-бот предлагает изображение, только если для isPublicDomain установлено значение true и имеется URL-адрес основного изображения. В противном случае он даёт ссылку на страницу музея.

Может ли чат-бот сказать, выставлена ли работа в данный момент?

Для посещения откройте текущую страницу музейного объекта и проверьте информацию о его экспозиции. Поиск по коллекции находит каталогизированные работы, включая работы в хранилище.

Может ли чат-бот объяснить замысел художника?

Запись об объекте предоставляет вам каталожные факты, такие как материал и дата. Чтобы объяснить замысел художника или символ в работе, используйте дополнительный источник, например, эссе куратора об этом конкретном произведении искусства.

Quickchat AI Quickchat AI Ask Quickchat AI a question