To afskårne solsikker ligger på en bund af blå maling. Spørg efter dem på spansk, og du kan få en vægetiket til Vincent van Goghs Sunflowers, komplet med årstal, materiale og et link til originalen. Tilføj katte til ledetråden, og sporet fører til en fransk silkevifte.
Du skal bygge Collection Detective, en flersproget museumschatbot, der søger i The Met Collection API og skriver en kort etiket ud fra det kunstværk, den finder. Start med maleriet nedenfor. Til sidst vil du kunne følge en hvilken som helst ledetråd i Quickchat AI og tjekke svaret i museets eget katalog.
Quickchat AI beholdt titlen Sunflowers og oversatte mediet til “óleo sobre lienzo.” Sammenlign svaret med museumsetiketten i Google Arts & Culture. The Met, Rogers Fund, 1949. Åbn museumsregistreringen.
1. Giv din museums-chatbot dens første ledetråd
Den besøgende angiver et tema og et sprog. Detektiven foretager to opslag. Det første finder kandidat-objekt-id’er. Det andet åbner et id og returnerer kunstner, titel, dato, materiale og kildelink. Først derefter skriver detektiven etiketten.
- Log ind, eller opret en Quickchat AI-konto. Brug en tom agent, eller vælg Add new AI Agent → Set up manually. Giv den navnet Collection Detective. Du skal bruge nok credits til et par testsamtaler. Museumsopslagene fungerer uden en Met-konto eller API-nøgle.
- Åbn Identity → AI Persona → Main Prompt. Indsæt instruktionerne nedenfor, og luk derefter panelet. ‘Identity’ gemmer dine redigeringer automatisk. De fortæller detektiven, hvordan den skal vælge en post, og hvilke detaljer den skal bevare, når den skifter sprog.
Kopiér Main Prompt til 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.
- Under Identity → Languages skal du tilføje engelsk og spansk. Vi tilføjede også japansk for at kunne tjekke et andetsprog. Det første sprog er fallback for tvetydige meddelelser. Sådan fungerer sproghints
Agentens navn og instruktioner findes under ‘Identity’. Katalogopslagene skal ind under ‘Actions & MCPs’ i næste trin.
- Behold denne første besøgsbesked til AI Preview, når begge handlinger er aktiveret. Den besøgende beder om at finde solsikker og forklare det første værk på spansk.
Busca girasoles en la colección del Met y explícame la primera obra en español.
Sproget for søgningen har betydning. Den 19. november 2026 returnerede museet nul resultater for girasoles og 153 for sunflowers med de samme filtre. Lad den besøgende spørge på spansk, søg efter den korte engelske katalogterm, og fortæl vedkommende, hvilket ord du brugte.
2. Hvordan søger du i The Met Collection API?
Giv den første handling én input, temaet. Hold søgningen lille nok til, at en besøgende kan følge sporet. Tre kandidater giver dig mulighed for at åbne det første værk og stadig have et andet at undersøge.
- I Actions & MCPs skal du vælge Add Action → API Action → Create manually. Indstil API Action Name til
search_met_collectionog When to run til AI decides. API Actions-gennemgangen viser den samme editor med en enklere anmodning. - Under What to ask the user first skal du tilføje en påkrævet Text-parameter kaldet
theme. For dens beskrivelse skal du indtaste “A short English catalogue search phrase, such as sunflowers or cats and sunflowers.” - I API Endpoint skal du vælge GET og indtaste
https://collectionapi.metmuseum.org/public/collection/v1.1/search. I Query Params skal du oprette disse fire rækker. Brug Add AI Data → Parameters til den første værdi, så den besøgendes tema indsættes i anmodningen.
| Søgenøgle | Værdi, der skal indtastes |
|---|---|
q | Indsæt theme-parameterchippen. |
hasImages | true |
limit | 3 |
offset | 0 |

q tager den besøgendes tema. De andre tre værdier forbliver faste. Læs The Mets Search (v1.1)-reference.
- Under Headers indtastes
Acceptmed værdienapplication/json. Lad Body være tom. Indsæt følgende i API Action Description, vælg Save changes, og kontroller, at handlingens kontakt er slået til.
Kopiér søgehandlingens beskrivelse
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.
Åbn solsikkesøgningen i din browser. Her er hele svaret fra vores søgning. Antallet dækker alle match. Listen indeholder kun de tre id’er, vi anmodede om, og deres rækkefølge kan ændre sig, når kataloget ændres.
{"total":153,"objectIDs":[436524,480725,484935]}
3. Forvandl et objekt-ID til en spansk museumslabel
Start med 436524, det første ID i det svar. Den anden handling slår det direkte op. The Met bruger v1.1 til søgning og v1 til individuelle objekter. Hvis et ældre søgeeksempel returnerer HTTP 410, skal du ændre søgeruten og lade objektruten være v1. The Met Collection API-reference
- Opret endnu en API Action. Indstil API Action Name til
get_met_objectog When to run til AI decides. Under What to ask the user first skal du tilføje en påkrævet Number-parameter med navnetobject_id. Beskriv den som “The integer Met object ID from a search result or the visitor.” - I API Endpoint skal du vælge GET. Indtast
https://collectionapi.metmuseum.org/public/collection/v1/objects/, lad den sidste skråstreg være på plads, og brug Add AI Data → Parameters til at tilføjeobject_id-chippen. Med vores første ID ender adressen på/objects/436524. - Lad Query Params og Body være tomme. I Headers bruges
Acceptmedapplication/json. Indsæt beskrivelsen nedenfor i API Action Description, vælg Save changes, og kontroller, at handlingens kontakt er slået til.
Kopiér objektets handlingsbeskrivelse
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.
I søgehandlingen placeres den besøgendes ord i en forespørgselsrække. Her bliver nummeret en del af selve adressen.
Åbn AI Preview, og send den første ledetråd. Se efter originaltitlen Sunflowers, Vincent van Gogh, 1887 og óleo sobre lienzo. Følg museumslinket i svaret. Siden angiver også 49.41 som sit ‘Object Number’. Det er museets accessionsnummer. Brug 436524 i API’en. Året 1949 i kreditlinjen henviser til Rogers Fund-erhvervelsen. Selve maleriet er dateret til 1887. Læs objektdataene
Åbn maleriet med forstørrelsesglasset og find “Vincent 87” i nederste venstre hjørne. På kunstværkssiden skal du rulle til Details og sammenligne signaturen med året under Date Created. Udforsk The Mets Sunflowers på Google Arts & Culture.
Opsæt de samme to handlinger fra en forbundet AI-assistent
Hvis du administrerer Quickchat AI via ChatGPT eller Claude, kan du også bruge de to opskrifter ovenfor med denne opsætningsanmodning. Gennemgå de genererede felter, og kør derefter det første spor selv. Vejledning til kontoforbindelse
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. Hvordan kontrollerer du en oversat kunstværkslabel?
I Inbox skal du åbne samtalen og udvide 2 actions called under svaret. For anmodningsdetaljerne skal du gå til Actions & MCPs → Custom Actions og vælge View logs for hver handling. Find 436524 i søgeresultatet og i slutningen af den næste anmodning. At matche disse numre giver dig mulighed for at spore den spanske label tilbage til ét objekt, selvom et andet værk har den samme titel.
Følg det første ID fra søgeresultatet ind i objektopslaget. Denne overlevering er det, der forbinder svaret med maleriet.
Prøv disse spor i nye samtaler. For at gentage dem efter redigering af prompten skal du åbne Testing → Create Dataset, navngive datasættet og indtaste spørgsmålene. Vælg Run Tests → Start Run, derefter View på et gennemført resultat for at åbne dets samtale i Inbox.
Tjek tilskrivningen. Bed om en spansk etiket for objekt 437406. Registreringen angiver Rembrandt som navn og Follower of som præfiks. Vores første svar forklarede tilskrivningen på spansk, men lod kunstnerlinjen stå på engelsk. Vi ændrede en instruktion til også at oversætte kvalifikatoren såvel som materialet. Det næste svar gav un seguidor de Rembrandt og bevarede usikkerheden i dateringen, probablemente hacia 1658–62. Læs katalogposten for ‘The Auctioneer’.
To ord angiver tilskrivningen. “Follower of” hører til kunstnerens navn på begge sprog. The Met, Bequest of Benjamin Altman, 1913.
Tjek billedet. Bed om at se objekt 480725, det andet solsikkematch. Emil Noldes Large Sunflowers er dateret 1928 og malet på træ. Registreringen har isPublicDomain: false og tomme billed-URL’er. Giv den besøgende kataloglinket og materialet. Dette eksempel er grunden til, at hasImages=true alene ikke kan afgøre, hvilket billede der skal vises. Læs Nolde-registreringen.
Museet kan dele katalogdetaljerne, selv når API’en ikke leverer et genanvendeligt fotografi. The Mets Open Access billedpolitik.
Tjek en tom søgning. Spørg efter det nøjagtige udtryk zzzxxyycollectiontest. API’en returnerede {"total":0,"objectIDs":null}. Detektiven kan bede om et bredere spor. Et mislykket opslag kræver et andet svar. Da vi simulerede en HTTP 503, bad detektiven den besøgende om at prøve igen senere og foretog ingen objektanmodning.
5. Følg solsikkerne over på en silkevifte
Behold blomsterne og tilføj et dyr. Giv Collection Detective et andet spor, og spørg, hvilket underlag hver kunstner arbejdede på. Du kan bruge denne besked som skrevet.
Busca «cats and sunflowers» y compara el soporte de la primera obra con el de Sunflowers (436524).
Prøv den anden søgning. Vores første to ID’er var 705155 og 436524. The Met katalogiserer det første værk som en tegning. På Wikimedia Commons skal du vælge Open in Media Viewer under museets fotografi. Følg de hvide katte langs ribberne og se efter glimtet mellem solsikkerne. Undersøg viften på Wikimedia Commons.
Henri Charles Guérard, Fan Design with Cats and Sunflowers, ca. 1885–90. The Met, Gift of Robert Tuggle and Paul Jeromack, 2015. Udforsk viften på The Met.
Van Gogh arbejdede på lærred. Guérard arbejdede på mønstret silke. Glansen blandt solsikkerne har en materiel forklaring. Museet angiver bladguld sammen med blæk og gouache. Datoen forbliver omtrentlig, ca. 1885–90. For at lave din egen to-stop jagt, vælg en detalje fra det første værk, tilføj den til det næste spor og spørg detektiven om én forskel, du kan verificere på begge objektsider.
Ofte stillede spørgsmål om museums-chatbot
Skal jeg bruge en API-nøgle for at søge i The Met-samlingen?
The Metropolitan Museum of Art tilbyder offentlige søge- og objekt-endpoints uden registrering eller en API-nøgle. Du kan åbne begge anmodninger i en browser. Quickchat AI bruger konto-kreditter til chatbot-samtalen.
Hvilket Met API-endpoint returnerer et kunstværk og dets billede?
Brug /public/collection/v1.1/search til at få kandidatobjekt-id’er. Send et id til /public/collection/v1/objects/{id} for at få titel, kunstner, dato, materiale, museumslink og eventuelle tilgængelige Open Access-billed-URL’er.
Kan museums-chatbotten svare på spansk eller et andet sprog?
Ja. Stil spørgsmålet på den besøgendes sprog, søg med en kort engelsk katalogterm, og oversæt forklaringen. Bevar originaltitlen, navne og tilskrivningskvalifikatorer, så den besøgende kan tjekke museumsregistreringen.
Kan jeg genbruge alle billeder, der returneres af en Met-søgning?
Tjek den enkelte objektregistrering. The Met stiller sine Open Access-billeder til rådighed under CC0. Denne chatbot tilbyder kun et billede, når isPublicDomain er ‘true’, og en primær billed-URL er til stede. Ellers linker den til museets side.
Kan chatbotten fortælle mig, om et værk er udstillet i dag?
Hvis du planlægger et besøg, skal du åbne den aktuelle museumsobjektside og tjekke udstillingsinformationen. En samlingssøgning finder katalogiserede værker, herunder værker i magasin.
Kan chatbotten forklare, hvad en kunstner havde til hensigt?
Objektregistreringen giver dig katalogfakta såsom materiale og dato. For at forklare en kunstners intentioner eller et symbol i værket skal du bruge en supplerende kilde, f.eks. et kuratoressay om det pågældende kunstværk.