為大都會藝術博物館的「向日葵尋寶」活動打造博物館聊天機器人

Piotr Grudzień
發布日期 閱讀時間約 8 分鐘
在 Google Arts & Culture 檢視器中,梵谷的《Sunflowers》旁是 Quickchat AI 的 Collection Detective 功能所提供的西班牙文標籤

兩朵剪下的向日葵躺在藍色顏料上。用西班牙文詢問,你就可以得到文森·梵谷《Sunflowers》的牆上標籤,內容包含年份、媒材和原始連結。在線索中加入貓,就會找到一把法式絲質摺扇。

你將建立 Collection Detective,這是一個多語言博物館聊天機器人,它會搜尋大都會藝術博物館藏品 API,並從找到的藝術品中撰寫簡短標籤。從下面的畫作開始。最後,你將能夠追蹤 Quickchat AI 中的任何線索,並將答案與博物館自己的目錄進行核對。

Quickchat AI 用西班牙語回答關於向日葵的問題,以及大都會藝術博物館在 Google Arts & Culture 上展出的梵谷畫作《Sunflowers》 Quickchat AI 保留了原作標題《Sunflowers》,並將繪畫媒材譯為「óleo sobre lienzo」。可以對照 Google Arts & Culture 上由博物館提供的作品說明。大都會藝術博物館,Rogers Fund, 1949。查看博物館的館藏紀錄。

1. 給你的博物館聊天機器人第一個線索

訪客提供主題和語言。偵探進行兩次查詢。第一次找到候選的物件 ID。第二次開啟一個 ID 並帶回藝術家、標題、日期、媒材和來源連結。只有這樣,偵探才會撰寫標籤。

  1. 登入或建立 Quickchat AI 帳戶。使用空的 Agent 或選擇 Add new AI Agent → Set up manually。將其命名為 Collection Detective。你需要足夠的點數進行幾次測試對話。博物館查詢無需大都會藝術博物館帳戶或 API 金鑰即可運作。
  2. 開啟 Identity → AI Persona → Main Prompt。貼上以下指示,然後關閉面板。Identity 會自動儲存你的編輯。這些指示會告訴偵探如何選擇紀錄,以及在變更語言時要保留哪些細節。
複製Main Prompt給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. 在 Identity → Languages 中,新增英文和西班牙文。我們也新增了日文作為第二語言的檢查。若訊息含糊不清,系統將以第一語言作為備用。語言提示的運作方式

在 Quickchat AI 的 Identity 設定中,設定 Collection Detective 的名稱和 Main Prompt Agent 的名稱和指示位於 Identity 中。目錄查詢則在下一個步驟的 Actions & MCPs 裡。

  1. 啟用兩個 Action 後,請為 AI Preview 保留這第一則訪客訊息。訪客要求尋找向日葵並用西班牙文解釋第一件作品。

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

搜尋的語言很重要。在 2026 年 11 月 19 日,使用相同的篩選條件,博物館對 girasoles 的搜尋結果為 0 筆,而對 sunflowers 的搜尋結果為 153 筆。讓訪客用西班牙文提問,搜尋簡短的英文目錄詞彙,並告知他們你使用了哪個詞彙。

2. 如何搜尋大都會藝術博物館藏品 API?

為第一個 Action 提供一個輸入,即主題。將搜尋範圍保持在足夠小,以便訪客可以追蹤線索。三個候選作品讓你可以開啟第一個作品,並仍有另一個可供調查。

  1. 在 Actions & MCPs 中,選擇 Add Action → API Action → Create manually。將 API Action Name 設定為 search_met_collection,並將 When to run 設定為 AI decides。API Actions 逐步說明顯示了相同的編輯器,但請求更簡單。
  2. 在 What to ask the user first 下,新增一個名為 theme 的必填 Text 參數。其描述請輸入「A short English catalogue search phrase, such as sunflowers or cats and sunflowers.」。
  3. 在API Endpoint中,選擇GET並輸入https://collectionapi.metmuseum.org/public/collection/v1.1/search。在Query Params中,建立這四行。第一個值使用Add AI Data → Parameters,以便將訪客的主題插入請求中。
查詢鍵要輸入的值
q插入 theme 參數。
hasImagestrue
limit3
offset0

大都會藝術博物館的 Search (v1.1) 參考文件,以及 Quickchat AI 動作編輯器中的四個查詢參數 將 Quickchat AI 中的四列與大都會博物館的搜尋參數進行比對。只有 q 會採用訪客的主題。其他三個值則保持固定。閱讀大都會博物館的 Search (v1.1) 參考資料。

  1. 在Headers下方,輸入Accept,其值為application/json。將Body留空。將以下內容貼到API Action Description中,選擇Save changes並確認「動作」開關已開啟。
複製搜尋動作描述
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.

在瀏覽器中開啟向日葵搜尋。這是我們搜尋的完整回應。計數涵蓋所有符合的項目。列表僅包含我們請求的三個 ID,其順序可能會隨著目錄的變更而改變。

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

3. 將物件 ID 轉換為西班牙文博物館標籤

從該回應中的第一個 ID 436524 開始。第二個 Action 會直接查詢它。大都會藝術博物館對搜尋使用 v1.1,對個別物件使用 v1。如果較舊的搜尋範例回傳 HTTP 410,請更改搜尋路徑,並將物件路徑保留為 v1。大都會藝術博物館藏品 API 參考資料

  1. 建立另一個 API Action。將 API Action Name 設定為 get_met_object,並將 When to run 設定為 AI decides。在 What to ask the user first 下,新增一個名為 object_id 的必填 Number。將其描述為「The integer Met object ID from a search result or the visitor.」。
  2. 在 API Endpoint 中,選擇 GET。輸入 https://collectionapi.metmuseum.org/public/collection/v1/objects/,保留最後一個斜線,並使用 Add AI Data → Parameters 附加 object_id。使用我們的第一個 ID,網址會以 /objects/436524 結尾。
  3. 將Query Params和Body留空。在Headers中,使用Accept和application/json。將以下描述貼到API Action Description中,選擇Save changes並確認「動作」開關已開啟。
複製物件動作描述
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.

Quickchat AI 中的物件查詢,物件 ID 已插入大都會藝術博物館 URL 的末尾 在搜尋動作中,訪客的詞彙會出現在查詢行中。這裡的數字成為地址本身的一部分。

開啟 AI Preview 並傳送第一個線索。尋找原始標題《Sunflowers》、文森·梵谷、1887 年和 óleo sobre lienzo。點擊答案中的博物館連結。該頁面還將 49.41 列為其物件編號。這是博物館的登錄號。在 API 中使用 436524。款項來源中的 1949 年屬於 Rogers Fund 的收購。這幅畫本身可追溯到 1887 年。閱讀物件資料

Google Arts & Culture 中《Sunflowers》的檢視器,以及左下角「Vincent 87」簽名的特寫 用放大鏡打開畫作,在左下角找到「Vincent 87」。在藝術品頁面上,捲動到顯示「Details」之處,並將簽名與「Date Created」下方的年份進行比較。在 Google Arts & Culture 上探索大都會博物館的《Sunflowers》。

從已連接的 AI 助理設定相同的兩個 Action

如果你透過 ChatGPT 或 Claude 管理 Quickchat AI,也可以使用上述兩個配方和此設定請求。審查產生的欄位,然後自行執行第一個線索。帳戶連接說明

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. 如何檢查翻譯後的藝術品標籤?

在 Inbox 中,開啟對話並展開答案下方的 2 actions called。有關請求詳細資訊,請前往 Actions & MCPs → Custom Actions 並為每個 Action 選擇 View logs。在搜尋回應中和下一個請求的末尾找到 436524。即使另一件作品有相同的標題,匹配這些數字也能讓你將西班牙文標籤追溯到單一物件。

向日葵搜尋結果以及後續對物件 436524 的查詢 從搜尋結果中的第一個ID追蹤到物件查詢。這種交接將答案與畫作聯繫起來。

在新的對話中試試這些線索。若要在編輯提示後重複使用,請開啟Testing → Create Dataset,命名資料集並輸入問題。選擇Run Tests → Start Run,然後點擊已完成結果上的View,即可在Inbox中開啟其對話。

檢查歸屬。 詢問物件 437406 的西班牙文標籤。其紀錄將 Rembrandt 列為姓名,Follower of 列為前綴。我們的第一個回覆用西班牙文解釋了歸屬,但藝術家一行仍保留英文。我們更改了一項指示,以翻譯限定詞和媒材。下一個回覆給出了 un seguidor de Rembrandt 並保留了日期的不確定性,probablemente hacia 1658–62。閱讀《The Auctioneer》的目錄條目。

《The Auctioneer》及其圖錄歸屬於林布蘭的追隨者,以及相應的西班牙文措辭 歸屬由兩個詞組成。「Follower of」在兩種語言中都與藝術家姓名相關。大都會藝術博物館,Bequest of Benjamin Altman, 1913。

檢查圖像。 要求查看物件 480725,即第二個向日葵符合項目。埃米爾·諾爾德的《Large Sunflowers》創作於 1928 年,繪於畫板上。其紀錄有 isPublicDomain: false 和空的圖像 URL。請向訪客提供目錄連結和媒材。這個例子說明了為何單獨的 hasImages=true 無法決定顯示哪張圖像。閱讀諾爾德的紀錄。

Quickchat AI 針對埃米爾·諾爾德的純文字回覆,旁邊是大都會藝術博物館紀錄中的公有領域旗標和空的圖像欄位 即使 API 沒有提供可重複使用的照片,博物館仍可分享圖錄詳細資訊。大都會藝術博物館的 Open Access 圖像政策。

檢查空搜尋。 搜尋確切詞彙zzzxxyycollectiontest。API 返回了{"total":0,"objectIDs":null}。偵探可以要求更廣泛的線索。失敗的查詢需要不同的答案。當我們模擬 HTTP 503 時,偵探要求訪客稍後再試,並且沒有發出物件請求。

5. 追隨向日葵到絲質摺扇上

保留花朵並添加動物。給 Collection Detective 第二個線索,並詢問每位藝術家在哪種媒材上創作。你可以按原樣使用此訊息。

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

嘗試第二次搜尋。我們找到的前兩個 ID 是 705155 和 436524。大都會博物館將第一件作品歸類為繪畫。在 Wikimedia Commons 上,選擇博物館照片下方的 Open in Media Viewer。沿著扇骨尋找白貓的蹤跡,並留意向日葵之間的閃光。在 Wikimedia Commons 上檢視這把扇子。

在 Wikimedia Commons 中,蓋拉爾 (Guérard) 繪有白貓與向日葵的扇子,旁邊是梵谷畫作的局部特寫 亨利·查爾斯·蓋拉爾,《Fan Design with Cats and Sunflowers》,ca. 1885–90。大都會藝術博物館,Gift of Robert Tuggle and Paul Jeromack, 2015。探索大都會藝術博物館的扇子。

梵谷在畫布上創作。蓋拉爾在圖案絲綢上創作。 向日葵中的閃光有其材料解釋。博物館將金箔與墨水和水粉一同列出。日期保持約略,ca. 1885–90。要製作您自己的兩站式尋寶遊戲,請從第一件作品中選擇一個細節,將其添加到下一個線索中,並詢問偵探一個您可以在兩個物件頁面上驗證的差異。

博物館聊天機器人常見問題

我需要 API 金鑰才能搜尋大都會藝術博物館的藏品嗎?

大都會藝術博物館提供公共搜尋和物件端點,無需註冊或 API 金鑰。你可以在瀏覽器中開啟這兩種請求。Quickchat AI 使用帳戶點數進行聊天機器人對話。

哪個大都會藝術博物館 API 端點會傳回藝術品及其圖像?

使用 /public/collection/v1.1/search 取得候選物件 ID。將一個 ID 傳遞給 /public/collection/v1/objects/{id},以獲取標題、藝術家、日期、媒材、博物館連結以及任何可用的 Open Access 圖像 URL。

博物館聊天機器人可以用西班牙語或其他語言回答嗎?

可以。用訪客的語言提問,用簡短的英文目錄詞彙搜尋,然後翻譯解釋。保留原始標題、名稱和歸屬限定詞,以便訪客核對博物館紀錄。

我可以使用大都會藝術博物館搜尋傳回的每張圖像嗎?

請檢查個別物件紀錄。大都會藝術博物館根據 CC0 提供其 Open Access 圖像。此聊天機器人僅在 isPublicDomain 為真且存在主要圖像 URL 時提供圖像。否則,它會連結到博物館頁面。

聊天機器人能告訴我作品今天是否展出嗎?

若要參觀,請開啟目前的博物館物件頁面並檢查其展示資訊。藏品搜尋會找到已編目的作品,包括庫存中的作品。

聊天機器人能解釋藝術家的意圖嗎?

物件紀錄提供媒材和日期等目錄事實。若要解釋藝術家的意圖或作品中的符號,請使用額外來源,例如策展人關於該特定藝術品的文章。

Quickchat AI Quickchat AI Ask Quickchat AI a question