角色知识库检索

解决什么问题

当用户希望从某个 avatar 的个人知识库（PKM）中查找笔记、上传文件或角色参考资料时，通用问答往往不够，因为内容来自客户维护的数据集，需要直接检索指定 dataset_id。这个技能把这类需求收敛为一个明确流程：先确认检索输入，再调用 PKM 检索接口，最后把碎片化命中结果整理成可用答案。

如何工作

技能适用于用户已经提供 dataset_id 或愿意补充 dataset_id 的场景。关键步骤包括：

• 读取 skills/pkm-retrieval/config.json，获取 base_url 与 API 凭据；
• 使用用户查询构造检索请求，并调用 POST /v1/datasets/{dataset_id}/retrieve；
• 在环境约定中，UI Vector Search 对应 search_method: "semantic_search"；
• 返回结果时优先采用高分 chunk，过滤噪音 PDF 或图片预览片段，总结相关内容，并在有帮助时附上来源文档名。

适用边界

不要把它用于通用网页知识、产品常识问答，或在只有 avatar_id 但缺少 dataset_id 时默认猜测。若缺少 dataset_id，应先向用户索要，而不是从 avatar_id 推导内部数据集。凭据必须来自配置文件，不能在技能说明或请求中硬编码密钥。