技能介绍

要解决什么问题

在对话式助手或 Agent 里，用户往往用自然语言找有声书、相声、播客，或追问「这集讲了什么」「给我推荐类似的」。若缺少与喜马拉雅平台对齐的检索、详情与推荐接口，模型只能泛泛回答，无法给出可跳转的专辑/声音、播放量与评论等可核对信息。

技能如何工作

本技能通过 Skill REST API 统一调用小雅工具集，业务参数必须放在请求体 arguments 内，并随请求携带 skill_version（如 1.0.0）。鉴权使用 Header：Authorization: Bearer $XIAOYA_API_KEY，密钥来自环境变量；未配置时需引导用户到喜马拉雅小雅 Skill 页面获取 token 后再设置。

核心能力包括：

音频搜索（hubSearch 等）：在海量内容中搜专辑、声音或主播；同步接口返回结构化 JSON（含 albums、tracks 等）。
音频详情与评价：查看简介、声音列表、用户评论与评分（见 explore 类说明）。
热门榜单：全站或分类热播/小说等榜单（见 rank 说明）。
个人资产：最近收听、订阅更新、收藏（见 user 说明）。
内容总结：AI 提炼单集要点，必须使用 SSE 流式接口，不能用普通同步 JSON 一次性拿全量生成结果。
个性推荐：基于收听习惯的首页或相似推荐（见 recommend 说明）。

展示结果时，应对用户突出标题、主播、播放量（可格式化为「X万」）、分类与评论；albumId/trackId 用于上下文记忆与构造链接，不宜当正文罗列。专辑与声音链接需以 Markdown 超链接输出，例如 App 深度链接 iting://open?msg_type=13&album_id={albumId} 或网页 https://www.ximalaya.com/album/{albumId}。

适用边界与注意点

调用任一工具前，应先阅读对应说明文件（如 search.md、ai.md），禁止凭字段名猜测参数含义；回包字段解释以说明文件为准。
若响应中出现 upgrade_info，须按 message 暂停当前流程、完成升级后再重试用户请求。
除搜索类 JSON 结果外，多数工具返回中文格式化文本，展示时按行透传即可；深度链接从文本或结构化字段中提取 ID 本地拼接，勿把 URL 以纯文本裸串展示。