Vytvorte si múzejného chatbota na hľadanie slnečníc v The Met

Piotr Grudzień
Publikované 7 min čítania
Španielsky popisok od Collection Detective v Quickchat AI vedľa Van Goghových Sunflowers v prehliadači Google Arts & Culture

Dve odrezané slnečnice ležia na podklade modrej farby. Požiadajte o ne v španielčine a môžete získať popis pre Sunflowers Vincenta van Gogha, doplnený o rok, materiál a odkaz na originál. Pridajte mačky k indícii a stopa vedie k francúzskemu hodvábnemu vejáru.

Vytvoríte Collection Detective, viacjazyčného múzejného chatbota, ktorý prehľadáva Met Collection API a píše krátky popis z nájdeného umeleckého diela. Začnite s obrazom nižšie. Na konci budete môcť sledovať ktorúkoľvek indíciu v Quickchat AI a skontrolovať odpoveď s vlastným katalógom múzea.

Španielska odpoveď o slnečniciach v Quickchat AI a Van Goghove Sunflowers v galérii Metropolitného múzea umenia v Google Arts & Culture Quickchat AI ponechal názov Sunflowers a preložil médium na „óleo sobre lienzo“. Porovnajte odpoveď s popiskou múzea v Google Arts & Culture. Metropolitné múzeum umenia, Rogers Fund, 1949. Otvorte záznam múzea.

1. Dajte svojmu múzejnému chatbotovi prvú stopu

Návštevník zadá tému a jazyk. Detektív vykoná dve vyhľadávania. Prvé nájde kandidátske ID objektov. Druhé otvorí jedno ID a vráti umelca, názov, dátum, médium a odkaz na zdroj. Až potom detektív napíše popisok.

  1. Prihláste sa alebo si vytvorte účet Quickchat AI. Použite prázdneho agenta alebo vyberte Add new AI Agent → Set up manually. Pomenujte ho Collection Detective. Budete potrebovať dostatok kreditov na niekoľko testovacích konverzácií. Vyhľadávania v múzeu fungujú bez účtu v The Met alebo kľúča API.
  2. Otvorte Identity → AI Persona → Main Prompt. Prilepte nižšie uvedené pokyny a potom panel zatvorte. Identita automaticky uloží vaše úpravy. Hovorí detektívovi, ako vybrať záznam a ktoré detaily si má ponechať, keď sa zmení jazyk.
Skopírujte Main Prompt pre 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. V Identity → Languages pridajte angličtinu a španielčinu. Pridali sme aj japončinu pre kontrolu druhého jazyka. Prvý jazyk je záložný pre nejednoznačné správy. Ako fungujú jazykové nápovedy

Meno Collection Detective a Main Prompt v nastaveniach identity Quickchat AI. Meno a pokyny agenta sa nachádzajú v časti Identity. Vyhľadávania v katalógu patria do Actions & MCPs v ďalšom kroku.

  1. Túto prvú správu od návštevníka si ponechajte pre AI Preview, keď budú povolené obe akcie. Návštevník žiada nájsť slnečnice a vysvetliť prvé dielo v španielčine.

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

Na jazyku vyhľadávania záleží. Dňa 19. novembra 2026 múzeum vrátilo nula zhôd pre girasoles a 153 pre sunflowers s rovnakými filtrami. Nechajte návštevníka pýtať sa v španielčine, vyhľadajte krátky anglický katalógový výraz a povedzte mu, ktoré slovo ste použili.

2. Ako sa vyhľadáva v The Met Collection API?

Prvej akcii dajte jeden vstup, tému. Vyhľadávanie udržujte dostatočne malé, aby návštevník mohol sledovať stopu. Traja kandidáti vám umožnia otvoriť prvé dielo a stále mať ďalšie na preskúmanie.

  1. V Actions & MCPs vyberte Add Action → API Action → Create manually. Nastavte API Action Name na search_met_collection a When to run na AI decides. Návod na API Actions ukazuje rovnaký editor s jednoduchšou požiadavkou.
  2. Pod What to ask the user first pridajte povinný parameter typu Text s názvom theme. Do jeho popisu zadajte „A short English catalogue search phrase, such as sunflowers or cats and sunflowers.“
  3. V API Endpoint vyberte GET a zadajte https://collectionapi.metmuseum.org/public/collection/v1.1/search. V Query Params vytvorte tieto štyri riadky. Pre prvú hodnotu použite Add AI Data → Parameters, aby sa téma návštevníka vložila do požiadavky.
Kľúč dotazuHodnota na zadanie
qVložte parameter theme.
hasImagestrue
limit3
offset0

Referencia Search (v1.1) Metropolitného múzea umenia a štyri parametre dotazu v editore akcií Quickchat AI Priraďte štyri riadky v Quickchat AI k parametrom vyhľadávania Metropolitného múzea umenia. Iba q preberá tému návštevníka. Ostatné tri hodnoty zostávajú pevné. Prečítajte si referenciu Search (v1.1) Metropolitného múzea umenia.

  1. Pod Headers zadajte Accept s hodnotou application/json. Ponechajte Body prázdne. Prilepte nasledujúce do API Action Description, zvoľte Save changes a skontrolujte, či je prepínač akcie zapnutý.
Skopírujte popis akcie vyhľadávania
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.

Otvorte si vyhľadávanie slnečníc vo vašom prehliadači. Tu je celá odpoveď z nášho vyhľadávania. Počet zahŕňa každú zhodu. Zoznam obsahuje iba tri ID, ktoré sme požadovali, a ich poradie sa môže meniť so zmenami v katalógu.

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

3. Premeňte ID objektu na španielsky múzejný popisok

Začnite s 436524, prvým ID v tejto odpovedi. Druhá akcia ho vyhľadá priamo. The Met používa v1.1 pre vyhľadávanie a v1 pre jednotlivé objekty. Ak starší príklad vyhľadávania vráti HTTP 410, zmeňte cestu vyhľadávania a cestu objektu ponechajte na v1. Referenčná príručka The Met Collection API

  1. Vytvorte ďalšiu akciu API Action. Nastavte API Action Name na get_met_object a When to run na AI decides. Pod What to ask the user first pridajte povinný parameter typu Number s názvom object_id. Popíšte ho ako „The integer Met object ID from a search result or the visitor.“
  2. V API Endpoint vyberte GET. Zadajte https://collectionapi.metmuseum.org/public/collection/v1/objects/, ponechajte posledné lomítko na mieste a použite Add AI Data → Parameters na pripojenie čipu object_id. S naším prvým ID adresa končí na /objects/436524.
  3. Ponechajte Query Params a Body prázdne. V Headers použite Accept s application/json. Prilepte popis nižšie do API Action Description, zvoľte Save changes a skontrolujte, či je prepínač akcie zapnutý.
Skopírujte popis akcie 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.

Vyhľadávanie objektu v Quickchat AI s ID objektu vloženým na konci URL Met V akcii vyhľadávania sa slovo návštevníka nachádza v riadku dotazu. Tu sa číslo stáva súčasťou samotnej adresy.

Otvorte AI Preview a pošlite prvú stopu. Hľadajte pôvodný názov Sunflowers, Vincent van Gogh, 1887 a óleo sobre lienzo. Sledujte odkaz na múzeum v odpovedi. Stránka tiež uvádza 49.41 ako svoje Object Number. To je akvizičné číslo múzea. V API použite 436524. Rok 1949 v texte o pôvode diela (credit line) patrí akvizícii Rogers Fund. Samotný obraz pochádza z roku 1887. Prečítajte si údaje o objekte

Prehliadač Google Arts & Culture pre Sunflowers a detail podpisu „Vincent 87“ vľavo dole Otvorte obraz s lupou a nájdite „Vincent 87“ v ľavom dolnom rohu. Na stránke umeleckého diela prejdite na Details a porovnajte podpis s rokom pod Date Created. Preskúmajte Sunflowers Metropolitného múzea umenia na Google Arts & Culture.

Nastavte rovnaké dve akcie z pripojeného AI asistenta

Ak spravujete Quickchat AI prostredníctvom ChatGPT alebo Claude, môžete tiež použiť dva vyššie uvedené recepty s touto požiadavkou na nastavenie. Skontrolujte vygenerované polia a potom sami spustite prvú nápovedu. Pokyny na pripojenie úč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. Ako skontrolovať preložený popisok umeleckého diela?

V Inbox otvorte konverzáciu a rozbaľte 2 actions called pod odpoveďou. Pre detaily požiadavky prejdite na Actions & MCPs → Custom Actions a pre každú akciu vyberte View logs. Nájdite 436524 v odpovedi vyhľadávania a na konci ďalšej požiadavky. Zhoda týchto čísel vám umožní vystopovať španielsky popisok späť k jednému objektu, aj keď iné dielo má rovnaký názov.

Výsledok vyhľadávania slnečníc a následné vyhľadávanie objektu 436524 Sledujte prvé ID z výsledku vyhľadávania do vyhľadávania objektu. Toto prepojenie spája odpoveď s obrazom.

Vyskúšajte tieto indície v nových konverzáciách. Ak ich chcete zopakovať po úprave výzvy, otvorte Testing → Create Dataset, pomenujte súbor údajov a zadajte otázky. Vyberte Run Tests → Start Run, potom View na dokončenom výsledku, aby ste otvorili jeho konverzáciu v Inbox.

Skontrolujte atribúciu. Požiadajte o španielsky popisok pre objekt 437406. Jeho záznam uvádza Rembrandt ako meno a Follower of ako predponu. Naša prvá odpoveď vysvetlila atribúciu v španielčine, ale riadok s umelcom ponechala v angličtine. Zmenili sme jeden pokyn, aby sa preložil kvalifikátor aj médium. Ďalšia odpoveď uviedla un seguidor de Rembrandt a zachovala neistotu v dátume, probablemente hacia 1658–62. Prečítajte si katalógový záznam diela The Auctioneer.

Dielo The Auctioneer s katalógovou atribúciou Rembrandtovmu nasledovníkovi a zodpovedajúce španielske znenie Atribúciu nesú dve slová. „Follower of“ patrí k menu umelca v oboch jazykoch. The Met, Bequest of Benjamin Altman, 1913.

Skontrolujte obrázok. Požiadajte o zobrazenie objektu 480725, druhého nálezu slnečnice. Dielo Emila Noldeho Large Sunflowers je datované do roku 1928 a namaľované na drevenej doske. Jeho záznam obsahuje isPublicDomain: false a prázdne URL adresy obrázkov. Poskytnite návštevníkovi odkaz na katalóg a materiál. Tento príklad ukazuje, prečo hasImages=true samotné nemôže rozhodnúť, ktorý obrázok sa má zobraziť. Prečítajte si záznam o Noldem.

Textová odpoveď Quickchat AI pre Emila Noldeho vedľa príznaku public domain a prázdnych polí pre obrázky v zázname The Met Múzeum môže zdieľať podrobnosti katalógu, aj keď API neposkytuje opakovane použiteľnú fotografiu. Zásady The Met pre obrázky s voľným prístupom (Open Access).

Skontrolujte prázdne vyhľadávanie. Požiadajte o presný výraz zzzxxyycollectiontest. API vrátilo {"total":0,"objectIDs":null}. Detektív môže požiadať o širšiu stopu. Neúspešné vyhľadávanie potrebuje inú odpoveď. Keď sme simulovali HTTP 503, detektív požiadal návštevníka, aby to skúsil znova neskôr a nevykonal žiadnu požiadavku na objekt.

5. Sledujte slnečnice až na hodvábny vejár

Ponechajte kvety a pridajte zviera. Dajte Collection Detective druhú stopu a spýtajte sa, na akom povrchu každý umelec pracoval. Túto správu môžete použiť tak, ako je napísaná.

Busca «cats and sunflowers» y compara el soporte de la primera obra con el de Sunflowers (436524).

Vyskúšajte druhé vyhľadávanie. Naše prvé dve ID boli 705155 a 436524. Metropolitné múzeum umenia katalogizuje prvé dielo ako kresbu. Na Wikimedia Commons vyberte Open in Media Viewer pod fotografiou múzea. Sledujte biele mačky pozdĺž líšt a hľadajte záblesk medzi slnečnicami. Prezrite si vejár na Wikimedia Commons.

Guérardov vejár s bielymi mačkami a slnečnicami na Wikimedia Commons vedľa detailu Van Goghovho obrazu Henri Charles Guérard, Fan Design with Cats and Sunflowers, ca. 1885–90. The Met, Gift of Robert Tuggle and Paul Jeromack, 2015. Preskúmajte vejár v The Met.

Van Gogh pracoval na plátne. Guérard pracoval na vzorovanom hodvábe. Lesk medzi slnečnicami má materiálne vysvetlenie. Múzeum uvádza popri tuši a gvaši aj plátkové zlato. Dátum zostáva približný, ca. 1885–90. Ak chcete vytvoriť vlastný lov s dvoma zastávkami, vyberte detail z prvého diela, pridajte ho k ďalšej stope a požiadajte detektíva o jeden rozdiel, ktorý môžete overiť na oboch stránkach objektov.

Často kladené otázky o múzejnom chatbote

Potrebujem API kľúč na prehľadávanie zbierky Metropolitného múzea umenia?

Metropolitné múzeum umenia poskytuje verejné vyhľadávacie a objektové koncové body bez registrácie alebo API kľúča. Obidve požiadavky môžete otvoriť v prehliadači. Quickchat AI používa kredity účtu pre konverzáciu chatbota.

Ktorý koncový bod Met API vráti umelecké dielo a jeho obrázok?

Použite /public/collection/v1.1/search na získanie ID kandidátskych objektov. Jedno ID posuňte do /public/collection/v1/objects/{id} pre názov, umelca, dátum, médium, odkaz na múzeum a všetky dostupné adresy URL obrázkov s voľným prístupom (Open Access).

Môže múzejný chatbot odpovedať po španielsky alebo v inom jazyku?

Áno. Opýtajte sa v jazyku návštevníka, vyhľadajte pomocou krátkeho anglického katalógového termínu a preložte vysvetlenie. Ponechajte pôvodný názov, mená a kvalifikátory atribúcie, aby si návštevník mohol skontrolovať záznam múzea.

Môžem opätovne použiť každý obrázok vrátený vyhľadávaním v Metropolitnom múzeu umenia?

Skontrolujte záznam jednotlivého objektu. Metropolitné múzeum umenia sprístupňuje svoje Open Access obrázky pod CC0. Tento chatbot ponúka obrázok iba vtedy, keď je isPublicDomain pravdivé a je prítomná primárna URL adresa obrázka. V opačnom prípade odkazuje na stránku múzea.

Môže mi chatbot povedať, či je dielo dnes vystavené?

Pri návšteve si otvorte aktuálnu stránku objektu múzea a skontrolujte informácie o jeho vystavení. Vyhľadávanie v zbierke nájde katalogizované diela vrátane diel v depozitári.

Môže chatbot vysvetliť, čo zamýšľal umelec?

Záznam objektu vám poskytne katalógové fakty, ako je médium a dátum. Na vysvetlenie zámerov umelca alebo symbolu v diele použite dodatočný zdroj, napríklad esej kurátora o konkrétnom umeleckom diele.

Quickchat AI Quickchat AI Ask Quickchat AI a question