两朵剪下的向日葵躺在蓝色颜料的底子上。用西班牙语询问它们,你就能得到文森特·梵高《Sunflowers》的展墙标签,包括年份、材质和原始链接。在线索中加入猫,线索就会指向一把法国丝绸折扇。
你将构建 Collection Detective,一个多语言博物馆聊天机器人,它能搜索大都会艺术博物馆藏品 API,并根据找到的艺术品撰写简短的标签。从下面的画作开始。最终,你将能够追踪 Quickchat AI 中的任何线索,并根据博物馆自己的目录核对答案。
Quickchat AI 保留了原作标题《Sunflowers》,把绘画媒材译成了“óleo sobre lienzo”。可以对照 Google Arts & Culture 上博物馆提供的作品说明。大都会艺术博物馆,Rogers Fund, 1949。查看博物馆的藏品记录。
1. 给出你的博物馆聊天机器人第一条线索
参观者提供主题和语言。“侦探”进行两次查找。第一次查找候选作品 ID。第二次打开一个 ID 并带回艺术家、标题、日期、媒材和来源链接。只有这样,“侦探”才会撰写标签。
- 登录或创建 Quickchat AI 账户。使用空 Agent 或选择 Add new AI Agent → Set up manually。将其命名为 Collection Detective。你需要足够的积分进行几次测试对话。博物馆查找无需大都会艺术博物馆账户或 API 密钥即可工作。
- 打开 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.
- 在 Identity → Languages 中,请添加英语和西班牙语。我们还添加了日语作为第二语言验证。当消息含义模糊时,将默认使用第一语言。语言提示的工作原理
Agent 的名称和指令在 Identity 中。目录查询在下一步的 Actions & MCPs 中进行。
- 启用这两个 Action 后,请保留这条发给 AI Preview 的访客消息。访客正在询问如何找到向日葵,并要求用西班牙语解释第一件作品。
Busca girasoles en la colección del Met y explícame la primera obra en español.
搜索语言很重要。2026 年 11 月 19 日,使用相同的过滤器,博物馆对 girasoles 返回零个匹配项,而对 sunflowers 返回 153 个匹配项。让访客用西班牙语提问,搜索简短的英语目录术语,并告诉他们你使用了哪个词。
2. 如何搜索大都会艺术博物馆藏品 API?
给第一个 Action 一个输入,即主题。将搜索范围保持在访客可以追踪的程度。三个候选作品可以让你打开第一件作品,并且还有另一件可以调查。
- 在 Actions & MCPs 中,选择 Add Action → API Action → Create manually。将 API Action Name 设置为
search_met_collection,并将 When to run 设置为 AI decides。API Action 指南展示了同一编辑器,其中请求示例更为简单。 - 在 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中,创建以下四行。第一个值使用Add AI Data → Parameters,以便将访客的主题插入到请求中。
| 查询键 | 要输入的值 |
|---|---|
q | 插入 theme 参数。 |
hasImages | true |
limit | 3 |
offset | 0 |

q采用访问者提供的主题。其他三个值保持不变。阅读The Met的Search (v1.1)参考资料。
- 在 Headers 下,输入
Accept,值为application/json。将 Body 留空。将以下内容粘贴到 API Action Description 中,选择 Save changes 并检查 Action 的开关是否打开。
复制搜索 Action 描述
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转换为西班牙语博物馆标签
从 436524 开始,这是该响应中的第一个 ID。第二个 Action 会直接查询该 ID。大都会艺术博物馆使用v1.1 进行搜索,并使用v1 查询单件藏品。如果较旧的搜索示例返回 HTTP 410 状态码,请更改搜索路径,并将藏品路径保留为 v1。大都会艺术博物馆藏品 API 参考文档
- 创建另一个 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.” - 在 API Endpoint 中,选择 GET。输入
https://collectionapi.metmuseum.org/public/collection/v1/objects/,保留末尾的斜杠,并使用 Add AI Data → Parameters 附加object_id。对于我们的第一个 ID,地址以/objects/436524结尾。 - 将 Query Params 和 Body 留空。在 Headers 中,使用
Accept和application/json。将以下描述粘贴到 API Action Description 中,选择 Save changes 并检查 Action 的开关是否打开。
复制作品 Action 描述
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.
在搜索 Action 中,访客的词语会出现在查询行中。这里,数字本身成为地址的一部分。
打开 AI Preview 并发送第一条线索。查找原作标题 Sunflowers、文森特·梵高、1887 以及 óleo sobre lienzo。点击答案中的博物馆链接。该页面还列出了 49.41 作为其藏品编号。这是博物馆的入藏编号。在 API 中使用 436524。署名栏中的 1949 年指的是罗杰斯基金 (Rogers Fund) 的收购年份。这幅画本身创作于 1887 年。阅读藏品数据
用放大镜打开画作,在左下角找到“Vincent 87”。在作品页面上,滚动到“Details”,并将签名与“Date Created”下的年份进行比较。在Google Arts & Culture上探索The Met的《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。匹配这些数字可以将西班牙语标签追溯到一件作品,即使另一件作品具有相同的标题。
从搜索结果中的第一个ID追踪到作品查找。这种交接将答案与画作联系起来。
在新的对话中尝试这些线索。编辑提示后若要重复,请打开Testing → Create Dataset,命名数据集并输入问题。选择Run Tests → Start Run,然后在完成的结果上点击View,即可在Inbox中打开其对话。
核实归属。请求藏品 437406 的西班牙语标签。其记录显示名称为 Rembrandt,前缀为 Follower of。我们的首次回复用西班牙语解释了归属,但艺术家一行仍为英语。我们更改了一条指令,要求翻译限定词和媒材。下一次回复给出了 un seguidor de Rembrandt,并保留了日期中的不确定性,probablemente hacia 1658–62。阅读《拍卖师》的目录条目。
两个词语承载着归属。“Follower of”在两种语言中都与艺术家的名字相伴。大都会艺术博物馆,Bequest of Benjamin Altman, 1913。
检查图像。 请求查看藏品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).
尝试第二次搜索。我们的前两个ID是705155和436524。The Met将第一件作品归类为素描。在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密钥。你可以在浏览器中打开这两个请求。Quickchat AI使用账户积分进行聊天机器人对话。
哪个大都会艺术博物馆 API 端点会返回艺术品及其图像?
使用 /public/collection/v1.1/search 获取候选作品 ID。将一个 ID 传递给 /public/collection/v1/objects/{id},以获取作品标题、艺术家、创作日期、媒材、博物馆链接以及任何可用的“开放取用”(Open Access) 图像 URL。
博物馆聊天机器人可以用西班牙语或其他语言回答吗?
可以。用参观者的语言提问,用简短的英文目录词条搜索,然后翻译解释。保留原始标题、名称和归属限定词,以便参观者核对博物馆记录。
我能重复使用大都会艺术博物馆搜索返回的每张图片吗?
请查看单件作品记录。大都会艺术博物馆根据 CC0 许可协议提供其“开放取用”(Open Access) 图像。此聊天机器人仅在 isPublicDomain 为 true 且存在主图像 URL 时提供图像。否则,它会链接到博物馆页面。
聊天机器人能告诉我某件作品今天是否展出吗?
如需参观,请打开当前的博物馆作品页面并查看其展出信息。藏品搜索会找到已编目的作品,包括库房中的作品。
聊天机器人能解释艺术家的创作意图吗?
作品记录提供了媒材和创作日期等目录信息。要解释艺术家的意图或作品中的符号,请使用其他来源,例如策展人关于该特定艺术品的文章。