Bouw een museumchatbot voor een zonnebloemenjacht in The Met

Piotr Grudzień
Gepubliceerd 8 min leestijd
Het Spaanse label van Collection Detective in Quickchat AI naast Van Goghs Sunflowers in de Google Arts & Culture-viewer

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.

Een antwoord in het Spaans over zonnebloemen in Quickchat AI en Van Goghs Sunflowers in de Google Arts & Culture-galerij van The Met 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.

  1. 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.
  2. 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.
  1. 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 van Collection Detective en Main Prompt in de identiteitsinstellingen van Quickchat AI De naam en instructies van de agent staan in Identity. De cataloguszoekopdrachten gaan in de volgende stap naar Actions & MCPs.

  1. 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.

  1. Kies in Actions & MCPs Add Action → API Action → Create manually. Stel API Action Name in op search_met_collection en When to run op AI decides. De API Actions walkthrough toont dezelfde editor met een eenvoudiger verzoek.
  2. 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.
  3. Kies in API Endpoint GET en voer https://collectionapi.metmuseum.org/public/collection/v1.1/search in. 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 sleutelIn te voeren waarde
qVoeg de theme-parameterchip in.
hasImagestrue
limit3
offset0

De Search (v1.1)-referentie van The Met en de vier zoekparameters in de Quickchat AI Action-editor Koppel de vier rijen in Quickchat AI aan de zoekparameters van The Met. Alleen q neemt het thema van de bezoeker over. De andere drie waarden staan vast. Lees de Search (v1.1)-referentie van The Met.

  1. Voer onder Headers Accept in met waarde application/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

  1. Maak nog een API Action. Stel API Action Name in op get_met_object en When to run op AI decides. Voeg onder What to ask the user first een verplichte Number toe met de naam object_id. Beschrijf deze als “The integer Met object ID from a search result or the visitor.”
  2. 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 de object_id chip toe te voegen. Met onze eerste ID eindigt het adres op /objects/436524.
  3. Laat Query Params en Body leeg. Gebruik in Headers Accept met application/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.

De objectopzoeking in Quickchat AI met de object-ID ingevoegd aan het einde van de Met-URL 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

De Google Arts & Culture-viewer voor Sunflowers en een close-up van de handtekening “Vincent 87” linksonder 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.

Het zonnebloemzoekresultaat en de daaropvolgende opzoeking voor object 436524 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.

De veilingmeester, met in de catalogus de toeschrijving aan een volgeling van Rembrandt en de bijbehorende Spaanse tekst 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.

Quickchat AI's tekst-alleen-antwoord voor Emil Nolde naast de publiek-domeinvlag en lege afbeeldingsvelden in de gegevens van The Met 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.

De waaier van Guérard met witte katten en zonnebloemen in Wikimedia Commons naast een detail van Van Goghs schilderij 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.

Quickchat AI Quickchat AI Ask Quickchat AI a question