知识库 RAG

父子切片 + BM25/向量双路召回(RRF 融合)+ 引用溯源 | 版本化发布/回滚 | 文档密级 | 租户隔离

生命周期

阶段状态说明
上传indexedMarkdown/文本 → 切片 → 建索引(单文档 ≤2MB)
发布published进入检索范围;同 filename 旧发布版本自动下线
下线indexed暂停参与检索,不删数据
回滚published把历史版本重新发布,当前版本自动下线
删除—文档或整库物理删除(含全部切片)

API(控制台已内置同款能力)

端点(/rag 前缀经网关,管理面 /api/v1/kb 同构)说明
POST /v1/kbs建库:{name, access_level: public|internal|confidential}
POST /v1/kbs/{kb}/documents上传:{filename, content} → 返回 doc_id + chunks 数
POST /v1/documents/{doc}/publish|unpublish发布 / 下线
POST /v1/documents/{doc}/rollback{to_version: n} 版本回滚
GET /v1/kbs/{kb}/documents文档列表(状态/版本)
PATCH /v1/kbs/{kb}/access调整库密级
POST /v1/search检索:{query, kb_ids, top_k} → 命中含 citation/doc/page
curl -s https://openagent-os.com/rag/v1/search \
  -H "Content-Type: application/json" \
  -d '{"query":"织唛起订量","kb_ids":["<kbID>"],"top_k":5}'

在对话中使用

把知识库绑定到智能体(控制台勾选或 API kb_ids)后: 设备对话、控制台试跑、开放 API 的每次回答都会先检索—— 命中内容作为上下文注入,回答自动带引用 (citations:[{citation,doc,page}])。检索失败自动降级为纯 LLM 回答,不阻断。

密级与隔离