Creează un chatbot de muzeu pentru vânătoarea florii-soarelui la The Met

Piotr Grudzień
Publicat 8 min de lectură
Eticheta în spaniolă scrisă de Collection Detective în Quickchat AI, alături de tabloul „Sunflowers” de Van Gogh, deschis în vizualizatorul Google Arts & Culture

Două flori de floarea-soarelui tăiate zac pe un pat de vopsea albastră. Cere-le în spaniolă și poți obține o etichetă de perete pentru Sunflowers de Vincent van Gogh, completă cu anul, materialul și un link către original. Adaugă pisici la indiciu și pista duce la un evantai francez de mătase.

Vei construi Collection Detective, un chatbot de muzeu multilingv care caută în API-ul Colecției The Met și scrie o scurtă etichetă din opera de artă pe care o găsește. Începe cu pictura de mai jos. Până la final, vei putea urma oricare indiciu din Quickchat AI și vei verifica răspunsul cu propriul catalog al muzeului.

Un răspuns în spaniolă despre floarea-soarelui în Quickchat AI și tabloul „Sunflowers” de Van Gogh în galeria The Met din Google Arts & Culture Quickchat AI a păstrat titlul „Sunflowers” și a tradus tehnica picturii prin „óleo sobre lienzo”. Compară răspunsul cu eticheta de muzeu din Google Arts & Culture. The Met, Rogers Fund, 1949. Deschide fișa lucrării în catalogul muzeului.

1. Dă-i chatbotului tău de muzeu primul indiciu

Vizitatorul furnizează o temă și o limbă. Detectivul face două căutări. Prima găsește ID-uri de obiecte candidate. A doua deschide un ID și aduce înapoi artistul, titlul, data, tehnica și linkul sursă. Abia apoi detectivul scrie eticheta.

  1. Conectează-te sau creează un cont Quickchat AI. Folosește un Agent gol sau selectează Add new AI Agent → Set up manually. Numește-l Collection Detective. Vei avea nevoie de suficiente credite pentru câteva conversații de test. Căutările în muzeu funcționează fără un cont Met sau o cheie API.
  2. Deschide Identity → AI Persona → Main Prompt. Lipește instrucțiunile de mai jos, apoi închide panoul. Identity salvează automat modificările. Acestea îi spun detectivului cum să aleagă o fișă și ce detalii să păstreze atunci când schimbă limbile.
Copiază Main Prompt pentru 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. În Identity → Languages, adaugă engleza și spaniola. Am adăugat și japoneza pentru o verificare a celei de-a doua limbi. Prima limbă este cea implicită pentru mesajele ambigue. Cum funcționează sugestiile de limbă

Numele Collection Detective și Main Prompt în setările de identitate Quickchat AI Numele și instrucțiunile Agentului se găsesc în Identity. Căutările în catalog se introduc în Actions & MCPs la pasul următor.

  1. Păstrați acest prim mesaj de la vizitator pentru AI Preview odată ce ambele Acțiuni sunt activate. Vizitatorul cere să găsească floarea-soarelui și să explice prima lucrare în spaniolă.

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

Limba căutării contează. Pe 19 noiembrie 2026, muzeul a returnat zero rezultate pentru girasoles și 153 pentru sunflowers cu aceleași filtre. Lasă vizitatorul să întrebe în spaniolă, caută termenul scurt din catalogul englez și spune-i ce cuvânt ai folosit.

2. Cum se caută în API-ul Colecției The Met?

Dă primei Acțiuni o singură intrare, tema. Păstrează căutarea suficient de mică pentru ca un vizitator să poată urmări traseul. Trei candidați îți permit să deschizi prima lucrare și să mai ai una de investigat.

  1. În Actions & MCPs, alege Add Action → API Action → Create manually. Setează API Action Name la search_met_collection și When to run la AI decides. Ghidul Acțiunilor API arată același editor cu o cerere mai simplă.
  2. Sub What to ask the user first, adaugă un parametru Text obligatoriu numit theme. Pentru descrierea sa, introdu „A short English catalogue search phrase, such as sunflowers or cats and sunflowers.”
  3. În API Endpoint, alege GET și introdu https://collectionapi.metmuseum.org/public/collection/v1.1/search. În Query Params, creează aceste patru rânduri. Folosește Add AI Data → Parameters pentru prima valoare, astfel încât tema vizitatorului să fie inserată în cerere.
Cheie de interogareValoare de introdus
qInserează cipul parametrului theme.
hasImagestrue
limit3
offset0

Referința Search (v1.1) de la The Met și cei patru parametri de interogare în editorul de acțiuni Quickchat AI Completează cele patru rânduri din Quickchat AI cu parametrii corespunzători din documentația de căutare a muzeului. Doar q primește tema aleasă de vizitator. Celelalte trei valori rămân fixe. Citește secțiunea Search (v1.1) din documentația The Met.

  1. Sub Headers, introdu Accept cu valoarea application/json. Lasă Body gol. Lipește următoarele în API Action Description, alege Save changes și verifică dacă comutatorul Acțiunii este pornit.
Copiază descrierea Acțiunii de căutare
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.

Deschide căutarea pentru floarea-soarelui în browser-ul tău. Iată răspunsul complet al căutării noastre. Numărul total acoperă fiecare potrivire. Lista conține doar cele trei ID-uri pe care le-am solicitat, iar ordinea lor se poate schimba pe măsură ce catalogul se modifică.

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

3. Transformă un ID de obiect într-o etichetă de muzeu în spaniolă

Începe cu 436524, primul ID din acel răspuns. A doua Acțiune îl caută direct. The Met folosește v1.1 pentru căutare și v1 pentru obiecte individuale. Dacă un exemplu de căutare mai vechi returnează HTTP 410, schimbă ruta de căutare și lasă ruta obiectului la v1. Referința API-ului Colecției The Met

  1. Creează o altă API Action. Setează API Action Name la get_met_object și When to run la AI decides. Sub What to ask the user first, adaugă un Number obligatoriu numit object_id. Descrie-l ca „The integer Met object ID from a search result or the visitor.”
  2. În API Endpoint, alege GET. Introdu https://collectionapi.metmuseum.org/public/collection/v1/objects/, lasă bara finală la locul ei și folosește Add AI Data → Parameters pentru a adăuga cipul object_id. Cu primul nostru ID, adresa se termină în /objects/436524.
  3. Lasă Query Params și Body goale. În Headers folosește Accept cu application/json. Lipește descrierea de mai jos în API Action Description, alege Save changes și verifică dacă comutatorul Acțiunii este pornit.
Copiază descrierea Acțiunii obiectului
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.

Căutarea obiectului în Quickchat AI cu ID-ul obiectului inserat la sfârșitul URL-ului Met În Acțiunea de căutare, cuvântul vizitatorului merge într-un rând de interogare. Aici, numărul devine parte a adresei în sine.

Deschide AI Preview și trimite primul indiciu. Caută titlul original Sunflowers, Vincent van Gogh, 1887 și óleo sobre lienzo. Urmează linkul muzeului din răspuns. Pagina listează și 49.41 ca număr de obiect. Acesta este numărul de inventar al muzeului. Folosește 436524 în API. Anul 1949 din linia de credit aparține achiziției Rogers Fund. Pictura în sine datează din 1887. Citește datele obiectului

Tabloul „Sunflowers” în vizualizatorul Google Arts & Culture și un prim-plan al semnăturii „Vincent 87” din colțul din stânga jos al pânzei Deschide tabloul apăsând pe lupă și caută semnătura „Vincent 87” în colțul din stânga jos. Pe pagina lucrării, derulează până la secțiunea Details și compară semnătura cu anul din câmpul Date Created. Explorează tabloul „Sunflowers” din colecția The Met pe Google Arts & Culture.

Configurează aceleași două Acțiuni de la un asistent AI conectat

Dacă gestionezi Quickchat AI prin ChatGPT sau Claude, poți folosi și cele două rețete de mai sus cu această cerere de configurare. Revizuiește câmpurile generate, apoi rulează singur primul indiciu. Instrucțiuni de conectare a contului

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. Cum se verifică eticheta tradusă a unei opere de artă?

În Inbox, deschide conversația și extinde 2 actions called sub răspuns. Pentru detaliile cererii, mergi la Actions & MCPs → Custom Actions și selectează View logs pentru fiecare Acțiune. Găsește 436524 în răspunsul căutării și la sfârșitul următoarei cereri. Potrivirea acestor numere îți permite să urmărești eticheta spaniolă înapoi la un singur obiect, chiar dacă o altă lucrare are același titlu.

Rezultatul căutării floarea-soarelui și căutarea ulterioară pentru obiectul 436524 Urmează primul ID din rezultatul căutării în căutarea obiectului. Această predare este ceea ce leagă răspunsul de pictură.

Încercați aceste indicii în conversații noi. Pentru a le repeta după editarea promptului, deschideți Testing → Create Dataset, denumiți setul de date și introduceți întrebările. Selectați Run Tests → Start Run, apoi View pe un rezultat finalizat pentru a deschide conversația sa în Inbox.

Verifică atribuirea. Solicită o etichetă în spaniolă pentru obiectul 437406. Fișa sa indică Rembrandt ca nume și Follower of ca prefix. Primul nostru răspuns a explicat atribuirea în spaniolă, dar a lăsat linia artistului în engleză. Am modificat o instrucțiune pentru a traduce calificativul, precum și tehnica. Următorul răspuns a dat un seguidor de Rembrandt și a păstrat incertitudinea în dată, probablemente hacia 1658–62. Citește intrarea din catalog pentru The Auctioneer.

„The Auctioneer” cu atribuirea sa din catalog unui discipol al lui Rembrandt și formularea corespondentă în spaniolă Două cuvinte poartă atribuirea. „Follower of” aparține numelui artistului în ambele limbi. The Met, Bequest of Benjamin Altman, 1913.

Verifică imaginea. Cere să vezi obiectul 480725, a doua potrivire cu floarea-soarelui. Large Sunflowers de Emil Nolde este datat 1928 și pictat pe panou. Fișa sa are isPublicDomain: false și URL-uri goale pentru imagini. Oferă vizitatorului linkul către catalog și materialul. Acest exemplu arată de ce hasImages=true singur nu poate decide ce imagine să afișeze. Citește fișa lui Nolde.

Răspunsul doar text al Quickchat AI pentru Emil Nolde, alături de indicatorul de domeniu public și câmpurile goale pentru imagini din fișa The Met Muzeul poate partaja detaliile catalogului chiar și atunci când API-ul nu furnizează o fotografie reutilizabilă. Politica The Met privind imaginile Open Access.

Verifică o căutare goală. Solicită termenul exact zzzxxyycollectiontest. API-ul a returnat {"total":0,"objectIDs":null}. Detectivul poate cere un indiciu mai amplu. O căutare eșuată necesită un răspuns diferit. Când am simulat un HTTP 503, detectivul a cerut vizitatorului să încerce din nou mai târziu și nu a făcut nicio cerere de obiect.

5. Urmărește floarea-soarelui pe un evantai de mătase

Păstrează florile și adaugă un animal. Oferă Collection Detective un al doilea indiciu și întreabă pe ce suprafață a lucrat fiecare artist. Poți folosi acest mesaj așa cum este scris.

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

Încearcă a doua căutare. Primele două ID-uri pe care le-am primit au fost 705155 și 436524. În catalogul The Met, prima lucrare figurează ca desen. Pe Wikimedia Commons, alege Open in Media Viewer sub fotografia muzeului. Urmărește pisicile albe de-a lungul spițelor evantaiului și caută sclipirea dintre florile de floarea-soarelui. Examinează evantaiul pe Wikimedia Commons.

Evantaiul lui Guérard, decorat cu pisici albe și flori de floarea-soarelui, pe Wikimedia Commons, alături de un detaliu din tabloul lui Van Gogh Henri Charles Guérard, Fan Design with Cats and Sunflowers, ca. 1885–90. The Met, Gift of Robert Tuggle and Paul Jeromack, 2015. Explorează evantaiul la The Met.

Van Gogh a lucrat pe pânză. Guérard a lucrat pe mătase cu model. Strălucirea dintre florile-soarelui are o explicație materială. Muzeul listează foița de aur alături de cerneală și guașă. Data rămâne aproximativă, ca. 1885–90. Pentru a-ți crea propria vânătoare în două etape, alege un detaliu din prima lucrare, adaugă-l la următorul indiciu și cere detectivului o diferență pe care o poți verifica pe ambele pagini ale obiectelor.

Întrebări frecvente despre chatbotul muzeului

Am nevoie de o cheie API pentru a căuta în colecția The Met?

The Metropolitan Museum of Art oferă puncte finale publice de căutare și de obiecte fără înregistrare sau cheie API. Puteți deschide ambele solicitări într-un browser. Quickchat AI utilizează credite de cont pentru conversația chatbotului.

Ce punct final al API-ului Met returnează o operă de artă și imaginea sa?

Utilizează /public/collection/v1.1/search pentru a obține ID-uri de obiecte candidate. Transmite un ID către /public/collection/v1/objects/{id} pentru titlu, artist, dată, tehnică, link către muzeu și orice URL-uri de imagine Open Access disponibile.

Poate chatbotul muzeului să răspundă în spaniolă sau într-o altă limbă?

Da. Întreabă în limba vizitatorului, caută cu un termen scurt din catalog în engleză și traduce explicația. Păstrează titlul original, numele și calificativele de atribuire pentru ca vizitatorul să poată verifica înregistrarea muzeului.

Pot reutiliza fiecare imagine returnată de o căutare Met?

Verifică înregistrarea individuală a obiectului. The Met pune la dispoziție imaginile sale Open Access sub licența CC0. Acest chatbot oferă o imagine doar atunci când isPublicDomain este adevărat și un URL de imagine primară este prezent. În caz contrar, face legătura către pagina muzeului.

Poate chatbotul să-mi spună dacă o lucrare este expusă astăzi?

Pentru o vizită, deschide pagina curentă a obiectului din muzeu și verifică informațiile despre expunere. O căutare în colecție găsește lucrări catalogate, inclusiv lucrări aflate în depozit.

Poate chatbotul să explice intenția unui artist?

Fișa obiectului îți oferă date de catalog, cum ar fi tehnica și data. Pentru a explica intențiile unui artist sau un simbol din lucrare, utilizează o sursă suplimentară, cum ar fi un eseu al unui curator despre acea operă de artă anume.

Quickchat AI Quickchat AI Ask Quickchat AI a question