安裝 Figena CLI 並執行第一個指令

概述

Figena CLI 把已獲核准的 Figena 工作帶進終端機。你可以透過瀏覽器登入、執行已發佈的智慧代理版本、管理知識庫、呼叫 OpenPort 操作，每個指令都會回傳人和腳本都能讀懂的明確結果。

環境需求

• Node.js 22。figena doctor 會把其他 Node 版本回報為不支援。
• 一個 Figena 帳號，所在工作區已獲准開通 CLI。
• 終端機能夠存取 Figena API：https://api.figena.com/api。

安裝 CLI

用你常用的套件管理器全域安裝：

npm install -g @figena/cli

執行 figena --version 確認安裝成功，它會輸出 CLI 套件名稱、版本和 Node.js 版本。

三步完成設定

1. 1建立一個指向 Figena API 的 profile。config init 同時會把它設為目前的 profile。
2. 2登入。瀏覽器會開啟 Figena 的授權頁面，在頁面上核准請求。
3. 3執行 figena doctor 檢查設定。

figena config init --profile production --api-base-url https://api.figena.com/apifigena auth loginfigena doctor

看懂 doctor 報告

figena doctor 會逐項檢查並列出結果：

• node：Node.js 版本，必須是 22.x。
• profile 和 apiBaseUrl：目前使用的 profile，以及是否設定了 API 位址。
• auth：是否有可用的登入工作階段或 Agent Key。
• storePermissions：本機設定檔和憑證檔是否只有你自己的使用者能讀取。
• apiVersion 和 apiHealth：API 是否回應版本和健康檢查。

只有 Node.js 版本不支援或缺少 API 位址會阻斷設定，此時報告最後顯示「Doctor found blocking issues」。缺少憑證只會提示，不會阻斷，因為你可以之後再登入。

查看說明

執行 figena help、figena --help 或 figena -h 可以列出全部指令。輸入未知指令時也會顯示這份清單，並以結束代碼 2 結束。

下一步

1. 1為 Figena CLI 驗證身分：瀏覽器登入、Agent Key，以及憑證的儲存位置。
2. 2設定 profile：為多個工作區或環境分別儲存設定。
3. 3在腳本中使用 CLI 輸出：輸出格式、結果欄位和結束代碼。