Skip to content

feat: 集成 You.com 网络搜索作为检索数据源 #6

Description

@tra371

背景

当前 Argus 的混合检索(Hybrid Retrieval)仅支持两个通道:

  • 向量检索(pgvector)— 语义相似度匹配
  • 关键词检索(Elasticsearch)— BM25 精确匹配

两者都依赖内部知识库文档。对于需要实时信息、外部文档、最新资讯的查询,现有架构无法覆盖。

目标

集成 You.com Search API (ydc-index.io) 作为第三条检索通道,在问题超出内部知识库范围时,通过网络搜索补充证据。

方案设计

新增文件

  • engine/youcom/YoucomSearchService.java — 调用 POST https://ydc-index.io/v1/search
    • 使用 JDK HttpClient(与 Elasticsearch 通道一致)
    • 返回 Document 列表,content 取自 snippet,url 写入 metadata
  • engine/youcom/YoucomSearchProperties.java@ConfigurationProperties 配置类

配置文件

youcom:
  search:
    enabled: true
    api-key: ${YOUCOM_API_KEY}
    base-url: https://ydc-index.io/v1
    top-k: 10

检索流程变更

HybridChunkRetrievalService 改为三通道并行检索:

查询规划
    ↓
向量检索 ─┬─ RRF 融合排序
关键词检索 ─┤  (k=0)
You.com 搜索 ─┘
    ↓
证据评估

You.com 通道独立于 groupId 过滤(无权限限制),结果直接追加到 documents 列表。

测试计划

  • You.com API 连通性测试
  • 三通道并行检索正常返回结果
  • You.com 未命中时不影响原有双通道结果
  • API Key 未配置时优雅降级(跳过 Web 通道)

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