Dvě uříznuté slunečnice leží na lůžku modré barvy. Zeptejte se na ně ve španělštině a můžete získat štítek na zeď pro Sunflowers Vincenta van Gogha, doplněný rokem, materiálem a odkazem na originál. Přidejte kočky k nápovědě a stopa vede k francouzskému hedvábnému vějíři.
Vytvoříte Collection Detective, vícejazyčného muzejního chatbota, který prohledává API sbírek Metropolitního muzea a k nalezenému uměleckému dílu napíše krátkou popisku. Začněte s níže uvedeným obrazem. Na konci budete schopni sledovat jakoukoli nápovědu v Quickchat AI a zkontrolovat odpověď v katalogu muzea.
Quickchat AI ponechal název Sunflowers a techniku přeložil jako „óleo sobre lienzo“. Porovnejte odpověď s popiskem muzea v Google Arts & Culture. Metropolitní muzeum, Rogers Fund, 1949. Otevřít záznam muzea.
1. Dejte svému muzejnímu chatbotovi první nápovědu
Návštěvník zadá téma a jazyk. Detektiv provede dvě vyhledávání. První najde možná ID objektů. Druhé otevře jedno ID a vrátí umělce, název, datum, médium a odkaz na zdroj. Teprve poté detektiv napíše popisku.
- Přihlaste se nebo si vytvořte účet Quickchat AI. Použijte prázdného agenta nebo vyberte Add new AI Agent → Set up manually. Pojmenujte ho Collection Detective. Budete potřebovat dostatek kreditů na několik testovacích konverzací. Vyhledávání v muzeu funguje bez účtu v Metropolitním muzeu nebo klíče API.
- Otevřete Identity → AI Persona → Main Prompt. Vložte níže uvedené pokyny a poté panel zavřete. Identity vaše úpravy automaticky uloží. Pokyny říkají detektivovi, jak vybrat záznam a které detaily si ponechat při změně jazyka.
Zkopírujte Main Prompt pro 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.
- V Identity → Languages přidejte angličtinu a španělštinu. Přidali jsme také japonštinu pro kontrolu druhého jazyka. První jazyk je záložní pro nejednoznačné zprávy. Jak fungují jazykové nápovědy
Jméno a pokyny agenta jsou v Identity. Vyhledávání v katalogu patří do Actions & MCPs v dalším kroku.
- Ponechte si tuto první zprávu od návštěvníka pro AI Preview, jakmile budou obě akce povoleny. Návštěvník žádá o nalezení slunečnic a vysvětlení prvního díla ve španělštině.
Busca girasoles en la colección del Met y explícame la primera obra en español.
Na jazyce vyhledávání záleží. Dne 19. listopadu 2026 vrátilo muzeum nula shod pro girasoles a 153 pro sunflowers se stejnými filtry. Nechte návštěvníka zeptat se španělsky, vyhledejte krátký anglický katalogový termín a sdělte mu, jaké slovo jste použili.
2. Jak prohledávat API sbírek Metropolitního muzea?
První akci dejte jeden vstup, téma. Udržujte vyhledávání dostatečně malé, aby návštěvník mohl sledovat stopu. Tři možná díla vám umožní otevřít to první a stále mít další k prozkoumání.
- V Actions & MCPs zvolte Add Action → API Action → Create manually. Nastavte API Action Name na
search_met_collectiona When to run na AI decides. Návod k API akcím ukazuje stejný editor s jednodušším požadavkem. - Pod What to ask the user first přidejte povinný Text parametr s názvem
theme. Do jeho popisu zadejte „A short English catalogue search phrase, such as sunflowers or cats and sunflowers.“ - V API Endpoint zvolte GET a zadejte
https://collectionapi.metmuseum.org/public/collection/v1.1/search. V Query Params vytvořte tyto čtyři řádky. Použijte Add AI Data → Parameters pro první hodnotu, aby se téma návštěvníka vložilo do požadavku.
| Klíč dotazu | Hodnota k zadání |
|---|---|
q | Vložte čip parametru theme. |
hasImages | true |
limit | 3 |
offset | 0 |

q přebírá téma návštěvníka. Ostatní tři hodnoty zůstávají pevné. Přečtěte si odkaz na Search (v1.1) Metropolitního muzea.
- Pod Headers zadejte
Accepts hodnotouapplication/json. Ponechte Body prázdné. Vložte následující do API Action Description, zvolte Save changes a zkontrolujte, zda je přepínač akce zapnutý.
Zkopírujte popis akce vyhledávání
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.
Otevřete vyhledávání slunečnic ve svém prohlížeči. Zde je celá odpověď z našeho vyhledávání. Počet zahrnuje každou shodu. Seznam obsahuje pouze tři ID, která jsme požadovali, a jejich pořadí se může měnit se změnami v katalogu.
{"total":153,"objectIDs":[436524,480725,484935]}
3. Jak převést ID objektu na španělskou muzejní popisku
Začněte s 436524, prvním ID v této odpovědi. Druhá akce ho vyhledá přímo. Metropolitní muzeum používá v1.1 pro vyhledávání a v1 pro jednotlivé objekty. Pokud starší příklad vyhledávání vrátí HTTP 410, změňte cestu vyhledávání a cestu objektu ponechte na v1. Reference k API sbírek Metropolitního muzea
- Vytvořte další API Action. Nastavte API Action Name na
get_met_objecta When to run na AI decides. Pod What to ask the user first přidejte povinný Number s názvemobject_id. Popište ho jako „The integer Met object ID from a search result or the visitor.“ - V API Endpoint zvolte GET. Zadejte
https://collectionapi.metmuseum.org/public/collection/v1/objects/, ponechte koncovou lomítko na místě a použijte Add AI Data → Parameters k připojení čipuobject_id. S naším prvním ID adresa končí na/objects/436524. - Ponechte Query Params a Body prázdné. V Headers použijte
Acceptsapplication/json. Vložte popis níže do API Action Description, zvolte Save changes a zkontrolujte, zda je přepínač akce zapnutý.
Zkopírujte popis akce objektu
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.
V akci vyhledávání se slovo návštěvníka objeví v řádku dotazu. Zde se číslo stává součástí samotné adresy.
Otevřete AI Preview a odešlete první nápovědu. Hledejte původní název Sunflowers, Vincent van Gogh, 1887 a óleo sobre lienzo. Sledujte odkaz na muzeum v odpovědi. Stránka také uvádí 49.41 jako číslo objektu. To je inventární číslo muzea. V API použijte 436524. Rok 1949 v popisce patří akvizici z fondu Rogers Fund. Samotný obraz pochází z roku 1887. Přečtěte si data objektu
Otevřete obraz lupou a najděte „Vincent 87“ v levém dolním rohu. Na stránce díla přejděte na Details a porovnejte podpis s rokem pod Date Created. Prozkoumejte Sunflowers z Metropolitního muzea na Google Arts & Culture.
Nastavte stejné dvě akce z připojeného AI asistenta
Pokud spravujete Quickchat AI prostřednictvím ChatGPT nebo Claude, můžete také použít dva výše uvedené recepty s tímto požadavkem na nastavení. Zkontrolujte vygenerovaná pole a poté sami spusťte první nápovědu. Pokyny pro připojení účtu
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. Jak zkontrolovat přeloženou popisku uměleckého díla?
V Inbox otevřete konverzaci a rozbalte 2 actions called pod odpovědí. Pro detaily požadavku přejděte na Actions & MCPs → Custom Actions a pro každou akci vyberte View logs. Najděte 436524 v odpovědi vyhledávání a na konci dalšího požadavku. Shoda těchto čísel vám umožní vysledovat španělskou popisku zpět k jednomu objektu, i když jiné dílo má stejný název.
Sledujte první ID z výsledku vyhledávání do vyhledávání objektu. Toto předání je to, co spojuje odpověď s obrazem.
Vyzkoušejte tyto nápovědy v nových konverzacích. Chcete-li je zopakovat po úpravě výzvy, otevřete Testing → Create Dataset, pojmenujte datovou sadu a zadejte otázky. Vyberte Run Tests → Start Run, poté View u dokončeného výsledku, čímž otevřete jeho konverzaci v Inbox.
Zkontrolujte atribuci. Požádejte o španělský popisek pro objekt 437406. Jeho záznam uvádí Rembrandt jako jméno a Follower of jako prefix. Naše první odpověď vysvětlila atribuci ve španělštině, ale řádek s umělcem ponechala v angličtině. Změnili jsme jednu instrukci, abychom přeložili kvalifikátor i médium. Další odpověď uvedla un seguidor de Rembrandt a ponechala nejistotu v datu, probablemente hacia 1658–62. Přečtěte si katalogový záznam dražebníka.
Atribuci nesou dvě slova. „Follower of“ patří k jménu umělce v obou jazycích. The Met, Bequest of Benjamin Altman, 1913.
Zkontrolujte obrázek. Požádejte o zobrazení objektu 480725, druhé shody se slunečnicí. Emil Nolde, Large Sunflowers, je datován rokem 1928 a namalován na desce. Jeho záznam obsahuje isPublicDomain: false a prázdné URL adresy obrázků. Poskytněte návštěvníkovi odkaz na katalog a materiál. Tento příklad ukazuje, proč samotné hasImages=true nemůže rozhodnout, který obrázek se má zobrazit. Přečtěte si záznam o Noldem.
Muzeum může sdílet podrobnosti z katalogu, i když API neposkytuje žádnou znovu použitelnou fotografii. Zásady Metropolitního muzea pro obrázky pod licencí Open Access.
Zkontrolujte prázdné vyhledávání. Zeptejte se na přesný termín zzzxxyycollectiontest. API vrátilo {"total":0,"objectIDs":null}. Detektiv může požádat o obecnější nápovědu. Neúspěšné vyhledávání vyžaduje jinou odpověď. Když jsme simulovali HTTP 503, detektiv požádal návštěvníka, aby to zkusil znovu později, a neodeslal žádný požadavek na objekt.
5. Sledujte slunečnice až na hedvábný vějíř
Ponechte květiny a přidejte zvíře. Dejte Collection Detective druhou nápovědu a zeptejte se, na jaký podklad každý umělec pracoval. Tuto zprávu můžete použít tak, jak je napsána.
Busca «cats and sunflowers» y compara el soporte de la primera obra con el de Sunflowers (436524).
Vyzkoušejte druhé vyhledávání. Naše první dvě ID byla 705155 a 436524. Metropolitní muzeum katalogizuje první dílo jako kresbu. Na Wikimedia Commons zvolte Open in Media Viewer pod fotografií muzea. Sledujte bílé kočky podél žeber a hledejte záblesk mezi slunečnicemi. Prohlédněte si vějíř na Wikimedia Commons.
Henri Charles Guérard, Fan Design with Cats and Sunflowers, ca. 1885–90. Metropolitní muzeum, Gift of Robert Tuggle and Paul Jeromack, 2015. Prozkoumejte vějíř v Metropolitním muzeu.
Van Gogh pracoval na plátně. Guérard pracoval na vzorovaném hedvábí. Třpyt mezi slunečnicemi má materiální vysvětlení. Muzeum uvádí plátkové zlato vedle inkoustu a kvaše. Datum zůstává přibližné, ca. 1885–90. Chcete-li si vytvořit vlastní pátrání o dvou krocích, vyberte detail z prvního díla, přidejte jej k další nápovědě a zeptejte se detektiva na jeden rozdíl, který můžete ověřit na obou stránkách objektů.
Často kladené otázky k muzejnímu chatbotu
Potřebuji k prohledávání sbírky Metropolitního muzea klíč API?
Metropolitní muzeum umění poskytuje veřejné vyhledávací a objektové koncové body bez registrace nebo API klíče. Oba požadavky můžete otevřít v prohlížeči. Quickchat AI používá kredit z účtu pro konverzaci s chatbotem.
Který koncový bod API Metropolitního muzea vrací umělecké dílo a jeho vyobrazení?
Pomocí /public/collection/v1.1/search získáte ID možných objektů. Jedno ID pak předejte do /public/collection/v1/objects/{id} a získáte název, umělce, datum, médium, odkaz na muzeum a všechny dostupné adresy URL obrázků pod licencí Open Access.
Může muzejní chatbot odpovídat španělsky nebo jiným jazykem?
Ano. Zeptejte se v jazyce návštěvníka, vyhledejte pomocí krátkého anglického katalogového termínu a přeložte vysvětlení. Zachovejte původní název, jména a kvalifikátory atribuce, aby si návštěvník mohl zkontrolovat muzejní záznam.
Mohu znovu použít každý obrázek vrácený vyhledáváním v Metropolitním muzeu?
Zkontrolujte záznam jednotlivého objektu. Metropolitní muzeum zpřístupňuje své obrázky Open Access pod licencí CC0. Tento chatbot nabízí obrázek pouze tehdy, když je isPublicDomain pravdivé a je přítomna primární URL adresa obrázku. Jinak odkazuje na stránku muzea.
Může mi chatbot říct, zda je dílo dnes vystaveno?
Pokud plánujete návštěvu, otevřete si aktuální stránku muzejního objektu a zkontrolujte informace o jeho vystavení. Vyhledávání ve sbírce najde katalogizovaná díla, včetně děl v depozitáři.
Může chatbot vysvětlit, co umělec zamýšlel?
Záznam objektu vám poskytne katalogové údaje, jako je médium a datum. Pro vysvětlení záměrů umělce nebo symbolu v díle použijte další zdroj, například esej kurátora o daném uměleckém díle.