RAGret 知识检索

要解决什么问题

在对话里提到「检索知识库」时，Agent 很容易混用三种路径：RAGret 服务、开放网页搜索，或本地/指定路径下的文件。若未先确认范围就发请求，要么打错 API，要么把用户密钥写进聊天记录。本技能把 RAGret 检索收成一套可执行的 HTTP 流程，并在缺配置时按规则追问，而不是臆造索引名或默认密钥。

技能如何工作

1. 澄清检索范围：只有在用户或上下文明确要用 RAGret（知识库）时，才进入后续 API 步骤；否则先让用户在 RAGret、开放网页、本地文件之间做选择。
2. 列举可见索引：使用 X-API-Key: $RAGRET_API_KEY 调用 GET $BASE/api/subscribe-indexes，拿到当前 API Key 能访问的索引列表。
3. 执行检索：对选定索引请求 GET $BASE/api/search/INDEX_NAME，用 --data-urlencode 传递 query，解析 JSON 中的 result 字段，或改用 format=text 便于阅读。
4. 补全环境与凭证：未给出 base URL 时，先确认本机或内网是否有可达的 RAGret 服务；仍不明则默认 http://127.0.0.1:8765。curl 返回 401/403 或提示密钥无效时，引导用户在本地环境设置 RAGRET_API_KEY，不在对话中索要明文密钥；请求头支持 X-API-Key 或 Authorization: Bearer。

回答规则与边界

• 默认依据检索结果作答，并在有用时标注来源；若结果里含 URL，应显式列出给用户。
• 本技能不替代 RAGret 服务本身的部署、建索引或订阅管理；也不覆盖开放网页搜索或纯本地文件 grep 类工作流。
• 开源实现见 RAGret；具体 $BASE、索引命名与权限以用户实际部署为准。