使用AI設定
管理後台位置： AI Chat（
/agent）與 System › Settings › API & AI agents（/agent/keys）。這些頁面上的所有功能僅限管理員使用。
功能
從NexCMP 1.4.0開始，您可以請AI助理為您設定面板：連線Proxmox VE或CloudStack、建立區域、根據成本建立方案表、設定電子郵件、付款與品牌、尋找客戶，或匯出整個設定。助理透過一組固定的管理工具運作。它永遠不會取得shell、永遠不會讀取伺服器上的檔案，也永遠不會看到儲存的密碼或API key。
當您希望在幾分鐘內完成首次設定，而不必點擊十幾個頁面時，或者當您管理多個安裝並希望將其設定保留在檔案中時，請使用此功能。
使用的三種方式
| 方式 | 誰與AI對話 | 執行位置 | 從這裡開始 |
|---|---|---|---|
| 管理後台中的 AI Chat | 您，在NexCMP管理後台中 | 您選擇的AI來源：來自OpenAI、Anthropic、Gemini或OpenRouter的API key、您面板自己的AI提供者，或是您登入的官方AI CLI | 管理員中的 AI Chat |
| 透過MCP使用您自己的AI客戶端 | 您，在Claude Code、Codex CLI、Gemini CLI、Cursor、Claude Desktop、claude.ai或ChatGPT中 | 在您的機器上或供應商的應用程式中，連線至您的面板 https://cloud.example.com/mcp/admin | Connect an AI client |
| 設定即程式碼 | 您或某個腳本 | 伺服器上的YAML檔案與 nexcmp config 指令（或「匯入/匯出」頁面） | Configuration as code |
這三者都會呼叫相同的工具並透過相同的安全層，因此您可以將它們混合使用：用助理起草設定、將其匯出為YAML、在您的編輯器中檢閱並稍後套用。
安全模型
| Rule | 這對您的意義 |
|---|---|
| 範圍 | 金鑰或連線僅限於您勾選的範圍（admin:read、catalog:write、infra:write、billing:write、customers:write、settings:write、ai:write、secrets:write）。若無範圍，呼叫將被拒絕。請參閱 Admin API keys。 |
| Expiry | 每個金鑰與連線都會過期：您建立的金鑰為1到90天，預設為30天。OAuth存取權杖持續一小時。 |
| IP限制與速率限制 | 金鑰可限制於IP範圍及每分鐘的呼叫次數（預設為120次）。 |
| 雙步驟確認 | 移動資金、刪除資料、變更付款憑證或變更登入安全性的動作會先傳回預覽，在您核准之前不會執行任何動作。在AI Chat內部，每個變更都是一張您可以自行按下的確認卡片。 |
| 金鑰絕對不能做的事 | 建立管理員、變更2FA、建立或撤銷金鑰、以客戶身分登入、備份、還原或更新面板等。這些操作需要您在管理後台親自執行。 |
| 活動記錄 | 無論允許或拒絕，每次呼叫都會記錄金鑰、用戶端、工具、IP與結果。請參閱 System › Settings › API & AI agents › Activity. |
| 絕不回傳機密 | 密碼、API keys與權杖可以設定但絕不能被讀回。AI看到的回答會將其顯示為遮罩狀態。 |
| 展示安裝為唯讀 | 在示範面板上，所有寫入動作都會被 demo_read_only 拒絕。 |
::: important AI可以讀取的內容 透過 admin:read，助理可以讀取客戶姓名、電子郵件地址、餘額與帳單記錄。當您使用在供應商（OpenAI、Anthropic、Google、OpenRouter）執行的AI source時，該資料會傳送給該供應商以回答您的問題。請賦予助理其所需的最少權限範圍，並選擇您信任能處理該資料的source。 :::
快速入門
- 登入管理後台並開啟 AI Chat。如果尚未連接任何AI source，請開啟 System › Settings › AI accounts 並連接一個（請參閱 AI accounts and subscriptions）。
- 輸入「Check my setup progress」並按下Enter。助理會讀取 Setup progress checklist 並告訴您還剩下什麼。
- 要求它執行下一步。檢視每個確認卡片並按下 Confirm 以套用。
若要首次了解可以詢問什麼，請參閱 Example prompts。
限制與注意事項
- Demo and read-only。 這些頁面在示範面板上可見，但在那裡無法儲存任何東西。
- No shell。 助理只能呼叫 Connect an AI client 中列出的管理工具。它無法在伺服器上執行指令。
- 網路與路由模組（BGP、XDP、介面、NAT等）對AI而言是唯讀的，而管理員帳戶、備份與更新等敏感區域則完全不對keys開放。
- 價格以USD計算：方案價格為每小時美元，餘額以美分計算。
- 成本。 AI回答的費用需支付給您連接的AI source（API使用費，或您自己的訂閱）。在AI Chat中您可以設定每日花費上限。關於NexCMP授權模式，請參閱 https://nexcmp.com/pricing。
故障排除
| 症狀 | 原因 | 修正方式 |
|---|---|---|
| AI Chat顯示未連接AI source | 您的管理員帳戶未設定source | 開啟System › Settings › AI accounts並連接一個。 |
助理回答 insufficient_scope | key或連線缺少該工具的權限範圍 | 建立具有所需權限範圍的key，或重新連線並在同意畫面上勾選它。請參閱 Admin API keys。 |
| 每個變更都顯示確認卡片 | AI Chat中的預期行為 | 按下 Confirm 以套用或按下 Reject 以取消。 |
寫入失敗並顯示 demo_read_only | 面板處於示範模式 | 請使用非示範安裝。 |