AE 知识库命令行技能(ae-kb)提供通过 ae-cli 管理 AE 知识库的完整命令集。命令形式为 ae-cli kb +<command> [options] 以及 ae-cli kb source <replace|restore|preview|commit|cancel|check-updates> [options]。
用途 该技能用于 AE 知识库相关任务:创建知识库、导入编译快照、查询、LLM 问答、列出可访问的知识库及其来源、检查索引、grep 页面、读取页面、查看状态、上传来源、添加 URL 来源、生成 schema、编译、移除来源文件以及删除知识库。
检索与问答 最常见的任务是搜索知识库获取答案,此时应直接进入 Explore Knowledge Base Pages 并先阅读 references/query-workflow.md。检索(+index / +grep / +read)是确定性的、服务端无 LLM 的,适合简单事实查找;当问题需要跨多个页面综合或多跳推理时使用 +ask(LLM 驱动的问答)。当检索到的页面将用于项目范围内的业务数据分析时,必须先阅读并遵循 references/analysis-workflow.md,命中已保存的资产、定义、参数、时间规则、冲突或决策边界后,不得直接跳到临时分析或 SQL。
主要命令 读取类:+ask、+ask-status、+list、+list-sources、+index、+grep、+read、+import-status、+status,以及版本命令 +versions、+version-show、+version-sources、+version-diff、+version-tree、+version-read、+version-download、+rollback-status,还有 ZIP 目录的 +source-ls、+source-read。 写入类:+new、+import、+add、+url、+schema、+compile、+remove,以及 source replace、source restore。 高风险写入:+rm-source、+rollback、source commit、source cancel、+source-rm。
使用方式要点 读操作在输入明确后可直接运行;写操作需要明确的用户意图,通常保留确认提示,除非用户要求跳过。破坏性或大范围写入在目标未经验证前优先使用 --dry-run。不得编造知识库名称、作用域、来源 ID、来源显示名或 JSON 负载,缺失值应向用户询问或查询已知上下文。构造 --sources ref 或 +read --source 时,应从 +list 输出复制精确的 scope 和 name。JSON 标志必须是有效的 JSON 字符串,通常在 shell 中用单引号包裹。命令默认返回 JSON,仅在人类更易阅读时使用 --format table。每次 ae-cli 运行后应检查 stderr 和 _notice.host_compat,若存在则以版本警告开头并逐字引用相关命令。
常见工作流 创建知识库使用 +new,--scope 可选,默认 company,有效值为 personal 和 company。 导入编译快照使用 +import,仅适用于根目录包含 index.md 且至少含一个 wiki/**/.md 页面的 ZIP,结果始终为个人只读快照,没有 --scope、--force 或替换选项,ZIP 限制 50 MB 且仅支持 Markdown 文本。 上传文件或目录使用 +add,--files 为 JSON 字符串数组,本地目录读取非递归,URL 需以 http:// 或 https:// 开头。 添加 URL 来源使用 +url,服务器会自动识别平台,.feishu.cn 或 *.larksuite.com 子域名的 URL 使用飞书管道解析。 生成 schema 使用 +schema,编译使用 +compile(增量或全量)。
来源变更与版本 KB source 相关命令用于文件/ZIP 来源的替换与恢复,使用 kb source <action>;+rollback 仍是整个知识库的发布操作。变更需要精确的 --name、--scope、当前 --id 和当前 --expected-revision。文件替换保持原格式但允许不同文件名,ZIP 需要 .zip 扩展名。不支持 URL/飞书以及已删除的父来源。更新仅影响草稿,发布仍需编译。ZIP 预览不得自动提交,不确定的写入不得重试。
ZIP 目录来源 使用 +add --files '["./sources.zip"]' 可将一个 ZIP 作为单个可编辑父来源上传,保留其内部层级。+source-ls 列出一页目录,+source-read 读取子文件,+source-put 添加或替换,+source-rm 删除子文件或递归删除子目录。--path 相对于 ZIP 根目录,根列表使用空路径。+source-put 接受单个不超过 50 MB 的文件,默认 --action add 拒绝已存在路径,--action replace 显式授权覆盖。--expected-revision 为写入必填,409 冲突返回服务器错误码,命令不会自动刷新重试。变更会标记父来源已更改但不会启动编译,需显式运行增量编译。
限制 资料未明确提及具体收费、价格与平台支持范围。导入快照不支持来源、schema、用量、编译、成员、设置、所有权转移或公司发布操作。具体命令参数与行为以官方文档为准,此处未提供的细节暂未提供。