背景
DocPaws 的对话 Agent 基于本地知识库检索,并带引用与检索阈值拒答。补充一个可选的联网来源,可回答本地文档未覆盖的最新 / 公开信息,同时保留引用能力。
提议
新增 search_web Agent 工具(遵循 AGENTS.md 分层:外部 I/O 在 infra,编排在 usecases):
- 配置
YDC_API_KEY 后,Agent 多出 search_web 工具(未配置则不挂载、系统提示不变,零回归);
- 调用 You.com Search API(
GET /v1/search,X-API-Key),把公开网页作为本地库之外的补充来源;
- 结果复用现有引用管线(写入
ctx.last_citations,source 为标题,来源 URL 随 snippet 一并保留并持久化,不改 Citation schema),回答须标注来源 URL;
- 任何网络 / 状态码 / 解析异常统一降级为空结果,绝不影响本地检索链路。
说明
- 纯增量、Key 门控、Key 不泄露(仅出现在
X-API-Key 请求头);
- 已在 fork 完成实现与单元测试(infra 客户端 + Agent 工具),并做了现网真实调用验证。
如维护者认可,我已准备好提交 PR。
背景
DocPaws 的对话 Agent 基于本地知识库检索,并带引用与检索阈值拒答。补充一个可选的联网来源,可回答本地文档未覆盖的最新 / 公开信息,同时保留引用能力。
提议
新增
search_webAgent 工具(遵循 AGENTS.md 分层:外部 I/O 在infra,编排在usecases):YDC_API_KEY后,Agent 多出search_web工具(未配置则不挂载、系统提示不变,零回归);GET /v1/search,X-API-Key),把公开网页作为本地库之外的补充来源;ctx.last_citations,source为标题,来源 URL 随 snippet 一并保留并持久化,不改 Citation schema),回答须标注来源 URL;说明
X-API-Key请求头);如维护者认可,我已准备好提交 PR。