指令參考：知識庫

概述

知識庫指令用於管理智慧代理所依據的知識庫。它們需要瀏覽器登入，以及支援知識庫功能的伺服器；只有 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>。