Zbuduj muzealnego chatbota do poszukiwania słoneczników w The Met

Piotr Grudzień
Opublikowano 7 min czytania
Hiszpańska etykieta z Collection Detective w Quickchat AI obok Sunflowers Van Gogha w przeglądarce Google Arts & Culture

Dwa ścięte słoneczniki leżą na tle niebieskiej farby. Poproś o nie po hiszpańsku, a otrzymasz etykietę ścienną dla Sunflowers Vincenta van Gogha, wraz z rokiem, materiałem i linkiem do oryginału. Dodaj koty do wskazówki, a ślad prowadzi do francuskiego jedwabnego wachlarza.

Zbudujesz Collection Detective, wielojęzycznego chatbota muzealnego, który przeszukuje API kolekcji The Met i tworzy krótką etykietę na podstawie znalezionego dzieła sztuki. Zacznij od poniższego obrazu. Na koniec będziesz w stanie podążać za dowolną wskazówką w Quickchat AI i sprawdzić odpowiedź w katalogu muzeum.

Hiszpańska odpowiedź na temat słoneczników w Quickchat AI i obraz „Sunflowers” Van Gogha w galerii The Met w Google Arts & Culture Quickchat AI zachował tytuł „Sunflowers” i przetłumaczył technikę na „óleo sobre lienzo”. Porównaj odpowiedź z etykietą muzealną w Google Arts & Culture. The Met, Rogers Fund, 1949. Otwórz rekord muzeum.

1. Daj swojemu chatbotowi muzealnemu pierwszą wskazówkę

Odwiedzający podaje temat i język. Detektyw wykonuje dwa wyszukiwania. Pierwsze znajduje kandydujące identyfikatory obiektów. Drugie otwiera jeden identyfikator i zwraca artystę, tytuł, datę, medium i link do źródła. Dopiero wtedy detektyw pisze etykietę.

  1. Zaloguj się lub utwórz konto Quickchat AI. Użyj pustego Agenta lub wybierz Add new AI Agent → Set up manually. Nazwij go Collection Detective. Będziesz potrzebować wystarczającej liczby kredytów na kilka rozmów testowych. Wyszukiwania muzealne działają bez konta Met lub klucza API.
  2. Otwórz Identity → AI Persona → Main Prompt. Wklej poniższe instrukcje, a następnie zamknij panel. Tożsamość automatycznie zapisuje Twoje zmiany. Informują one detektywa, jak wybrać rekord i które szczegóły zachować, gdy zmienia się język.
Skopiuj Main Prompt dla 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. W Identity → Languages dodaj angielski i hiszpański. Dodaliśmy również japoński do dodatkowej weryfikacji. Pierwszy język jest językiem domyślnym w przypadku niejednoznacznych komunikatów. Jak działają podpowiedzi językowe

nazwa Collection Detective i Main Prompt w ustawieniach tożsamości Quickchat AI Nazwa i instrukcje Agenta znajdują się w sekcji Identity. Wyszukiwania katalogowe należy umieścić w Actions & MCPs w następnym kroku.

  1. Zachowaj tę pierwszą wiadomość od odwiedzającego dla AI Preview, gdy obie akcje zostaną włączone. Odwiedzający prosi o znalezienie słoneczników i wyjaśnienie pierwszego dzieła po hiszpańsku.

Busca girasoles en la colección del Met y explícame la primera obra en español.

Język wyszukiwania ma znaczenie. 19 listopada 2026 roku muzeum zwróciło zero wyników dla girasoles i 153 dla sunflowers przy tych samych filtrach. Pozwól odwiedzającemu zapytać po hiszpańsku, wyszukaj za pomocą krótkiego angielskiego terminu katalogowego i poinformuj go, którego słowa użyłeś.

2. Jak przeszukujesz API kolekcji The Met?

Nadaj pierwszej akcji jedno wejście: temat. Utrzymaj wyszukiwanie na tyle zawężone, aby odwiedzający mógł podążać tropem. Trzech kandydatów pozwala otworzyć pierwsze dzieło i wciąż mieć kolejne do zbadania.

  1. W Actions & MCPs wybierz Add Action → API Action → Create manually. Ustaw API Action Name na search_met_collection, a When to run na AI decides. Przewodnik po akcjach API pokazuje ten sam edytor z prostszym zapytaniem.
  2. W What to ask the user first dodaj wymagany parametr Text o nazwie theme. W jego opisie wpisz „A short English catalogue search phrase, such as sunflowers or cats and sunflowers.”
  3. W API Endpoint wybierz GET i wprowadź https://collectionapi.metmuseum.org/public/collection/v1.1/search. W Query Params utwórz te cztery wiersze. Użyj Add AI Data → Parameters dla pierwszej wartości, aby temat odwiedzającego został wstawiony do zapytania.
Klucz zapytaniaWartość do wprowadzenia
qWstaw znacznik parametru theme.
hasImagestrue
limit3
offset0

Odwołanie Search (v1.1) z The Met i cztery parametry zapytania w edytorze akcji Quickchat AI Dopasuj cztery wiersze w Quickchat AI do parametrów wyszukiwania The Met. Tylko q przyjmuje temat podany przez odwiedzającego. Pozostałe trzy wartości pozostają stałe. Przeczytaj odnośnik Search (v1.1) z The Met.

  1. W Headers wprowadź Accept z wartością application/json. Pozostaw Body puste. Wklej poniższe do API Action Description, wybierz Save changes i sprawdź, czy przełącznik akcji jest włączony.
Skopiuj opis akcji wyszukiwania
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.

Otwórz wyszukiwanie słoneczników w przeglądarce. Oto cała odpowiedź z naszego wyszukiwania. Liczba obejmuje każde dopasowanie. Lista zawiera tylko trzy żądane identyfikatory, a ich kolejność może się zmieniać wraz ze zmianami w katalogu.

{"total":153,"objectIDs":[436524,480725,484935]}

3. Przekształć ID obiektu w hiszpańską etykietę muzealną

Zacznij od 436524, pierwszego ID w tej odpowiedzi. Druga akcja wyszukuje go bezpośrednio. The Met używa v1.1 do wyszukiwania i v1 dla pojedynczych obiektów. Jeśli starszy przykład wyszukiwania zwraca błąd HTTP 410, zmień ścieżkę wyszukiwania, pozostawiając ścieżkę obiektu w wersji v1. Dokumentacja The Met Collection API

  1. Utwórz kolejną API Action. Ustaw API Action Name na get_met_object, a When to run na AI decides. W What to ask the user first dodaj wymagany Number o nazwie object_id. Opisz go jako „The integer Met object ID from a search result or the visitor.”
  2. W API Endpoint wybierz GET. Wprowadź https://collectionapi.metmuseum.org/public/collection/v1/objects/, pozostaw końcowy ukośnik i użyj Add AI Data → Parameters, aby dołączyć znacznik object_id. Z naszym pierwszym identyfikatorem adres kończy się na /objects/436524.
  3. Pozostaw Query Params i Body puste. W Headers użyj Accept z application/json. Wklej poniższy opis do API Action Description, wybierz Save changes i sprawdź, czy przełącznik akcji jest włączony.
Skopiuj opis akcji obiektu
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.

Wyszukiwanie obiektu w Quickchat AI z identyfikatorem obiektu wstawionym na końcu adresu URL Met W akcji wyszukiwania słowo odwiedzającego trafia do wiersza zapytania. Tutaj numer staje się częścią samego adresu.

Otwórz AI Preview i wyślij pierwszą wskazówkę. Poszukaj oryginalnego tytułu Sunflowers, Vincent van Gogh, 1887 i óleo sobre lienzo. Wejdź w link do muzeum podany w odpowiedzi. Strona wymienia również 49.41 jako numer obiektu. Jest to numer inwentarzowy muzeum. W API użyj 436524. Rok 1949 w nocie o pochodzeniu odnosi się do nabycia przez Rogers Fund. Sam obraz datowany jest na 1887 rok. Przeczytaj dane obiektu

Przeglądarka Google Arts & Culture dla Sunflowers i zbliżenie podpisu „Vincent 87” w lewym dolnym rogu Otwórz obraz za pomocą lupy i znajdź „Vincent 87” w lewym dolnym rogu. Na stronie dzieła przewiń do sekcji Details i porównaj podpis z rokiem pod Date Created. Przeglądaj Sunflowers z The Met w Google Arts & Culture.

Skonfiguruj te same dwie akcje z podłączonego asystenta AI

Jeśli zarządzasz Quickchat AI za pośrednictwem ChatGPT lub Claude, możesz również użyć powyższych dwóch przepisów z tym żądaniem konfiguracji. Przejrzyj wygenerowane pola, a następnie samodzielnie uruchom pierwszą wskazówkę. Instrukcje połączenia konta

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. Jak sprawdzić przetłumaczoną etykietę dzieła sztuki?

W Inbox otwórz rozmowę i rozwiń 2 actions called pod odpowiedzią. Aby uzyskać szczegóły żądania, przejdź do Actions & MCPs → Custom Actions i wybierz View logs dla każdej akcji. Znajdź 436524 w odpowiedzi wyszukiwania i na końcu następnego żądania. Dopasowanie tych numerów pozwala prześledzić hiszpańską etykietę z powrotem do jednego obiektu, nawet jeśli inne dzieło ma ten sam tytuł.

Wynik wyszukiwania słoneczników i późniejsze wyszukiwanie obiektu 436524 Podążaj za pierwszym identyfikatorem z wyniku wyszukiwania do wyszukiwania obiektu. To przekazanie łączy odpowiedź z obrazem.

Wypróbuj te wskazówki w nowych rozmowach. Aby powtórzyć je po edycji monitu, otwórz Testing → Create Dataset, nazwij zbiór danych i wprowadź pytania. Wybierz Run Tests → Start Run, a następnie View dla ukończonego wyniku, aby otworzyć jego rozmowę w Inbox.

Sprawdź atrybucję. Poproś o hiszpańską etykietę dla obiektu 437406. W jego zapisie Rembrandt to nazwisko, a Follower of to prefiks. Nasza pierwsza odpowiedź wyjaśniła atrybucję po hiszpańsku, ale pozostawiła linię artysty w języku angielskim. Zmieniliśmy jedną instrukcję, aby przetłumaczyć zarówno kwalifikator, jak i medium. Następna odpowiedź podała un seguidor de Rembrandt i zachowała niepewność co do daty, probablemente hacia 1658–62. Przeczytaj opis katalogowy The Auctioneer’s.

Obraz „Aukcjoner”, którego katalog przypisuje autorstwo naśladowcy Rembrandta, oraz odpowiadający mu tekst w języku hiszpańskim Dwa słowa niosą atrybucję. „Follower of” należy do nazwiska artysty w obu językach. The Met, Bequest of Benjamin Altman, 1913.

Sprawdź obraz. Poproś o obiekt 480725, drugie dopasowanie słonecznika. Large Sunflowers Emila Noldego datowany jest na 1928 rok i namalowany na desce. Jego zapis zawiera isPublicDomain: false i puste adresy URL obrazów. Podaj odwiedzającemu link do katalogu i materiał. Ten przykład pokazuje, dlaczego samo hasImages=true nie może zdecydować, który obraz pokazać. Przeczytaj zapis Noldego.

Odpowiedź tekstowa Quickchat AI dla Emila Noldego obok flagi domeny publicznej i pustych pól obrazu w rekordzie The Met Muzeum może udostępnić szczegóły katalogowe, nawet jeśli API nie dostarcza zdjęcia do ponownego wykorzystania. Polityka The Met dotycząca obrazów w domenie publicznej (Open Access).

Sprawdź puste wyszukiwanie. Poproś o dokładny termin zzzxxyycollectiontest. API zwróciło {"total":0,"objectIDs":null}. Detektyw może poprosić o szerszą wskazówkę. Nieudane wyszukiwanie wymaga innej odpowiedzi. Kiedy zasymulowaliśmy HTTP 503, detektyw poprosił odwiedzającego o ponowną próbę później i nie złożył żadnego żądania obiektu.

5. Podążaj za słonecznikami na jedwabny wachlarz

Zachowaj kwiaty i dodaj zwierzę. Daj Collection Detective drugą wskazówkę i zapytaj, na jakiej powierzchni pracował każdy artysta. Możesz użyć tej wiadomości w niezmienionej formie.

Busca «cats and sunflowers» y compara el soporte de la primera obra con el de Sunflowers (436524).

Wypróbuj drugie wyszukiwanie. Nasze pierwsze dwa identyfikatory to 705155 i 436524. The Met kataloguje pierwsze dzieło jako rysunek. Na Wikimedia Commons wybierz Open in Media Viewer pod zdjęciem z muzeum. Podążaj za białymi kotami wzdłuż żeber wachlarza i szukaj błysku między słonecznikami. Obejrzyj wachlarz na Wikimedia Commons.

Wachlarz Guérarda z białymi kotami i słonecznikami w Wikimedia Commons obok detalu obrazu Van Gogha Henri Charles Guérard, Fan Design with Cats and Sunflowers, ca. 1885–90. The Met, Gift of Robert Tuggle and Paul Jeromack, 2015. Odkryj wachlarz w The Met.

Van Gogh malował na płótnie. Guérard pracował na wzorzystym jedwabiu. Połysk wśród słoneczników ma swoje materialne wyjaśnienie. Muzeum obok tuszu i gwaszu wymienia płatki złota. Data pozostaje przybliżona, ca. 1885–90. Aby stworzyć własne dwuetapowe polowanie, wybierz detal z pierwszego dzieła, dodaj go do następnej wskazówki i zapytaj detektywa o jedną różnicę, którą możesz zweryfikować na obu stronach obiektów.

Często zadawane pytania dotyczące chatbota muzealnego

Czy potrzebuję klucza API, aby przeszukiwać kolekcję The Met?

The Metropolitan Museum of Art udostępnia publiczne punkty końcowe wyszukiwania i obiektów bez rejestracji lub klucza API. Możesz otworzyć oba żądania w przeglądarce. Quickchat AI wykorzystuje środki z konta na rozmowę z chatbotem.

Który punkt końcowy API Met zwraca dzieło sztuki i jego obraz?

Użyj ścieżki /public/collection/v1.1/search, aby uzyskać identyfikatory obiektów-kandydatów. Przekaż jeden identyfikator do ścieżki /public/collection/v1/objects/{id}, aby uzyskać tytuł, artystę, datę, medium, link do muzeum i wszelkie dostępne adresy URL obrazów w domenie publicznej (Open Access).

Czy chatbot muzealny może odpowiadać po hiszpańsku lub w innym języku?

Tak. Zadaj pytanie w języku odwiedzającego, wyszukaj za pomocą krótkiego angielskiego terminu katalogowego i przetłumacz wyjaśnienie. Zachowaj oryginalny tytuł, nazwiska i kwalifikatory atrybucji, aby odwiedzający mógł sprawdzić zapis muzealny.

Czy mogę ponownie wykorzystać każdy obraz zwrócony przez wyszukiwanie Met?

Sprawdź rekord konkretnego obiektu. The Met udostępnia swoje obrazy w domenie publicznej (Open Access) na licencji CC0. Ten chatbot oferuje obraz tylko wtedy, gdy isPublicDomain ma wartość true i dostępny jest główny adres URL obrazu. W przeciwnym razie linkuje do strony muzeum.

Czy chatbot może mi powiedzieć, czy dzieło jest dziś wystawione?

Aby zaplanować wizytę, otwórz stronę obiektu w witrynie muzeum i sprawdź informacje o jego ekspozycji. Wyszukiwanie w kolekcji obejmuje skatalogowane dzieła, w tym te znajdujące się w magazynie.

Czy chatbot może wyjaśnić, co zamierzał artysta?

Rekord obiektu zawiera fakty katalogowe, takie jak medium i data. Aby wyjaśnić intencje artysty lub symbol w dziele, użyj dodatkowego źródła, takiego jak esej kuratora o tym konkretnym dziele sztuki.

Quickchat AI Quickchat AI Ask Quickchat AI a question