Skip to content

新增 search_web 工具:接入 You.com 联网检索作为带引用的补充来源 #2

Description

@Emos21

背景

DocPaws 的对话 Agent 基于本地知识库检索,并带引用与检索阈值拒答。补充一个可选的联网来源,可回答本地文档未覆盖的最新 / 公开信息,同时保留引用能力。

提议

新增 search_web Agent 工具(遵循 AGENTS.md 分层:外部 I/O 在 infra,编排在 usecases):

  • 配置 YDC_API_KEY 后,Agent 多出 search_web 工具(未配置则不挂载、系统提示不变,零回归);
  • 调用 You.com Search API(GET /v1/searchX-API-Key),把公开网页作为本地库之外的补充来源;
  • 结果复用现有引用管线(写入 ctx.last_citationssource 为标题,来源 URL 随 snippet 一并保留并持久化,不改 Citation schema),回答须标注来源 URL;
  • 任何网络 / 状态码 / 解析异常统一降级为空结果,绝不影响本地检索链路。

说明

  • 纯增量、Key 门控、Key 不泄露(仅出现在 X-API-Key 请求头);
  • 已在 fork 完成实现与单元测试(infra 客户端 + Agent 工具),并做了现网真实调用验证。

如维护者认可,我已准备好提交 PR。

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions