Kaksi leikattua auringonkukkaa makaa sinisellä pohjalla. Pyydä niitä espanjaksi, niin saat seinätekstin Vincent van Goghin teokselle Sunflowers varustettuna vuosiluvulla, materiaalilla ja linkillä alkuperäiseen tietueeseen. Lisää vihjeeseen kissat, ja jäljet johtavat ranskalaiseen silkkiviuhkaan.
Rakennat Collection Detective -nimisen monikielisen museon keskustelubotin, joka tekee hakuja Met Collection API -rajapinnasta ja kirjoittaa lyhyen teostiedon löytämästään taideteoksesta. Aloita alla olevasta maalauksesta. Lopuksi pystyt seuraamaan kumpaa tahansa vihjettä Quickchat AI:ssä ja tarkistamaan vastauksen museon omasta luettelosta.
Quickchat AI säilytti teoksen nimen Sunflowers ja käänsi maalaustekniikan espanjaksi muotoon ”óleo sobre lienzo”. Vertaile vastausta museon teostietoihin Google Arts & Culture-palvelussa. The Met, Rogers Fund, 1949. Avaa teoksen tiedot museon sivustolla.
1. Anna museon keskustelubotille ensimmäinen vihje
Kävijä antaa teeman ja kielen. Etsivä tekee kaksi hakua. Ensimmäinen löytää ehdolla olevien teosten tunnisteet. Toinen avaa yhden tunnisteen ja palauttaa taiteilijan, nimen, päiväyksen, tekniikan ja lähdelinkin. Vasta sitten etsivä kirjoittaa teostiedon.
- Kirjaudu sisään tai luo Quickchat AI -tili. Käytä tyhjää agenttia tai valitse Add new AI Agent → Set up manually. Nimeä se Collection Detective. Tarvitset riittävästi krediittejä muutamaan testikeskusteluun. Museohaut toimivat ilman Met-tiliä tai API-avainta.
- Avaa Identity → AI Persona → Main Prompt. Liitä alla olevat ohjeet ja sulje paneeli. Identity tallentaa muokkauksesi automaattisesti. Ne kertovat etsivälle, miten valita tietue ja mitkä tiedot säilyttää, kun kieli vaihtuu.
Kopioi Main Prompt kohteelle 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.
- Lisää Identity → Languages-kohtaan englanti ja espanja. Lisäsimme myös japanin toisen kielen tarkistusta varten. Ensimmäinen kieli on varakieli monitulkintaisille viesteille. Näin kielivihjeet toimivat
Agentin nimi ja ohjeet ovat Identity-osiossa. Luettelohaut sijoitetaan Actions & MCPs -osioon seuraavassa vaiheessa.
- Säilytä tämä ensimmäinen kävijän viesti AI Preview -esikatselua varten, kun molemmat toiminnot on otettu käyttöön. Kävijä pyytää löytämään auringonkukkia ja selittämään ensimmäisen teoksen espanjaksi.
Busca girasoles en la colección del Met y explícame la primera obra en español.
Haun kielellä on merkitystä. 19. marraskuuta 2026 museo palautti nolla osumaa hakusanalle girasoles ja 153 hakusanalle sunflowers samoilla suodattimilla. Anna kävijän kysyä espanjaksi, tee haku lyhyellä englanninkielisellä luettelointitermillä ja kerro hänelle, mitä sanaa käytit.
2. Miten haet Met Collection API -rajapinnasta?
Anna ensimmäiselle toiminnolle yksi syöte: teema. Pidä haku riittävän pienenä, jotta kävijä voi seurata jälkiä. Kolme ehdokasta antaa sinun avata ensimmäisen teoksen ja jättää vielä toisen tutkittavaksi.
- Valitse Actions & MCPs-kohdasta Add Action → API Action → Create manually. Aseta API Action Name -arvoksi
search_met_collectionja When to run -arvoksi AI decides. API-toimintojen läpikäynti näyttää saman editorin yksinkertaisemmalla pyynnöllä. - Lisää What to ask the user first -kohdan alle pakollinen Text-parametri nimeltä
theme. Kirjoita sen kuvaukseksi ”A short English catalogue search phrase, such as sunflowers or cats and sunflowers.” - Valitse API Endpoint-kohdasta GET ja syötä
https://collectionapi.metmuseum.org/public/collection/v1.1/search. Luo Query Params-kohtaan nämä neljä riviä. Käytä Add AI Data → Parameters ensimmäisen arvon kohdalla, jotta kävijän teema lisätään pyyntöön.
| Kyselyavain | Syötettävä arvo |
|---|---|
q | Lisää theme-parametrinappi. |
hasImages | true |
limit | 3 |
offset | 0 |

q saa arvokseen kävijän valitseman aiheen. Muut kolme arvoa pysyvät samoina. Lue Metin Search (v1.1) -ohje.
- Syötä Headers-kohdan alle
Acceptarvollaapplication/json. Jätä Body tyhjäksi. Liitä seuraava teksti API Action Description -kenttään, valitse Save changes ja tarkista, että toiminnon kytkin on päällä.
Kopioi haun toimintokuvaus
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.
Avaa auringonkukkahaku selaimessasi. Tässä on koko vastaus haustamme. Kokonaismäärä kattaa kaikki osumat. Luettelo sisältää vain kolme pyytämäämme tunnistetta, ja niiden järjestys voi muuttua luettelon muuttuessa.
{"total":153,"objectIDs":[436524,480725,484935]}
3. Muuta teoksen tunniste espanjankieliseksi museon teostiedoksi
Aloita tunnisteella 436524, joka on ensimmäinen tunniste kyseisessä vastauksessa. Toinen toiminto hakee sen suoraan. Met käyttää versiota v1.1 hakuihin ja v1 yksittäisiin teoksiin. Jos vanhempi hakuesimerkki palauttaa HTTP 410 -virheen, muuta hakureittiä ja jätä teosreitti versioon v1. Met Collection API -viite
- Luo toinen API Action. Aseta API Action Name -arvoksi
get_met_objectja When to run -arvoksi AI decides. Lisää What to ask the user first -kohdan alle pakollinen Number-parametri nimeltäobject_id. Kuvaa se ”The integer Met object ID from a search result or the visitor.” - Valitse API Endpoint-kohdasta GET. Syötä
https://collectionapi.metmuseum.org/public/collection/v1/objects/, jätä viimeinen kauttaviiva paikoilleen ja käytä Add AI Data → Parameters-toimintoaobject_id-napin liittämiseen. Ensimmäisellä tunnisteellamme osoite päättyy/objects/436524. - Jätä Query Params ja Body tyhjiksi. Käytä Headers-kohdassa
Acceptjaapplication/json. Liitä alla oleva kuvaus API Action Description -kenttään, valitse Save changes ja tarkista, että toiminnon kytkin on päällä.
Kopioi objektin toimintokuvaus
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.
Hakutoiminnossa kävijän sana menee kyselyriville. Tässä numero tulee osaksi itse osoitetta.
Avaa AI Preview ja lähetä ensimmäinen vihje. Etsi alkuperäinen nimi Sunflowers, Vincent van Gogh, 1887 ja óleo sobre lienzo. Seuraa vastauksessa olevaa museolinkkiä. Sivulla on myös 49.41 objektinumerona. Se on museon hankintanumero. Käytä API-rajapinnassa tunnistetta 436524. Luottotiedoissa mainittu vuosi 1949 liittyy Rogers Fund -hankintaan. Maalaus itsessään on vuodelta 1887. Lue teoksen tiedot
Avaa maalaus suurennuslasikuvakkeesta ja etsi vasemmasta alakulmasta signeeraus ”Vincent 87”. Vieritä teossivua kohtaan Details ja vertaa signeerausta kentässä Date Created näkyvään vuosilukuun. Tutki Metin Sunflowers-maalausta Google Arts & Culture -palvelussa.
Määritä samat kaksi toimintoa yhdistetystä tekoälyavustajasta
Jos hallitset Quickchat AI-toimintoa ChatGPT:n tai Clauden kautta, voit käyttää myös kahta yllä olevaa reseptiä tällä asetuspyynnöllä. Tarkista luodut kentät ja suorita sitten ensimmäinen vihje itse. Tilin yhdistämisohjeet
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. Miten tarkistat käännetyn teostiedon?
Avaa Inbox-kohdassa keskustelu ja laajenna 2 actions called vastauksen alapuolella. Pyynnön yksityiskohdat löydät kohdasta Actions & MCPs → Custom Actions valitsemalla View logs kummallekin toiminnolle. Etsi 436524 hakuvastauksesta ja seuraavan pyynnön lopusta. Näiden numeroiden täsmääminen antaa sinun jäljittää espanjankielisen teostiedon yhteen teokseen, vaikka toisella teoksella olisi sama nimi.
Seuraa ensimmäistä tunnistetta hakutuloksesta teoshakuun. Tämä siirto sitoo vastauksen maalaukseen.
Kokeile näitä vihjeitä uusissa keskusteluissa. Toistaaksesi ne kehotteen muokkauksen jälkeen, avaa Testing → Create Dataset, nimeä aineisto ja syötä kysymykset. Valitse Run Tests → Start Run, sitten View valmiista tuloksesta avataksesi sen keskustelun Inbox-näkymässä.
Tarkista attribuutio. Pyydä espanjankielinen selite kohteelle 437406. Sen tiedoissa Rembrandt on nimi ja Follower of on etuliite. Ensimmäinen vastauksemme selitti attribuution espanjaksi, mutta jätti taiteilijarivin englanniksi. Muutimme yhden ohjeen kääntämään määritteen sekä tekniikan. Seuraava vastaus antoi un seguidor de Rembrandt ja säilytti epävarmuuden päivämäärässä, probablemente hacia 1658–62. Lue huutokaupanpitäjän luettelomerkintä.
Attribuution ilmaisee kaksi sanaa. ”Follower of” kuuluu taiteilijan nimen yhteyteen molemmilla kielillä. The Met, Bequest of Benjamin Altman, 1913.
Tarkista kuva. Pyydä nähdä kohde 480725, toinen auringonkukkavastaavuus. Emil Nolden Large Sunflowers on päivätty vuodelle 1928 ja maalattu paneelille. Sen tiedoissa on isPublicDomain: false ja tyhjiä kuva-URL-osoitteita. Anna kävijälle luettelolinkki ja materiaali. Tämä esimerkki osoittaa, miksi hasImages=true yksinään ei voi päättää, mikä kuva näytetään. Lue Nolden teoksen tiedot.
Museo voi jakaa luettelotiedot silloinkin, kun API-rajapinta ei tarjoa uudelleenkäytettävää valokuvaa. Metin Open Access -kuvakäytäntö.
Tarkista tyhjä haku. Pyydä tarkkaa termiä zzzxxyycollectiontest. API palautti {"total":0,"objectIDs":null}. Etsivä voi pyytää laajempaa vihjettä. Epäonnistunut haku vaatii erilaisen vastauksen. Kun simuloimme HTTP 503 -virheen, etsivä pyysi kävijää yrittämään uudelleen myöhemmin eikä tehnyt teospyyntöä.
5. Seuraa auringonkukkia silkkiviuhkaan
Pidä kukat ja lisää eläin. Anna Collection Detectivelle toinen vihje ja kysy, mille pinnalle kukin taiteilija työskenteli. Voit käyttää tätä viestiä sellaisenaan.
Busca «cats and sunflowers» y compara el soporte de la primera obra con el de Sunflowers (436524).
Kokeile toista hakua. Haun kaksi ensimmäistä tunnistetta olivat 705155 ja 436524. Met on luetteloinut ensimmäisen teoksen piirustukseksi. Valitse Wikimedia Commons -palvelussa museon valokuvan alta Open in Media Viewer. Seuraa valkoisia kissoja viuhkan ruoteita pitkin ja etsi auringonkukkien välistä kimalteleva kohta. Tutki viuhkaa Wikimedia Commons -palvelussa.
Henri Charles Guérard, Fan Design with Cats and Sunflowers, ca. 1885–90. Met, Gift of Robert Tuggle and Paul Jeromack, 2015. Tutustu viuhkaan Metissä.
Van Gogh työskenteli kankaalle. Guérard työskenteli kuvioidulle silkille. Auringonkukkien joukossa oleva kiilto selittyy materiaalilla. Museo luettelee lehtikullan musteen ja guassin rinnalla. Päivämäärä pysyy likimääräisenä, ca. 1885–90. Luodaksesi oman kaksivaiheisen etsinnän, valitse yksityiskohta ensimmäisestä teoksesta, lisää se seuraavaan vihjeeseen ja kysy etsivältä yksi ero, jonka voit tarkistaa molemmilta esinesivuilta.
Museon keskustelubotti – UKK
Tarvitsenko API-avaimen Metin kokoelman selaamiseen?
Metropolitan Museum of Art tarjoaa julkiset haku- ja teospäätepisteet ilman rekisteröitymistä tai API-avainta. Voit avata molemmat pyynnöt selaimessa. Quickchat AI käyttää tilin krediittejä keskustelubotin kanssa käytävään keskusteluun.
Mikä Metin API-päätepiste palauttaa taideteoksen ja sen kuvan?
Käytä päätepistettä /public/collection/v1.1/search saadaksesi ehdokasteosten tunnisteet. Välitä yksi tunniste päätepisteelle /public/collection/v1/objects/{id} saadaksesi teoksen nimen, taiteilijan, päiväyksen, tekniikan, museolinkin ja kaikki saatavilla olevat Open Access -kuvien URL-osoitteet.
Voiko museon keskustelubotti vastata espanjaksi tai muulla kielellä?
Kyllä. Esitä kysymys kävijän kielellä, tee haku lyhyellä englanninkielisellä luettelointitermillä ja käännä selitys. Säilytä alkuperäinen nimi, tekijänimet ja attribuutiot, jotta kävijä voi tarkistaa museon tiedot.
Voinko käyttää uudelleen jokaista Met-haun palauttamaa kuvaa?
Tarkista yksittäisen teoksen tiedot. Met asettaa Open Access -kuvansa saataville CC0-lisenssillä. Tämä keskustelubotti tarjoaa kuvan vain, jos isPublicDomain on true ja ensisijainen kuvan URL-osoite on olemassa. Muussa tapauksessa se linkittää museon sivulle.
Voiko keskustelubotti kertoa, onko teos tänään esillä?
Vierailua varten avaa kyseisen teoksen sivu museon verkkosivustolla ja tarkista sen esilläolotiedot. Kokoelmahaku löytää luetteloituja teoksia, myös varastossa olevia.
Voiko keskustelubotti selittää taiteilijan tarkoitusta?
Teostiedot antavat luettelofaktoja, kuten tekniikan ja päiväyksen. Selittääksesi taiteilijan aikomuksia tai teoksen symboliikkaa käytä lisälähdettä, kuten kuraattorin esseetä kyseisestä taideteoksesta.