---
title: 使用AI設定
description: 讓AI助理設定並執行您的NexCMP：在管理後台使用AI Chat、透過MCP使用您自己的AI客戶端，或是使用YAML檔案。了解其功能與相關安全規則。
url: https://nexcmp.com/zh-tw/docs/configure-with-ai/overview/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# 使用AI設定 {#configure-with-ai}

> **管理後台位置：** AI Chat（`/agent`）與 System › Settings › API & AI agents（`/agent/keys`）。這些頁面上的所有功能僅限管理員使用。

## 功能 {#what-it-does}

從NexCMP 1.4.0開始，您可以請AI助理為您設定面板：連線Proxmox VE或CloudStack、建立區域、根據成本建立方案表、設定電子郵件、付款與品牌、尋找客戶，或匯出整個設定。助理透過一組固定的**管理工具**運作。它永遠不會取得shell、永遠不會讀取伺服器上的檔案，也永遠不會看到儲存的密碼或API key。

當您希望在幾分鐘內完成首次設定，而不必點擊十幾個頁面時，或者當您管理多個安裝並希望將其設定保留在檔案中時，請使用此功能。

## 使用的三種方式 {#three-ways-to-use-it}

| 方式 | 誰與AI對話 | 執行位置 | 從這裡開始 |
|---|---|---|---|
| **管理後台中的 AI Chat** | 您，在NexCMP管理後台中 | 您選擇的AI來源：來自OpenAI、Anthropic、Gemini或OpenRouter的API key、您面板自己的AI提供者，或是您登入的官方AI CLI | [管理員中的 AI Chat](https://nexcmp.com/zh-tw/docs/configure-with-ai/ai-chat-in-admin/) |
| **透過MCP使用您自己的AI客戶端** | 您，在Claude Code、Codex CLI、Gemini CLI、Cursor、Claude Desktop、claude.ai或ChatGPT中 | 在您的機器上或供應商的應用程式中，連線至您的面板 `https://cloud.example.com/mcp/admin` | [Connect an AI client](https://nexcmp.com/zh-tw/docs/configure-with-ai/mcp-admin/) |
| **設定即程式碼** | 您或某個腳本 | 伺服器上的YAML檔案與 `nexcmp config` 指令（或「匯入/匯出」頁面） | [Configuration as code](https://nexcmp.com/zh-tw/docs/configure-with-ai/config-as-code/) |

這三者都會呼叫相同的工具並透過相同的安全層，因此您可以將它們混合使用：用助理起草設定、將其匯出為YAML、在您的編輯器中檢閱並稍後套用。

## 安全模型 {#safety-model}

| Rule | 這對您的意義 |
|---|---|
| **範圍** | 金鑰或連線僅限於您勾選的範圍（`admin:read`、`catalog:write`、`infra:write`、`billing:write`、`customers:write`、`settings:write`、`ai:write`、`secrets:write`）。若無範圍，呼叫將被拒絕。請參閱 [Admin API keys](https://nexcmp.com/zh-tw/docs/configure-with-ai/admin-api-keys/#scopes)。 |
| **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。
:::

## 快速入門 {#quick-start}

1. 登入管理後台並開啟 **AI Chat**。如果尚未連接任何AI source，請開啟 **System › Settings › AI accounts** 並連接一個（請參閱 [AI accounts and subscriptions](https://nexcmp.com/zh-tw/docs/configure-with-ai/ai-accounts-and-subscriptions/)）。
2. 輸入「Check my setup progress」並按下Enter。助理會讀取 [Setup progress checklist](https://nexcmp.com/zh-tw/docs/configure-with-ai/setup-checklist/) 並告訴您還剩下什麼。
3. 要求它執行下一步。檢視每個確認卡片並按下 **Confirm** 以套用。

若要首次了解可以詢問什麼，請參閱 [Example prompts](https://nexcmp.com/zh-tw/docs/configure-with-ai/example-prompts/)。

![包含對話、工具結果與確認卡片的AI Chat頁面](https://nexcmp.com/zh-tw/docs/images/configure-with-ai/overview-01-ai-chat.webp)

## 限制與注意事項 {#limits-notes}

- **Demo and read-only。** 這些頁面在示範面板上可見，但在那裡無法儲存任何東西。
- **No shell。** 助理只能呼叫 [Connect an AI client](https://nexcmp.com/zh-tw/docs/configure-with-ai/mcp-admin/#tools) 中列出的管理工具。它無法在伺服器上執行指令。
- **網路與路由模組**（BGP、XDP、介面、NAT等）對AI而言是唯讀的，而管理員帳戶、備份與更新等敏感區域則完全不對keys開放。
- **價格**以USD計算：方案價格為每小時美元，餘額以美分計算。
- **成本。** AI回答的費用需支付給您連接的AI source（API使用費，或您自己的訂閱）。在AI Chat中您可以設定每日花費上限。關於NexCMP授權模式，請參閱 https://nexcmp.com/pricing。

## 故障排除 {#troubleshooting}

| 症狀 | 原因 | 修正方式 |
|---|---|---|
| AI Chat顯示未連接AI source | 您的管理員帳戶未設定source | 開啟System › Settings › AI accounts並連接一個。 |
| 助理回答 `insufficient_scope` | key或連線缺少該工具的權限範圍 | 建立具有所需權限範圍的key，或重新連線並在同意畫面上勾選它。請參閱 [Admin API keys](https://nexcmp.com/zh-tw/docs/configure-with-ai/admin-api-keys/#errors)。 |
| 每個變更都顯示確認卡片 | AI Chat中的預期行為 | 按下 **Confirm** 以套用或按下 **Reject** 以取消。 |
| 寫入失敗並顯示 `demo_read_only` | 面板處於示範模式 | 請使用非示範安裝。 |