Två avskurna solrosor ligger på en bädd av blå färg. Fråga efter dem på spanska så får du en utställningsetikett för Vincent van Goghs Sunflowers, komplett med årtal, material och en länk till originalet. Lägg till katter i ledtråden så leder spåret till en fransk solfjäder av siden.
Du ska bygga Collection Detective, en flerspråkig museichatbot som söker i The Met Collection API och skriver en kort etikett utifrån det konstverk den hittar. Börja med målningen nedan. När du är klar kommer du att kunna följa någon av ledtrådarna på Quickchat AI och kontrollera svaret mot museets egen katalog.
Quickchat AI behöll titeln Sunflowers och översatte mediet till ”óleo sobre lienzo”. Jämför svaret med museets etikett i Google Arts & Culture. The Met, Rogers Fund, 1949. Öppna museets register.
1. Ge din museichatbot sin första ledtråd
Besökaren anger ett tema och ett språk. Detektiven gör två sökningar. Den första hittar kandidat-objekt-ID:n. Den andra öppnar ett ID och hämtar konstnär, titel, datum, medium och källänk. Först då skriver detektiven etiketten.
- Logga in eller skapa ett Quickchat AI-konto. Använd en tom agent eller välj Add new AI Agent → Set up manually. Döp den till Collection Detective. Du behöver tillräckligt med krediter för några testkonversationer. Museisökningarna fungerar utan ett Met-konto eller API-nyckel.
- Öppna Identity → AI Persona → Main Prompt. Klistra in instruktionerna nedan och stäng sedan panelen. Identiteten sparar dina ändringar automatiskt. De talar om för detektiven hur den ska välja en post och vilka detaljer som ska behållas när den byter språk.
Kopiera Main Prompt för 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 lägger du till engelska och spanska. Vi lade även till japanska för en andraspråkskontroll. Det första språket är reservspråket för tvetydiga meddelanden. Så fungerar språkledtrådar
Agentens namn och instruktioner finns i Identity. Kataloguppslagen finns i Actions & MCPs i nästa steg.
- Behåll detta första besöksmeddelande för AI Preview när båda åtgärderna är aktiverade. Besökaren ber om att hitta solrosor och förklara det första verket på spanska.
Busca girasoles en la colección del Met y explícame la primera obra en español.
Sökningens språk spelar roll. Den 19 november 2026 returnerade museet noll träffar för girasoles och 153 för sunflowers med samma filter. Låt besökaren fråga på spanska, sök efter den korta engelska katalogtermen och berätta för dem vilken term du använde.
2. Hur söker du i The Met Collection API?
Ge den första åtgärden en inmatning, temat. Håll sökningen tillräckligt liten så att en besökare kan följa spåret. Tre kandidater låter dig öppna det första verket och fortfarande ha ett annat att undersöka.
- I Actions & MCPs väljer du Add Action → API Action → Create manually. Ställ in API Action Name på
search_met_collectionoch When to run på AI decides. API Actions-genomgången visar samma redigerare med en enklare förfrågan. - Under What to ask the user first lägger du till en obligatorisk Text-parameter som heter
theme. För dess beskrivning anger du ”A short English catalogue search phrase, such as sunflowers or cats and sunflowers.” - I API Endpoint väljer du GET och anger
https://collectionapi.metmuseum.org/public/collection/v1.1/search. I Query Params skapar du dessa fyra rader. Använd Add AI Data → Parameters för det första värdet så att besökarens tema infogas i förfrågan.
| Frågenyckel | Värde att ange |
|---|---|
q | Infoga theme-parameterchipet. |
hasImages | true |
limit | 3 |
offset | 0 |

q tar besökarens tema. De andra tre värdena förblir fasta. Läs The Mets Search (v1.1)-referens.
- Under Headers anger du
Acceptmed värdetapplication/json. Lämna Body tomt. Klistra in följande i API Action Description, välj Save changes och kontrollera att åtgärdens omkopplare är påslagen.
Kopiera beskrivningen av sökåtgärden
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.
Öppna solrossökningen i din webbläsare. Här är hela svaret från vår sökning. Antalet omfattar varje träff. Listan innehåller endast de tre ID:n vi begärde, och deras ordning kan ändras när katalogen uppdateras.
{"total":153,"objectIDs":[436524,480725,484935]}
3. Förvandla ett objekt-ID till en spansk museietikett
Börja med 436524, det första ID:t i det svaret. Den andra åtgärden slår upp det direkt. The Met använder v1.1 för sökning och v1 för enskilda objekt. Om ett äldre sökexempel returnerar HTTP 410, ändra sökrouten och lämna objektsrouten på v1. The Met Collection API-referens
- Skapa ytterligare en API Action. Ställ in API Action Name på
get_met_objectoch When to run på AI decides. Under What to ask the user first lägger du till en obligatorisk Number med namnetobject_id. Beskriv den som ”The integer Met object ID from a search result or the visitor.” - I API Endpoint väljer du GET. Ange
https://collectionapi.metmuseum.org/public/collection/v1/objects/, lämna det sista snedstrecket på plats och använd Add AI Data → Parameters för att lägga tillobject_id-chipet. Med vårt första ID slutar adressen med/objects/436524. - Lämna Query Params och Body tomma. I Headers använder du
Acceptmedapplication/json. Klistra in beskrivningen nedan i API Action Description, välj Save changes och kontrollera att åtgärdens omkopplare är påslagen.
Kopiera beskrivningen av objektåtgärden
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ökåtgärden hamnar besökarens ord i en frågerad. Här blir numret en del av själva adressen.
Öppna AI Preview och skicka första ledtråden. Leta efter originaltiteln Sunflowers, Vincent van Gogh, 1887, och óleo sobre lienzo. Följ museilänken i svaret. Sidan listar också 49.41 som sitt objektnummer. Det är museets förvärvsnummer. Använd 436524 i API:et. Året 1949 i kreditraden tillhör Rogers Funds förvärv. Målningen i sig dateras till 1887. Läs objektdata
Öppna målningen med förstoringsglaset och hitta ”Vincent 87” i det nedre vänstra hörnet. På konstverkssidan, rulla till Details och jämför signaturen med året under Date Created. Utforska The Mets Sunflowers på Google Arts & Culture.
Ställ in samma två åtgärder från en ansluten AI-assistent
Om du hanterar Quickchat AI via ChatGPT eller Claude kan du också använda de två recepten ovan med denna installationsförfrågan. Granska de genererade fälten och kör sedan den första ledtråden själv. Instruktioner för kontokoppling
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. Hur kontrollerar du en översatt konstverksetikett?
I Inbox öppnar du konversationen och expanderar 2 actions called under svaret. För förfrågningsdetaljerna, gå till Actions & MCPs → Custom Actions och välj View logs för varje åtgärd. Hitta 436524 i sökresultatet och i slutet av nästa förfrågan. Att matcha dessa nummer låter dig spåra den spanska etiketten tillbaka till ett objekt även om ett annat verk har samma titel.
Följ det första ID:t från sökresultatet in i objektuppslagningen. Den överlämningen är det som kopplar svaret till målningen.
Prova dessa ledtrådar i nya konversationer. För att upprepa dem efter att ha redigerat prompten, öppna Testing → Create Dataset, namnge datasetet och ange frågorna. Välj Run Tests → Start Run, sedan View på ett slutfört resultat för att öppna dess konversation i Inbox.
Kontrollera tillskrivningen. Be om en spansk etikett för objektet 437406. I dess post anges Rembrandt som namn och Follower of som prefix. Vårt första svar förklarade tillskrivningen på spanska men lämnade raden om konstnären på engelska. Vi ändrade en instruktion för att översätta både kvalificeraren och mediet. Nästa svar angav un seguidor de Rembrandt och behöll osäkerheten kring datumet, probablemente hacia 1658–62. Läs auktionsförrättarens katalogtext.
Två ord bär attribueringen. ”Follower of” hör ihop med konstnärens namn på båda språken. The Met, Bequest of Benjamin Altman, 1913.
Kontrollera bilden. Be att få se objekt 480725, den andra solrosträffen. Emil Noldes Large Sunflowers är daterad 1928 och målad på pannå. Dess post har isPublicDomain: false och tomma bild-URL:er. Ge besökaren kataloglänken och materialet. Detta exempel är varför hasImages=true ensamt inte kan avgöra vilken bild som ska visas. Läs Nolde-posten.
Museet kan dela katalogdetaljerna även när API:et inte tillhandahåller något återanvändbart fotografi. The Mets policy för Open Access-bilder.
Kontrollera en tom sökning. Fråga efter den exakta termen zzzxxyycollectiontest. API:et returnerade {"total":0,"objectIDs":null}. Detektiven kan be om en bredare ledtråd. En misslyckad sökning behöver ett annat svar. När vi simulerade en HTTP 503, bad detektiven besökaren att försöka igen senare och gjorde ingen objektförfrågan.
5. Följ solrosorna till en solfjäder av siden
Behåll blommorna och lägg till ett djur. Ge Collection Detective en andra ledtråd och fråga vilket underlag varje konstnär arbetade på. Du kan använda detta meddelande som det är skrivet.
Busca «cats and sunflowers» y compara el soporte de la primera obra con el de Sunflowers (436524).
Prova den andra sökningen. Våra två första ID:n var 705155 och 436524. The Met katalogiserar det första verket som en teckning. På Wikimedia Commons, välj Open in Media Viewer under museets fotografi. Följ de vita katterna längs ribborna och leta efter glimten mellan solrosorna. Inspektera solfjädern 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. Utforska fläkten på The Met.
Van Gogh arbetade på duk. Guérard arbetade på mönstrat siden. Glansen bland solrosorna har en materiell förklaring. Museet listar bladguld tillsammans med bläck och gouache. Datumet förblir ungefärligt, ca. 1885–90. För att skapa din egen tvåstoppsjakt, välj en detalj från det första verket, lägg till den i nästa ledtråd och fråga detektiven om en skillnad du kan verifiera på båda objektsidorna.
Vanliga frågor om museichatbotar
Behöver jag en API-nyckel för att söka i The Mets samling?
Metropolitan Museum of Art tillhandahåller offentliga sök- och objekt-endpoints utan registrering eller API-nyckel. Du kan öppna båda förfrågningarna i en webbläsare. Quickchat AI använder kontokrediter för chatbot-konversationen.
Vilken Met API-ändpunkt returnerar ett konstverk och dess bild?
Använd /public/collection/v1.1/search för att få kandidatobjekt-ID:n. Skicka ett ID till /public/collection/v1/objects/{id} för att få titel, konstnär, datum, medium, museilänk och eventuella bild-URL:er från Open Access.
Kan museets chatbot svara på spanska eller något annat språk?
Ja. Ställ frågan på besökarens språk, sök med ett kort engelskt katalogord och översätt förklaringen. Behåll den ursprungliga titeln, namnen och upphovsangivelserna så att besökaren kan kontrollera museets register.
Får jag återanvända alla bilder som en sökning på Met ger som resultat?
Kontrollera den enskilda objektposten. The Met gör sina Open Access-bilder tillgängliga under CC0. Denna chattbot erbjuder en bild endast när isPublicDomain är true och en primär bild-URL finns. I annat fall länkar den till museets sida.
Kan chatboten berätta för mig om ett verk visas idag?
För ett besök, öppna den aktuella museiobjektsidan och kontrollera dess visningsinformation. En samlingssökning hittar katalogiserade verk, inklusive verk i magasin.
Kan chatboten förklara vad en konstnär avsåg?
Objektbeskrivningen ger dig kataloguppgifter såsom teknik och datum. För att förklara en konstnärs avsikter eller en symbol i verket, använd en ytterligare källa, till exempel en kurators essä om just det konstverket.