大都会博物馆

要解决的问题

当用户想按主题检索大都会艺术博物馆（Met Museum）的开放藏品，或顺着部门浏览某类艺术品时，模型本身并不持有实时数据。自行对接 API 需要处理密钥管理、参数拼装和分页逻辑，还得保证数据来源可信。这个技能把“理解意图 → 调用工具 → 整理返回”的链路收敛成固定流程：模型只做路由，代码负责真正发请求。

工作流程

1. 检查 API 密钥：若 scripts.config.settings.api_key 为空，必须通过 AskUserQuestion 向用户索要密钥（获取地址见 SKILL.md），拿到后调用 scripts.config.set_api_key(key) 保存，再继续后续步骤。
2. 选择工具：按用户意图映射到三个工具之一：

- scripts.tools.list_departments：列出博物馆全部部门，无参数。
- scripts.tools.search_museum_objects：按关键字 q 搜索，返回总数与分页的 Object IDs；可选 departmentId、page、pageSize（上限 100）。
- scripts.tools.get_museum_object：按 objectId 拉取单件藏品详情。

1. 提取参数：从用户查询中解析目标值；参数不完整时同样用 AskUserQuestion 追问。
2. 调用工具：一律以关键字参数调用，例如 scripts.tools.search_museum_objects(q='Van Gogh', page=1, pageSize=50)。
3. 返回结果：工具返回 result["raw"]、result["success"]、result["message"]，将原始 JSON 整理后直接呈现给用户。

注意点

• 密钥是硬门槛：缺少 XBY_APIKEY 时禁止自行搜索或编造数据，必须先向用户索取。
• 模型层不生成内容，所有展示均来自 result["raw"] 的真实返回。
• departmentId 应取自 list_departments 的结果，避免手填无效 ID。
• 搜索结果只含 Object IDs，要看详情需再用 get_museum_object 逐条获取。