---
title: 通过AI进行配置
description: 让AI助手设置并运行您的NexCMP：使用管理端的AI Chat、通过MCP连接您自己的AI客户端，或是使用YAML文件。了解其功能及相关的安全规则。
url: https://nexcmp.com/zh-cn/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密钥。

当您希望在几分钟内完成初始设置（而不是点击十几个页面），或者当您管理多个安装并希望将配置保存在文件中时，请使用它。

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

| 方式 | 谁与AI对话 | 运行位置 | 从这里开始 |
|---|---|---|---|
| **管理端的AI Chat** | 您，在NexCMP管理端中 | 您选择的AI源：来自OpenAI、Anthropic、Gemini或OpenRouter的API密钥、您面板自己的AI提供商，或您登录的官方AI CLI | [管理后台中的 AI Chat](https://nexcmp.com/zh-cn/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-cn/docs/configure-with-ai/mcp-admin/) |
| **配置即代码** | 您或脚本 | 服务器上的YAML文件和 `nexcmp config` 命令（或导入/导出页面） | [Configuration as code](https://nexcmp.com/zh-cn/docs/configure-with-ai/config-as-code/) |

这三种方式都调用相同的工具并通过相同的安全层，因此您可以将它们混合使用：用助手起草配置、将其导出为YAML、在编辑器中审查并在稍后应用。

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

| 规则 | 对您的意义 |
|---|---|
| **权限范围** | 密钥或连接受限于您勾选的范围（`admin:read`、`catalog:write`、`infra:write`、`billing:write`、`customers:write`、`settings:write`、`ai:write`、`secrets:write`）。没有范围的调用将被拒绝。参见 [Admin API keys](https://nexcmp.com/zh-cn/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-cn/docs/configure-with-ai/ai-accounts-and-subscriptions/)）。
2. 输入“Check my setup progress”并按回车。助手将读取 [Setup progress checklist](https://nexcmp.com/zh-cn/docs/configure-with-ai/setup-checklist/) 并告诉你还剩什么。
3. 要求它执行下一步。检查每个确认卡片并按 **Confirm** 来应用它。

如需了解首次询问的内容，请参见 [Example prompts](https://nexcmp.com/zh-cn/docs/configure-with-ai/example-prompts/)。

![带有对话、工具结果和确认卡片的AI Chat页面](https://nexcmp.com/zh-cn/docs/images/configure-with-ai/overview-01-ai-chat.webp)

## 限制与注意事项 {#limits-notes}

- **演示与只读。** 这些页面在演示面板上可见，但在那里无法保存任何内容。
- **无Shell。** 助手只能调用 [Connect an AI client](https://nexcmp.com/zh-cn/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-cn/docs/configure-with-ai/admin-api-keys/#errors)。 |
| 每次更改都会显示一个确认卡片 | AI Chat中的预期行为 | 按 **Confirm** 应用，或按 **Reject** 取消。 |
| 写入失败并返回 `demo_read_only` | 面板处于演示模式 | 请使用非演示安装。 |