To avskårne solsikker ligger på et underlag av blå maling. Spør etter dem på spansk, og du kan få en veggetikett for Vincent van Goghs Sunflowers, komplett med årstall, materiale og en lenke til originalen. Legg til katter i ledetråden, og sporet fører til en fransk silkevifte.
Du skal bygge Collection Detective, en flerspråklig museums-chatbot som søker i The Met Collection API og skriver en kort etikett fra kunstverket den finner. Start med maleriet nedenfor. Til slutt vil du kunne følge en av ledetrådene i Quickchat AI og sjekke svaret mot museets egen katalog.
Quickchat AI beholdt tittelen Sunflowers og oversatte mediet til «óleo sobre lienzo». Sammenlign svaret med museumsetiketten i Google Arts & Culture. The Met, Rogers Fund, 1949. Åpne museumsregistreringen.
1. Gi museums-chatboten din den første ledetråden
Den besøkende oppgir et tema og et språk. Detektiven gjør to oppslag. Det første finner kandidat-objekt-ID-er. Det andre åpner én ID og henter tilbake kunstner, tittel, datering, medium og kildelenke. Først da skriver detektiven etiketten.
- Logg inn eller opprett en Quickchat AI-konto. Bruk en tom Agent eller velg Add new AI Agent → Set up manually. Gi den navnet Collection Detective. Du trenger nok kreditter til noen få test-samtaler. Museums-oppslagene fungerer uten en Met-konto eller API-nøkkel.
- Åpne Identity → AI Persona → Main Prompt. Lim inn instruksjonene nedenfor, og lukk deretter panelet. Identity lagrer endringene dine automatisk. De forteller detektiven hvordan man velger en post og hvilke detaljer som skal beholdes når språket endres.
Kopier Main Prompt for 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.
- I Identity → Languages legger du til engelsk og spansk. Vi la også til japansk for en andrespråkskontroll. Det første språket er reserve for tvetydige meldinger. Slik fungerer språkhenvisninger
Agentens navn og instruksjoner ligger i Identity. Katalogoppslagene går i Actions & MCPs i neste trinn.
- Behold denne første besøksmeldingen for AI Preview når begge Actions er aktivert. Besøkeren ber om å finne solsikker og forklare det første verket på spansk.
Busca girasoles en la colección del Met y explícame la primera obra en español.
Språket i søket er viktig. Den 19. november 2026 returnerte museet null treff for girasoles og 153 for sunflowers med de samme filtrene. La den besøkende spørre på spansk, søk etter det korte engelske katalogbegrepet og fortell hvilket ord du brukte.
2. Hvordan søker du i The Met Collection API?
Gi den første handlingen én inndata, temaet. Hold søket lite nok til at en besøkende kan følge sporet. Tre kandidater lar deg åpne det første verket og fortsatt ha et annet å undersøke.
- I Actions & MCPs velger du Add Action → API Action → Create manually. Sett API Action Name til
search_met_collectionog When to run til AI decides. Gjennomgangen av API-handlinger viser den samme redigeringsfunksjonen med en enklere forespørsel. - Under What to ask the user first legger du til en obligatorisk Text-parameter kalt
theme. For beskrivelsen skriver du inn «A short English catalogue search phrase, such as sunflowers or cats and sunflowers.» - I API Endpoint velger du GET og skriver inn
https://collectionapi.metmuseum.org/public/collection/v1.1/search. I Query Params oppretter du disse fire radene. Bruk Add AI Data → Parameters for den første verdien slik at besøkerens tema settes inn i forespørselen.
| Søkenøkkel | Verdi å skrive inn |
|---|---|
q | Sett inn theme-parameterbrikken. |
hasImages | true |
limit | 3 |
offset | 0 |

q bruker den besøkendes tema. De tre andre verdiene forblir faste. Les The Mets Search (v1.1)-referanse.
- Under Headers, skriv inn
Acceptmed verdienapplication/json. La Body stå tom. Lim inn følgende i API Action Description, velg Save changes og sjekk at handlingens bryter er på.
Kopier beskrivelsen av søkehandlingen
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.
Åpne solsikkesøket i nettleseren din. Her er hele svaret fra søket vårt. Antallet dekker hvert treff. Listen inneholder bare de tre ID-ene vi ba om, og rekkefølgen kan endres når katalogen endres.
{"total":153,"objectIDs":[436524,480725,484935]}
3. Gjør en objekt-ID om til en spansk museumsetikett
Start med 436524, den første ID-en i det svaret. Den andre handlingen slår den opp direkte. The Met bruker v1.1 for søk og v1 for individuelle objekter. Hvis et eldre søkeeksempel returnerer HTTP 410, endrer du søkeruten og lar objektruten stå på v1. The Met Collection API-referanse
- Opprett en annen API Action. Sett API Action Name til
get_met_objectog When to run til AI decides. Under What to ask the user first legger du til en obligatorisk Number kaltobject_id. Beskriv den som «The integer Met object ID from a search result or the visitor.» - I API Endpoint velger du GET. Skriv inn
https://collectionapi.metmuseum.org/public/collection/v1/objects/, la den siste skråstreken stå og bruk Add AI Data → Parameters til å legge tilobject_id-brikken. Med vår første ID ender adressen på/objects/436524. - La Query Params og Body stå tomme. I Headers bruker du
Acceptmedapplication/json. Lim inn beskrivelsen nedenfor i API Action Description, velg Save changes og sjekk at handlingens bryter er på.
Kopier beskrivelsen av objekt-handlingen
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økehandlingen går besøkerens ord inn i en spørringsrad. Her blir tallet en del av selve adressen.
Åpne AI Preview og send første ledetråd. Se etter originaltittelen Sunflowers, Vincent van Gogh, 1887 og óleo sobre lienzo. Følg museumslenken i svaret. Siden viser også 49.41 som objektnummer. Det er museets aksjesjonsnummer. Bruk 436524 i API-et. Året 1949 i kredittlinjen tilhører Rogers Fund-anskaffelsen. Selve maleriet dateres til 1887. Les objektdataene
Åpne maleriet med forstørrelsesglasset og finn «Vincent 87» i nedre venstre hjørne. På kunstverkssiden blar du til Details og sammenligner signaturen med året under Date Created. Utforsk The Mets Sunflowers på Google Arts & Culture.
Sett opp de samme to handlingene fra en tilkoblet AI-assistent
Hvis du administrerer Quickchat AI via ChatGPT eller Claude, kan du også bruke de to oppskriftene ovenfor med denne oppsettforespørselen. Gå gjennom de genererte feltene, og kjør deretter den første ledetråden selv. Instruksjoner for kontotilkobling
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 sjekker du en oversatt kunstverketikett?
I Inbox åpner du samtalen og utvider 2 actions called under svaret. For forespørselsdetaljene går du til Actions & MCPs → Custom Actions og velger View logs for hver Action. Finn 436524 i søkeresponsen og på slutten av neste forespørsel. Ved å matche disse tallene kan du spore den spanske etiketten tilbake til ett objekt, selv om et annet verk har samme tittel.
Følg den første ID-en fra søkeresultatet inn i objektoppslaget. Denne overleveringen er det som knytter svaret til maleriet.
Prøv disse ledetrådene i nye samtaler. For å gjenta dem etter å ha redigert ledeteksten, åpne Testing → Create Dataset, navngi datasettet og skriv inn spørsmålene. Velg Run Tests → Start Run, deretter View på et fullført resultat for å åpne samtalen i Inbox.
Sjekk tilskrivningen. Be om en spansk etikett for objekt 437406. Posten angir Rembrandt som navn og Follower of som prefiks. Vårt første svar forklarte tilskrivningen på spansk, men beholdt kunstnerlinjen på engelsk. Vi endret en instruksjon for å oversette kvalifikatoren så vel som mediet. Det neste svaret ga un seguidor de Rembrandt og beholdt usikkerheten i datoen, probablemente hacia 1658–62. Les katalogposten for The Auctioneer.
To ord angir tilskrivningen. «Follower of» hører sammen med kunstnerens navn på begge språk. The Met, Bequest of Benjamin Altman, 1913.
Sjekk bildet. Be om å få se objekt 480725, det andre solsikketreffet. Emil Noldes Large Sunflowers er datert 1928 og malt på plate. Posten har isPublicDomain: false og tomme bilde-URL-er. Gi den besøkende kataloglenken og materialet. Dette eksemplet viser hvorfor hasImages=true alene ikke kan avgjøre hvilket bilde som skal vises. Les Nolde-posten.
Museet kan dele katalogdetaljene selv når API-et ikke leverer et gjenbrukbart fotografi. The Mets retningslinjer for Open Access-bilder.
Sjekk et tomt søk. Spør etter det eksakte begrepet zzzxxyycollectiontest. API-et returnerte {"total":0,"objectIDs":null}. Detektiven kan be om en bredere ledetråd. Et mislykket oppslag krever et annet svar. Da vi simulerte en HTTP 503, ba detektiven den besøkende om å prøve igjen senere og gjorde ingen objektforespørsel.
5. Følg solsikkene over på en silkevifte
Behold blomstene og legg til et dyr. Gi Collection Detective en ny ledetråd og spør hvilken overflate hver kunstner arbeidet på. Du kan bruke denne meldingen slik den er skrevet.
Busca «cats and sunflowers» y compara el soporte de la primera obra con el de Sunflowers (436524).
Prøv det andre søket. Våre to første ID-er var 705155 og 436524. The Met katalogiserer det første verket som en tegning. På Wikimedia Commons velger du Open in Media Viewer under museets fotografi. Følg de hvite kattene langs spilene og se etter glimtet mellom solsikkene. Inspiser 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. Utforsk viften på The Met.
Van Gogh arbeidet på lerret. Guérard arbeidet på mønstret silke. Glitret blant solsikkene har en materiell forklaring. Museet oppgir bladgull sammen med blekk og gouache. Dateringen er omtrentlig, ca. 1885–90. For å lage din egen jakt med to stopp, velg en detalj fra det første verket, legg det til i neste ledetråd og be detektiven om én forskjell du kan verifisere på begge objektsidene.
Ofte stilte spørsmål om museums-chatbot
Trenger jeg en API-nøkkel for å søke i The Met-samlingen?
The Metropolitan Museum of Art tilbyr offentlige søke- og objekt-endepunkter uten registrering eller API-nøkkel. Du kan åpne begge forespørslene i en nettleser. Quickchat AI bruker kontokreditter for chatbot-samtalen.
Hvilket Met API-endepunkt returnerer et kunstverk og dets bilde?
Bruk /public/collection/v1.1/search for å få kandidat-objekt-ID-er. Send én ID til /public/collection/v1/objects/{id} for tittel, kunstner, datering, medium, museums-lenke og eventuelle tilgjengelige Open Access bilde-URL-er.
Kan museums-chatboten svare på spansk eller et annet språk?
Ja. Spør på den besøkendes språk, søk med et kort engelsk katalogbegrep og oversett forklaringen. Behold original tittel, navn og tilskrivningskvalifikatorer slik at den besøkende kan sjekke museumsposten.
Kan jeg gjenbruke alle bilder som returneres av et Met-søk?
Sjekk den individuelle objekt-posten. The Met gjør sine Open Access bilder tilgjengelige under CC0. Denne chatboten tilbyr et bilde kun når isPublicDomain er sant og en primær bilde-URL er til stede. Ellers lenker den til museums-siden.
Kan chatboten fortelle meg om et verk er utstilt i dag?
For et besøk, åpne den aktuelle museumsobjektsiden og sjekk visningsinformasjonen. Et samlingssøk finner katalogiserte verk, inkludert verk på lager.
Kan chatboten forklare hva en kunstner hadde til hensikt?
Objektposten gir deg katalogfakta som medium og datering. For å forklare en kunstners intensjoner eller et symbol i verket, bruk en tilleggskilde, for eksempel et kurator-essay om det spesifikke kunstverket.