agentbase-docs

检索与溯源

单库 / 跨库检索与溯源读原文的各语言调用示例;概念、参数与边界口径见知识库。

各语言调用示例

检索(单库 / 跨库)

createSearch 单库,createMultiSearch 跨 1–10 库(跨库先 RRF 合并再对合并池做一次 rerank);结果 chunk 带 content / source / locator。Web 面无检索能力。

const found = await kb.createSearch({
    knowledgeBaseId: base.$id,
    query: '退款政策是什么?',
    searchMode: 'hybrid',   // 参数名是 searchMode;vector / fulltext / hybrid
    limit: 10,
    rerank: true            // 先扩大召回再经 Gateway 重排;自动选择失败降级并返回 reranked: false
});
// 跨库:kb.createMultiSearch({ knowledgeBaseIds: [...], query, limit })(1–10 库,全局 TopK)

溯源与读原文

命中 chunk 自带 content、source(受保护原文 URI)与 locator(章节 / 文本偏移);getDocumentSource 读回原始文件(二进制流,支持 Range 分段返回 206),只需 knowledgebases.read、不另需 files.read。Web 面无此能力。

// 命中 chunk 的 sourceId 即原文档 ID;读回原文做人工核对或归档
const raw = await kb.getDocumentSource({ knowledgeBaseId: base.$id, documentId: '<documentId>' });