通过AI进行配置
管理端位置： AI Chat (
/agent) 以及 System › Settings › API & AI agents (/agent/keys)。这些页面上的所有内容仅限管理员访问。
功能说明
从NexCMP 1.4.0开始，您可以让AI助手为您配置面板：连接Proxmox VE或CloudStack、创建区域、根据成本构建套餐表、设置邮件、支付和品牌、查找客户，或导出整个配置。该助手通过一套固定的管理工具进行工作。它永远不会获取Shell、永远不会读取服务器上的文件，也永远不会看到存储的密码或API密钥。
当您希望在几分钟内完成初始设置（而不是点击十几个页面），或者当您管理多个安装并希望将配置保存在文件中时，请使用它。
三种使用方式
| 方式 | 谁与AI对话 | 运行位置 | 从这里开始 |
|---|---|---|---|
| 管理端的AI Chat | 您，在NexCMP管理端中 | 您选择的AI源：来自OpenAI、Anthropic、Gemini或OpenRouter的API密钥、您面板自己的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、在编辑器中审查并在稍后应用。
安全模型
| 规则 | 对您的意义 |
|---|---|
| 权限范围 | 密钥或连接受限于您勾选的范围（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”并按回车。助手将读取 Setup progress checklist 并告诉你还剩什么。
- 要求它执行下一步。检查每个确认卡片并按 Confirm 来应用它。
如需了解首次询问的内容，请参见 Example prompts。
限制与注意事项
- 演示与只读。 这些页面在演示面板上可见，但在那里无法保存任何内容。
- 无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 | 面板处于演示模式 | 请使用非演示安装。 |