命令参考：知识库

概述

知识库命令用于管理智能体所依据的知识库。它们需要浏览器登录，以及支持知识库功能的服务器；只有 Agent Key 时会停止并提示“Knowledge commands require a signed-in user session”。作用于整个工作区的命令接受 --org <workspace-id>，或使用 profile 中的 orgId。

知识库

figena knowledge list

列出工作区中的知识库。选项：--org <workspace-id>。

figena knowledge create

创建知识库。选项：--name <name>（必填）、--description <text> 和 --org。

figena knowledge get <knowledgeBaseId>

查看一个知识库。

访问权限

figena knowledge access get <knowledgeBaseId>

查看知识库的可见范围和授权。

figena knowledge access set <knowledgeBaseId>

更新谁可以使用知识库。

• --visibility <value>：修改可见范围。
• --user-id <id> 或 --org-role <role>：授权给某个人或某个工作区角色。授权总是包含读取权限。
• --can-write：同时允许这个人或角色修改知识库。
• --grants-json '[...]'：用 JSON 数组形式的多条授权代替单条授权。
• --metadata-json '<json>' 或 --metadata-file <file>：附加访问元数据。

figena knowledge access set <knowledgeBaseId> --org-role <role> --can-write

文档和文件

figena knowledge document add <knowledgeBaseId>

添加一篇文本文档。--title <title> 和 --content <value> 为必填。如果 --content 的值是一个已存在文件的路径，CLI 会以 UTF-8 文本读取该文件；否则直接把这个值作为内容。内容最多 30,000 个字符。可选：--source-name <name> 和 --mime-type <type>。

figena knowledge file import <knowledgeBaseId>

用 --file <path> 上传本地文件并导入为文档，或用 --file-id <id> 导入已上传的文件。加上 --title <title> 可以为文档命名。CLI 会根据扩展名为 JSON、Markdown、纯文本和日志、CSV、HTML、PDF、PNG、JPEG 和 WebP 设置文件类型；其他文件按通用二进制数据发送。

figena knowledge document add <knowledgeBaseId> --title "Refund policy" --content ./refund-policy.mdfigena knowledge file import <knowledgeBaseId> --file ./price-list.pdf --title "2026 price list"

检索和核验

figena knowledge search <knowledgeBaseId>

在知识库中搜索。--query "<text>" 为必填；--limit <n> 限制结果数量。

figena knowledge verify

检查知识库的检索效果，确认回答引用了正确的文档。用 --knowledge-base <id> 或第一个参数指定知识库；可用 --document <id> 和 --limit <n> 缩小范围。

figena knowledge citation-audits

列出工作区中的引用审计。选项：--org、--knowledge-base <id>、--document <id> 和 --limit <n>。