动物识别

要解决的问题

当需要从图像中识别动物类别时，开发者通常要自己对接视觉 API，处理鉴权、参数编码、响应解析等琐事。本技能把「给一张图，返回动物标签」这件事封装成一个可直接调用的 Agent Skill，让大模型作为路由层理解意图，代码层只负责调用 API。

核心能力与工作流程

技能提供三种调用入口，覆盖常见的图片来源：

• scripts.tools.animal_recognition：接收图片链接 dataUrl
• scripts.tools.animal_recognition_for_data_base64：接收图片的 BASE64 编码 dataBase64
• scripts.tools.animal_recognition_for_data_file：接收本地图片路径

工作流程分为五步：

1. 检查 API 密钥：若 scripts.config.settings.api_key 为空，通过 AskUserQuestion 询问用户
2. 选择工具：根据图片来源匹配对应的工具函数
3. 提取参数：从用户输入中解析 dataUrl、dataBase64 或文件路径
4. 调用工具：以关键字参数方式调用 scripts.tools 中的函数
5. 返回结果：整理 result["raw"] 中的原始 JSON 数据展示给用户

注意点

• API 密钥是必需的。首次使用时需配置 XBY_APIKEY，获取地址为 https://xiaobenyang.com
• 缺少密钥时禁止自行搜索或编造数据，必须向用户询问
• 参数不完整时，应通过 AskUserQuestion 补充询问