Twee afgesneden zonnebloemen liggen op een bed van blauwe verf. Vraag ernaar in het Spaans en je krijgt een zaalopschrift voor Vincent van Goghs Sunflowers, compleet met het jaar, het materiaal en een link naar het origineel. Voeg katten toe aan de aanwijzing en het spoor leidt naar een Franse zijden waaier.
U bouwt Collection Detective, een meertalige museumchatbot die de Met Collection API doorzoekt en een kort zaalopschrift schrijft van het kunstwerk dat hij vindt. Begin met het onderstaande schilderij. Uiteindelijk kunt u elke aanwijzing in Quickchat AI volgen en het antwoord controleren aan de hand van de eigen catalogus van het museum.
Quickchat AI behield de titel Sunflowers en vertaalde het medium naar “óleo sobre lienzo”. Vergelijk het antwoord met het museumlabel in Google Arts & Culture. The Met, Rogers Fund, 1949. Open de museumregistratie.
1. Geef je museumchatbot zijn eerste aanwijzing
De bezoeker levert een thema en een taal. De detective doet twee zoekacties. De eerste vindt kandidaat-object-ID’s. De tweede opent één ID en haalt de kunstenaar, titel, datum, materiaal en bronlink op. Pas dan schrijft de detective het zaalopschrift.
- Meld je aan of maak een Quickchat AI-account aan. Gebruik een lege Agent of selecteer Add new AI Agent → Set up manually. Noem deze Collection Detective. Je hebt voldoende tegoed nodig voor een paar testgesprekken. De museumopzoekingen werken zonder een Met-account of API-sleutel.
- Open Identity → AI Persona → Main Prompt. Plak de onderstaande instructies en sluit vervolgens het paneel. Identity slaat uw bewerkingen automatisch op. Ze vertellen de detective hoe hij een record moet kiezen en welke details hij moet bewaren wanneer de taal verandert.
Kopieer de Main Prompt voor 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.
- Voeg in Identity → Languages Engels en Spaans toe. We hebben ook Japans toegevoegd voor een tweede taalcontrole. De eerste taal is de terugval voor dubbelzinnige berichten. Hoe taalhints werken
De naam en instructies van de agent staan in Identity. De cataloguszoekopdrachten gaan in de volgende stap naar Actions & MCPs.
- Bewaar dit eerste bezoekersbericht voor AI Preview zodra beide Actions zijn ingeschakeld. De bezoeker vraagt om zonnebloemen te vinden en het eerste werk in het Spaans uit te leggen.
Busca girasoles en la colección del Met y explícame la primera obra en español.
De taal van de zoekopdracht is van belang. Op 19 november 2026 leverde het museum nul resultaten op voor girasoles en 153 voor sunflowers met dezelfde filters. Laat de bezoeker in het Spaans vragen, zoek naar de korte Engelse catalogusterm en vertel hem welk woord u hebt gebruikt.
2. Hoe doorzoekt u de Met Collection-API?
Geef de eerste Action één invoer, het thema. Houd de zoekopdracht klein genoeg zodat een bezoeker het spoor kan volgen. Met drie kandidaten kunt u het eerste werk openen en hebt u er nog een om te onderzoeken.
- Kies in Actions & MCPs Add Action → API Action → Create manually. Stel API Action Name in op
search_met_collectionen When to run op AI decides. De API Actions walkthrough toont dezelfde editor met een eenvoudiger verzoek. - Voeg onder What to ask the user first een verplichte Text-parameter toe met de naam
theme. Voer voor de beschrijving “A short English catalogue search phrase, such as sunflowers or cats and sunflowers.” in. - Kies in API Endpoint GET en voer
https://collectionapi.metmuseum.org/public/collection/v1.1/searchin. Maak in Query Params deze vier rijen. Gebruik Add AI Data → Parameters voor de eerste waarde, zodat het thema van de bezoeker in het verzoek wordt ingevoegd.
| Query sleutel | In te voeren waarde |
|---|---|
q | Voeg de theme-parameterchip in. |
hasImages | true |
limit | 3 |
offset | 0 |

q neemt het thema van de bezoeker over. De andere drie waarden staan vast. Lees de Search (v1.1)-referentie van The Met.
- Voer onder Headers
Acceptin met waardeapplication/json. Laat Body leeg. Plak het volgende in API Action Description, kies Save changes en controleer of de schakelaar van de actie aanstaat.
Kopieer de beschrijving van de zoekactie
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.
Open de zonnebloemenzoekopdracht in uw browser. Hier is de volledige respons van onze zoekopdracht. Het aantal omvat elke match. De lijst bevat alleen de drie ID’s die we hebben aangevraagd, en hun volgorde kan veranderen naarmate de catalogus verandert.
{"total":153,"objectIDs":[436524,480725,484935]}
3. Verander een object-ID in een Spaans zaalopschrift
Begin met 436524, de eerste ID in die respons. De tweede Action zoekt deze direct op. The Met gebruikt v1.1 voor zoeken en v1 voor individuele objecten. Als een ouder zoekvoorbeeld HTTP 410 retourneert, wijzig dan de zoekroute en laat de objectroute op v1 staan. De Met Collection API-referentie
- Maak nog een API Action. Stel API Action Name in op
get_met_objecten When to run op AI decides. Voeg onder What to ask the user first een verplichte Number toe met de naamobject_id. Beschrijf deze als “The integer Met object ID from a search result or the visitor.” - Kies in API Endpoint GET. Voer
https://collectionapi.metmuseum.org/public/collection/v1/objects/in, laat de laatste schuine streep staan en gebruik Add AI Data → Parameters om deobject_idchip toe te voegen. Met onze eerste ID eindigt het adres op/objects/436524. - Laat Query Params en Body leeg. Gebruik in Headers
Acceptmetapplication/json. Plak de onderstaande beschrijving in API Action Description, kies Save changes en controleer of de schakelaar van de actie aanstaat.
Kopieer de objectactiebeschrijving
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.
In de zoekactie komt het woord van de bezoeker in een queryrij. Hier wordt het nummer onderdeel van het adres zelf.
Open AI Preview en stuur de eerste aanwijzing. Zoek naar de oorspronkelijke titel Sunflowers, Vincent van Gogh, 1887, en óleo sobre lienzo. Volg de museumlink in het antwoord. De pagina vermeldt ook 49.41 als objectnummer. Dat is het inventarisnummer van het museum. Gebruik 436524 in de API. Het jaar 1949 in de creditline behoort tot de Rogers Fund-aankoop. Het schilderij zelf dateert uit 1887. Lees de objectgegevens
Open het schilderij met het vergrootglas en zoek “Vincent 87” in de linkerbenedenhoek. Scrol op de kunstwerkpagina naar Details en vergelijk de handtekening met het jaar onder Date Created. Verken Sunflowers van The Met op Google Arts & Culture.
Stel dezelfde twee acties in vanuit een verbonden AI-assistent
Als u Quickchat AI beheert via ChatGPT of Claude, kunt u de twee bovenstaande recepten ook gebruiken met dit instellingsverzoek. Controleer de gegenereerde velden en voer vervolgens zelf de eerste aanwijzing uit. Instructies voor accountverbinding
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. Hoe controleert u een vertaald zaalopschrift?
Open in Inbox het gesprek en vouw 2 actions called uit onder het antwoord. Voor de verzoekdetails gaat u naar Actions & MCPs → Custom Actions en selecteert u View logs voor elke Action. Zoek 436524 in de zoekrespons en aan het einde van het volgende verzoek. Door die nummers te matchen kunt u het Spaanse zaalopschrift terugleiden naar één object, zelfs als een ander werk dezelfde titel heeft.
Volg de eerste ID van het zoekresultaat naar de objectopzoeking. Die overdracht is wat het antwoord aan het schilderij koppelt.
Probeer deze aanwijzingen in nieuwe gesprekken. Om ze te herhalen na het bewerken van de prompt, open Testing → Create Dataset, geef de dataset een naam en voer de vragen in. Selecteer Run Tests → Start Run, dan View op een voltooid resultaat om het gesprek te openen in Inbox.
Controleer de toeschrijving. Vraag om een Spaanse beschrijving voor object 437406. De gegevens vermelden Rembrandt als naam en Follower of als voorvoegsel. Ons eerste antwoord legde de toeschrijving in het Spaans uit, maar liet de kunstenaarsregel in het Engels. We hebben één instructie gewijzigd om de kwalificatie en het medium te vertalen. Het volgende antwoord gaf un seguidor de Rembrandt en behield de onzekerheid in de datum, probablemente hacia 1658–62. Lees de catalogusvermelding van The Auctioneer.
Twee woorden dragen de toeschrijving. “Follower of” hoort bij de naam van de kunstenaar in beide talen. The Met, Bequest of Benjamin Altman, 1913.
Controleer de afbeelding. Vraag om object 480725, de tweede zonnebloemenmatch. Emil Noldes Large Sunflowers is gedateerd 1928 en geschilderd op paneel. De gegevens vermelden isPublicDomain: false en lege afbeeldings-URL’s. Geef de bezoeker de cataloguslink en het materiaal. Dit voorbeeld laat zien waarom hasImages=true alleen niet kan bepalen welke afbeelding moet worden getoond. Lees de Nolde-vermelding.
Het museum kan de catalogusgegevens delen, zelfs wanneer de API geen herbruikbare foto levert. Het Open Access-beeldbeleid van The Met.
Controleer een lege zoekopdracht. Vraag om de exacte term zzzxxyycollectiontest. De API retourneerde {"total":0,"objectIDs":null}. De detective kan om een bredere aanwijzing vragen. Een mislukte zoekopdracht heeft een ander antwoord nodig. Toen we een HTTP 503 simuleerden, vroeg de detective de bezoeker om het later opnieuw te proberen en deed geen objectverzoek.
5. Volg de zonnebloemen op een zijden waaier
Behoud de bloemen en voeg een dier toe. Geef Collection Detective een tweede aanwijzing en vraag op welke ondergrond elke kunstenaar werkte. U kunt dit bericht ongewijzigd gebruiken.
Busca «cats and sunflowers» y compara el soporte de la primera obra con el de Sunflowers (436524).
Probeer de tweede zoekopdracht. Onze eerste twee ID’s waren 705155 en 436524. The Met catalogiseert het eerste werk als een tekening. Kies op Wikimedia Commons Open in Media Viewer onder de foto van het museum. Volg de witte katten langs de baleinen en zoek naar de glinstering tussen de zonnebloemen. Inspecteer de waaier op 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. Verken de waaier in The Met.
Van Gogh werkte op doek. Guérard werkte op bewerkte zijde. De glinstering tussen de zonnebloemen heeft een materiële verklaring. Het museum vermeldt bladgoud naast de inkt en gouache. De datum blijft bij benadering, ca. 1885–90. Om uw eigen zoektocht in twee stappen te maken, kiest u een detail uit het eerste werk, voegt u dit toe aan de volgende aanwijzing en vraagt u de detective om één verschil dat u op beide objectpagina’s kunt verifiëren.
Veelgestelde vragen over de museumchatbot
Heb ik een API-sleutel nodig om de collectie van The Met te doorzoeken?
The Metropolitan Museum of Art biedt openbare zoek- en object-endpoints zonder registratie of API-sleutel. Je kunt beide verzoeken in een browser openen. Quickchat AI gebruikt accounttegoed voor het chatbotgesprek.
Welk Met API-endpoint retourneert een kunstwerk en de afbeelding ervan?
Gebruik /public/collection/v1.1/search om kandidaat-object-ID’s te verkrijgen. Geef één ID door aan /public/collection/v1/objects/{id} voor de titel, kunstenaar, datum, medium, museumlink en eventuele beschikbare Open Access afbeeldings-URL’s.
Kan de museumchatbot antwoorden in het Spaans of een andere taal?
Ja. Stel de vraag in de taal van de bezoeker, zoek met een korte Engelse catalogusterm en vertaal de uitleg. Behoud de originele titel, namen en toeschrijvingen zodat de bezoeker de museumgegevens kan controleren.
Kan ik elke afbeelding die door een Met-zoekopdracht wordt geretourneerd, hergebruiken?
Controleer de afzonderlijke objectgegevens. The Met stelt zijn Open Access-afbeeldingen beschikbaar onder CC0. Deze chatbot biedt alleen een afbeelding aan wanneer isPublicDomain waar is en er een primaire afbeeldings-URL aanwezig is. Anders linkt hij naar de museumpagina.
Kan de chatbot me vertellen of een werk vandaag te zien is?
Voor een bezoek, open de huidige museumpagina van het object en controleer de weergave-informatie. Een collectiezoekopdracht vindt gecatalogiseerde werken, inclusief werken in opslag.
Kan de chatbot uitleggen wat een kunstenaar bedoelde?
De objectgegevens geven u feiten uit de catalogus, zoals het materiaal en de datum. Om de bedoelingen van een kunstenaar of een symbool in het werk uit te leggen, gebruikt u een aanvullende bron, zoals een essay van een conservator over dat specifieke kunstwerk.