跳到主要内容

知识库与运行态 Skill

这篇主要给 Agent 维护者、交付同学、技能维护者 看。业务人员通常只需要说清楚问题，不需要直接维护知识库或 Skill。

两类能力分别解决什么​

Lovrabet Runtime CLI 当前提供两组和 Agent 知识相关的能力：

  • lovrabet kb ...：维护当前应用下的个人知识库条目，并搜索当前用户可见的公司 / 个人知识。
  • lovrabet skill ...：安装官方 Lovrabet Skill，或把平台里的个人 / 公司运行态 Skill 同步到本地 Agent skill 目录。

这两组命令都依赖 AccessKey 登录，并需要能解析到当前应用。通常先执行：

lovrabet auth status
lovrabet app list
lovrabet app use <appName>

也可以在单次命令里显式传 --app 或 --appcode。

个人知识库：lovrabet kb​

列表与详情​

# 列出当前应用下的个人知识库条目
lovrabet kb list

# 查看完整字段
lovrabet kb list --verbose

# 查看单条详情
lovrabet kb detail --id <kbId>

list 默认返回摘要字段：id、title、version、ragStatus、ragErrorMessage、updateTime。详情会包含 content、scope、userId、创建和更新时间等字段。

创建与更新​

创建和更新都从本地 UTF-8 文本或 Markdown 文件读取正文：

# 预览创建
lovrabet kb create --title "售后规则" --file ./knowledge/after-sales.md --dry-run

# 创建
lovrabet kb create --title "售后规则" --file ./knowledge/after-sales.md

# 预览更新
lovrabet kb update --id <kbId> --file ./knowledge/after-sales.md --dry-run

# 更新标题和正文
lovrabet kb update --id <kbId> --title "售后规则 v2" --file ./knowledge/after-sales.md

--file 必须指向本地普通文件。不要把 AccessKey、Cookie、Authorization、客户隐私或生产密码写进知识库正文。

搜索可见知识​

lovrabet kb search --query "售后退款规则"
lovrabet kb search --query "售后退款规则" --topk 5

搜索范围包括当前用户可见的公司知识和个人知识，返回 scope、docId、score、weightedScore、content 和 metadata。Agent 可以先搜索知识，再决定是否继续调用 data、sql 或 bff。

官方 Skill 安装：lovrabet skill install​

第一次接入 Agent 环境时，优先使用 CLI 内置入口：

lovrabet skill install

它等价于安装公开 Lovrabet Skill：

npx skills add lovrabet/lovrabet-cli -g -y

公开 Skill 用来告诉 Agent：什么场景该调用运行态 CLI、哪些操作要先 dry-run、哪些真实写入要等用户确认。

平台运行态 Skill 同步​

平台里维护的个人 / 公司运行态 Skill 可以同步到本地 Agent skill 目录，用于让 Agent 读取当前应用的稳定业务流程。

拉取平台 Skill​

# 拉取当前应用下所有可见运行态 Skill
lovrabet skill pull

# 只拉取某一个 Skill code
lovrabet skill pull --code <skillCode>

skill pull 会读取个人和公司两个范围，写入本地 skill 目录，并建立当前应用的有效 Skill 链接。输出会包含个人、公司、物化数量和链接创建 / 更新情况。

推送本地 Skill 到个人范围​

lovrabet skill push --dir ./my-runtime-skill

--dir 必须指向包含 SKILL.md 的本地 Skill 目录。推送目标是当前应用下的个人运行态 Skill 范围；如果同一个 skillCode 已存在，则更新，否则创建。

建议工作流​

  1. 用 kb search 查是否已有稳定知识。
  2. 缺少背景知识时，用 kb create 或 kb update 维护个人知识库。
  3. 稳定成可复用业务流程后，沉淀为运行态 Skill。
  4. 用 skill push 上传个人 Skill，验证后再由平台侧决定是否沉淀为公司 Skill。
  5. 新机器或 Agent 环境用 skill install 安装公开 Skill，再用 skill pull 拉取平台 Skill。

小结​

  • kb list/detail/create/update/search 管个人知识库和可见知识搜索。
  • skill install 安装公开 Lovrabet Skill。
  • skill pull/push 同步平台运行态 Skill，适合维护当前应用的业务 Agent 流程。
  • 知识和 Skill 正文不要包含真实凭证、隐私数据或一次性调试日志。