TIP

这篇文档帮助你用 lovrabet kb 创建、查看、更新和检索当前应用下的个人知识库。完成后，Agent 可以在检索命中时使用这些业务规则、SOP 和固定说明。

准备工作

准备项	要求	检查方式
Lovrabet Runtime CLI	本地可以执行 lovrabet	lovrabet --help
AccessKey	当前用户有目标应用权限	lovrabet auth status
目标应用	已知道应用名或 appcode	lovrabet app list
知识正文文件	本地 UTF-8 文本或 Markdown 文件	例如 ./approval.md

WARNING

个人知识库只写入当前用户在当前应用下的知识。lovrabet kb search 会检索当前用户可见的公司知识和个人知识，并通过 scope 区分来源。

登录并确认应用

lovrabet auth login --access-key <ACCESS_KEY>
lovrabet auth status

lovrabet app list
lovrabet app use <应用名称>

如果不想设置默认应用，也可以在后续每条命令后追加 --appcode <APP_CODE>。

---

创建个人知识库

先把要保存的规则写成本地文件。知识库创建和更新都从文件读取正文，不支持直接在命令里传内联正文。

# 订单审批规则

- 金额超过 50000 元，需要主管审批。
- 加急订单必须填写加急原因。
- 缺少客户编号时，不允许进入审批。

预览创建请求

lovrabet kb create --title "订单审批规则" --file ./approval.md --dry-run

确认预览里的 appCode、title 和文件正文无误后，再执行创建。

创建知识库条目

lovrabet kb create --title "订单审批规则" --file ./approval.md --format compress

创建成功后，输出会包含 id、title、version、ragStatus、ragErrorMessage 和 updateTime 等字段。记下 id，更新和查看详情时会用到。

---

查看和更新个人知识库

查看知识库列表

lovrabet kb list --format compress

列表默认展示每条知识的 id、title、version、ragStatus 和更新时间。

查看知识库正文

lovrabet kb detail --id <条目ID> --format compress

详情会返回完整正文、版本、创建时间、更新时间和 RAG 状态。更新前先读详情，可以避免覆盖错条目。

从文件更新知识库

lovrabet kb update --id <条目ID> --file ./approval-v2.md --dry-run
lovrabet kb update --id <条目ID> --file ./approval-v2.md --format compress

省略 --title 时，CLI 会先读取当前条目并保留原标题。需要改标题时，显式传入新标题。

lovrabet kb update --id <条目ID> --title "新版订单审批规则" --file ./approval-v2.md --format compress

WARNING

lovrabet kb 当前不提供删除命令。需要删除知识库条目时，在产品界面处理。

---

检索知识库

按业务问题检索

lovrabet kb search --query "订单审批" --topk 5 --format compress

搜索结果会返回命中条数和 hits。每个命中项包含 scope、docId、score、weightedScore、content 和 metadata。其中 scope 用来区分公司知识和个人知识。

字段	含义
PERSONAL	当前用户写入的个人知识
COMPANY	当前用户可见的公司知识
score	原始相似度分数
weightedScore	加权后的排序分数

确认 RAG 状态

创建或更新成功，只代表条目已经写入。要确认 Agent 可以检索到，需要继续看 ragStatus 和搜索命中。

ragStatus	处理方式
PENDING	等待同步。稍后再查详情或检索。
PARSING	文件解析中。稍后再查。
INDEXING	索引处理中。稍后再查。
READY	可以检索。继续用 kb search 验证命中。
FAILED	查看 ragErrorMessage，修正文档后重新更新。
DISABLED	当前环境未启用 RAG 检索。只能确认条目已保存。

lovrabet kb detail --id <条目ID> --format compress
lovrabet kb search --query "刚写入的关键词" --topk 5 --format compress

---

在 Agent 对话中保存知识

如果在 Lovrabet Runtime Agent 对话里保存知识，先把标题和正文说清楚。Agent 只有在内容明确时才会写入个人知识库。

把下面这条规则保存到知识库，标题叫「订单审批规则」：
金额超过 50000 元，需要主管审批；加急订单必须填写加急原因。

Agent 行为	你能看到的结果
确认标题和正文	标题、正文来自你的明确输入或当前对话已确认内容
调用知识库写入能力	创建或更新当前应用下的个人知识库
写入成功后打开详情	如果返回 kbId，页面会打开对应知识库条目
检索知识	Agent 可按问题检索公司知识和个人知识

WARNING

不要把 AccessKey、Cookie、账号密码、客户隐私或临时调试信息保存进知识库。知识库适合保存稳定规则、SOP、字段含义、查询条件和可复用案例。

---

完成检查

• [ ] 已经用 lovrabet kb create 或 lovrabet kb update 写入条目。

• [ ] 已经用 lovrabet kb detail --id <条目ID> 看到正确标题、正文和版本。

• [ ] ragStatus 是 READY，或已经说明当前环境处于等待、失败或未启用状态。

• [ ] 已经用 lovrabet kb search 检索到刚写入的关键词。

• [ ] 需要 Agent 使用时，已经用相同业务问题验证 Agent 回答能反映这条知识。

---

常见问题

提示 Authentication required

本地没有配置 AccessKey，或当前环境没有读到配置。先执行登录。

lovrabet auth login --access-key <ACCESS_KEY>
lovrabet auth status

提示 App code is required

当前命令没有解析到目标应用。先设置默认应用，或在命令里显式追加 --appcode <APP_CODE>。

lovrabet app list
lovrabet app use <应用名称>

提示 File not found

--file 指向的本地文件不存在，或不是普通文件。确认路径后重试。创建和更新都必须使用本地文件。

搜索没有命中

先查看详情里的 ragStatus。如果仍是 PENDING、PARSING 或 INDEXING，稍后再搜。如果是 FAILED，根据 ragErrorMessage 修正文档后重新更新。

能不能用 CLI 删除知识库

不能。当前 lovrabet kb 只支持 list、detail、create、update 和 search。删除在产品界面处理。