Два отрязани слънчогледа лежат върху легло от синя боя. Попитайте за тях на испански и можете да получите етикет за стена за Sunflowers на Винсент ван Гог, пълен с годината, материала и връзка към оригинала. Добавете котки към уликата и следата води до френско копринено ветрило.
Ще изградите Collection Detective – многоезичен музеен чатбот, който търси в 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. Ще ви трябват достатъчно кредити за няколко тестови разговора. Музейните справки работят без акаунт в „Метрополитън“ или 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. Как се търси в 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. Превърнете ID на обект в испански музеен етикет
Започнете с 436524, първия идентификатор в този отговор. Второто действие го търси директно. „Метрополитън“ използва v1.1 за търсене и v1 за отделни обекти. Ако по-стар пример за търсене върне HTTP 410, променете маршрута за търсене и оставете маршрута на обекта на v1. Справочник за 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 в реда за придобиване се отнася за постъпването във фонда Rogers. Самата картина датира от 1887 г. Прочетете данните за обекта
Отворете картината с лупата и намерете „Vincent 87“ в долния ляв ъгъл. На страницата на произведението превъртете до Details и сравнете подписа с годината под Date Created. Разгледайте „Sunflowers“ на „Метрополитън“ в Google Arts & Culture.
Настройте същите две действия от свързан AI асистент
Ако управлявате 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 в отговора от търсенето и в края на следващата заявка. Съвпадението на тези числа ви позволява да проследите испанския етикет обратно до един обект, дори ако друго произведение има същото заглавие.
Следвайте първото ID от резултата от търсенето до търсенето на обекта. Това предаване е това, което свързва отговора с картината.
Изпробвайте тези улики в нови разговори. За да ги повторите след редактиране на подканата, отворете 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) на „Метрополитън“.
Проверете празно търсене. Поискайте точния термин 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 използва кредити по сметката за разговора с чатбота.
Коя крайна точка на API на „Метрополитън“ връща произведение на изкуството и неговото изображение?
Използвайте /public/collection/v1.1/search, за да получите идентификатори на обекти кандидати. Предайте един идентификатор на /public/collection/v1/objects/{id} за заглавие, художник, дата, техника, връзка към музея и всички налични URL адреси на изображения с отворен достъп (Open Access).
Може ли музейният чатбот да отговаря на испански или друг език?
Да. Задайте въпрос на езика на посетителя, търсете с кратък английски каталожен термин и преведете обяснението. Запазете оригиналното заглавие, имена и квалификатори за приписване, за да може посетителят да провери музейния запис.
Мога ли да използвам повторно всяко изображение, върнато от търсене в „Метрополитън“?
Проверете записа на отделния обект. „Метрополитън“ предоставя своите изображения с отворен достъп (Open Access) под CC0. Този чатбот предлага изображение само когато isPublicDomain е true и е наличен URL адрес на основно изображение. В противен случай той препраща към страницата на музея.
Може ли чатботът да ми каже дали дадена творба е изложена днес?
За посещение отворете текущата страница на музейния обект и проверете информацията за излагането му. Търсенето в колекцията намира каталогизирани произведения, включително произведения в хранилище.
Може ли чатботът да обясни какво е възнамерявал художникът?
Записът на обекта ви дава каталожни факти като техника и дата. За да обясните намеренията на художника или символ в произведението, използвайте допълнителен източник, като есе на куратор за конкретното произведение на изкуството.