切り取ったひまわりの花が二つ、青い絵の具を背景に横たわっています。スペイン語で尋ねてみると、フィンセント・ファン・ゴッホの《Sunflowers》について、制作年と技法に美術館の作品ページを添えた短い解説が返ってきます。次の手がかりに猫を加えると、フランスの絹の扇にたどり着きます。
ここでは多言語の美術館チャットボット、Collection Detectiveを作ります。メトロポリタン美術館のAPIを検索し、見つけた作品の記録をもとに短い解説を書くチャットボットです。出発点は下の絵です。完成したら、Quickchat AIで二つの手がかりを試し、美術館の記録と回答を照らし合わせてみましょう。
Quickchat AIは作品名を《Sunflowers》のまま残し、技法をスペイン語で「óleo sobre lienzo」と表現しました。Google Arts & Cultureに掲載されている美術館の作品情報と見比べてみましょう。メトロポリタン美術館、Rogers Fund, 1949。美術館の作品ページを開く。
1. 美術館チャットボットに最初の手がかりを渡す
利用者がテーマと言語を指定すると、チャットボットは2回の問い合わせを行います。最初に検索して、候補となる作品IDを取得します。そのうちの1件を使って作者名、作品名、制作年代、技法・素材、出典のリンクを取得してから、作品解説を書きます。
- Quickchat AIにログインするか、アカウントを作成します。未設定のエージェントを使うか、Add new AI Agent → Set up manuallyを選びます。名前はCollection Detectiveにします。会話を数回試せるだけのクレジットを用意してください。所蔵品の検索には美術館のアカウントもAPIキーも不要です。
- Identity → AI Persona → Main Promptを開き、以下の指示を貼り付けてパネルを閉じます。Identityの変更は自動で保存されます。どの作品の記録を開くか、別の言語で解説するときに何を残すかを指定する指示です。
Collection DetectiveのMain Promptをコピーする
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.
- Identity → Languagesで英語とスペイン語を追加します。今回は別の言語でも試すため、日本語も追加しました。メッセージだけでは言語を判定できない場合は、リストの先頭の言語が使われます。応答言語の選び方
エージェントの名前と指示はIdentityで設定します。次のステップでは、Actions & MCPsにコレクション検索の設定を追加します。
- 二つのアクションが有効になったら、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を検索する
最初のアクションに渡すのはテーマだけです。検索結果を3件に絞れば、利用者は最初の作品を開いた後で別の候補も調べられます。
- Actions & MCPsでAdd Action → API Action → Create manuallyを選びます。API Action Nameには
search_met_collectionを入力し、When to runではAI decidesを選びます。APIアクションの設定ガイドでは、同じ画面でより簡単なリクエストを設定する例を紹介しています。 - What to ask the user firstで、
themeという名前の必須パラメーターを追加し、型をTextにします。説明欄には「A short English catalogue search phrase, such as sunflowers or cats and sunflowers.」と入力します。 - API EndpointでGETを選び、
https://collectionapi.metmuseum.org/public/collection/v1.1/searchを入力します。Query Paramsに下の4行を追加します。最初の行の値はAdd AI Data → Parametersから選びます。これで利用者のテーマがリクエストに入ります。
| クエリのキー | 入力する値 |
|---|---|
q | メニューからパラメーターthemeを挿入します。 |
hasImages | true |
limit | 3 |
offset | 0 |

qのみが来館者のテーマを受け取ります。他の3つの値は固定されたままです。メトロポリタン美術館のSearch (v1.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.
ブラウザでひまわりの検索結果を開きます。以下が取得した応答の全文です。合計は条件に合う作品すべての件数ですが、一覧には指定どおり3件のIDだけが返ります。順序はカタログの更新によって変わることがあります。
{"total":153,"objectIDs":[436524,480725,484935]}
3. 作品IDからスペイン語の作品解説を作る
最初の検索結果に含まれるID、436524を使います。二つ目のアクションでは、このIDで作品の記録を直接取得します。美術館のAPIは検索にはv1.1、個別の作品にはv1を使います。古い検索例でHTTP 410が返ったら、検索のURLを更新し、個別の作品用のURLはv1のままにしてください。メトロポリタン美術館のコレクションAPI仕様
- もう一つAPI Actionを作成します。API Action Nameには
get_met_objectを入力し、When to runではAI decidesを選びます。What to ask the user firstで、型がNumberの必須パラメーターobject_idを追加します。説明欄には「The integer Met object ID from a search result or the visitor.」と入力します。 - API EndpointでGETを選びます。
https://collectionapi.metmuseum.org/public/collection/v1/objects/を入力し、末尾のスラッシュを残します。そのすぐ後ろにAdd AI Data → Parametersからobject_idを挿入します。最初の作品IDを使うと、URLの末尾は/objects/436524になります。 - 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.
最初のアクションでは、利用者の検索語をクエリパラメーターに入れます。こちらのアクションでは、作品の番号がURLの一部になります。
AI Previewを開き、最初の手がかりを送ります。回答に原題の《Sunflowers》、Vincent van Gogh、1887、óleo sobre lienzoがあるか確認してください。回答から美術館のページを開くと、Object Numberの欄に49.41とあります。これは美術館の収蔵番号です。APIには436524を使います。クレジット欄の1949年はロジャーズ基金による取得年で、絵の制作年は1887年です。作品データを確認する
虫眼鏡で絵画を開き、左下隅にある「Vincent 87」を見つけてください。作品ページでDetailsまでスクロールし、署名をDate Createdの下の年と比較してください。Google Arts & Cultureでメトロポリタン美術館のSunflowersを探索する。
接続済みのAIアシスタントから二つのアクションを設定する
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でそれぞれのアクションのView logsを選びます。最初の検索結果にある436524が、次のリクエストのURL末尾と一致するか確認してください。同じ題名の作品が複数あっても、この番号をたどればスペイン語の解説がどの作品に基づくかが分かります。
検索結果の最初のIDが次の作品データの取得に使われています。この番号をたどると、回答の根拠になった絵を特定できます。
新しい会話で以下の手がかりを試します。プロンプトを直した後に同じ質問でテストするには、Testing → Create Datasetを開き、データセットに名前を付けて質問を入力します。Run Tests → Start Runを選び、完了したテスト結果でViewを選ぶと、Inboxでその会話を開けます。
作者の表記を確かめる。 作品ID 437406の解説をスペイン語で頼みます。記録には作者名にRembrandt、その前に付く注記にFollower ofとあります。最初の回答では、その意味はスペイン語で説明できていましたが、作者欄の表記は英語のままでした。そこで、技法と同様に作者の注記も訳すよう指示を一つ変更しました。次の回答ではun seguidor de Rembrandtと表記され、年代もprobablemente hacia 1658–62と幅を残していました。《競売人》の作品ページを読む。
英語の「Follower of」という2語で、作者とレンブラントの関係が分かります。スペイン語の解説にもこの情報を残します。メトロポリタン美術館、Bequest of Benjamin Altman, 1913。
画像の扱いを確かめる。 ひまわりの検索で2番目に見つかった作品ID 480725を見せてほしいと頼みます。エミール・ノルデの《Large Sunflowers》は1928年に板に描かれた作品です。記録ではisPublicDomain: falseで、画像URLの欄は空です。利用者には作品ページへのリンクと技法・素材を案内します。hasImages=trueだけでは画像を表示してよいかを判断できない例です。ノルデの作品情報を確認する。
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).
2回目の検索を試してください。最初の2つのIDは705155と436524でした。メトロポリタン美術館は最初の作品を素描として分類しています。Wikimedia Commonsで、美術館の写真の下にあるOpen in Media Viewerを選択してください。扇の骨に沿って白い猫たちをたどり、ひまわりの間のきらめきを探してください。Wikimedia Commonsで扇を調べる。
アンリ・シャルル・ゲラール、Fan Design with Cats and Sunflowers、ca. 1885–90。メトロポリタン美術館、Gift of Robert Tuggle and Paul Jeromack, 2015。美術館の作品ページで扇の図案を見る。
ゴッホはキャンバスに、ゲラールは模様のある絹に描きました。 ひまわりの間に見える輝きの手がかりも、作品データにあります。素材の欄にはインクやグワッシュと並んで金箔が挙がっています。制作年代のca. 1885–90には「頃」という幅を残します。自分で二つの作品を結びつけるなら、一点目の気になる部分を次の手がかりに加えましょう。両方の作品ページで確かめられる違いを一つ、探偵役に尋ねてみてください。
美術館チャットボットについてよくある質問
メトロポリタン美術館の所蔵品を検索するのにAPIキーは必要ですか?
所蔵品の検索と個別の作品情報の取得には、美術館が公開しているAPIを使えます。どちらも登録やAPIキーは不要で、ブラウザから開けます。チャットボットとの会話にはQuickchat AIのアカウントのクレジットを使います。
作品情報や画像はどのエンドポイントで取得できますか?
/public/collection/v1.1/searchで候補の作品IDを取得します。そのうちの1件を/public/collection/v1/objects/{id}に渡すと、作品名、作者、制作年代、技法・素材、美術館の作品ページのURLが返ります。Open Accessの画像がある場合は、そのURLも取得できます。
美術館チャットボットはスペイン語や他の言語で回答できますか?
はい。利用者は自分の言語で質問できます。チャットボットは短い英語の検索語で作品を探してから、利用者の言語で解説します。原題、作者名、作者の特定に関わる注記を残すと、美術館の記録と照合できます。
検索で見つかった作品の画像は、どれも再利用できますか?
作品ごとに記録を確認してください。メトロポリタン美術館はOpen Accessの画像をCC0で公開しています。このチャットボットでは、isPublicDomainが真で、かつ作品の代表画像のURLがある場合に画像を案内します。それ以外の場合は美術館の作品ページを紹介します。
作品が今日展示されているかどうかも分かりますか?
来館前に、美術館の作品ページで現在の展示状況を確認してください。コレクションの検索結果には、収蔵庫に保管されている作品も含まれます。
作者の制作意図も説明できますか?
作品データから分かるのは、技法・素材や制作年代などです。作者の意図や描かれたモチーフの意味を説明するには、その作品について学芸員が書いた解説など、別の資料が必要です。