知识库 RAG
父子切片 + BM25/向量双路召回(RRF 融合)+ 引用溯源 | 版本化发布/回滚 | 文档密级 | 租户隔离
生命周期
| 阶段 | 状态 | 说明 |
|---|---|---|
| 上传 | indexed | Markdown/文本 → 切片 → 建索引(单文档 ≤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 回答,不阻断。
密级与隔离
- 库与文档全量按租户隔离(行级),跨租户不可见。
access_level:confidential 机密库可只绑定内部智能体,配合开放 API 的 kb_ids 覆盖实现分级披露。