---
title: Cấu hình bằng AI
description: Để trợ lý AI thiết lập và vận hành NexCMP: AI Chat trong admin, client AI qua MCP hoặc file YAML. Khả năng và các quy tắc bảo mật.
url: https://nexcmp.com/vi/docs/configure-with-ai/overview/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Cấu hình bằng AI {#configure-with-ai}

> **Vị trí trong trang admin:** AI Chat (`/agent`) và System › Settings › API & AI agents (`/agent/keys`). Mọi nội dung trên các trang này chỉ dành cho quản trị viên.

## Chức năng {#what-it-does}

Từ NexCMP 1.4.0, bạn có thể yêu cầu trợ lý AI cấu hình panel giúp mình: kết nối Proxmox VE hoặc CloudStack, tạo zone, xây dựng bảng gói dịch vụ từ chi phí của bạn, thiết lập email, cổng thanh toán và thương hiệu, tìm kiếm khách hàng hoặc xuất toàn bộ cấu hình. Trợ lý hoạt động thông qua một tập hợp **admin tool** cố định. Nó không bao giờ có quyền truy cập shell, không đọc file trên máy chủ và không nhìn thấy mật khẩu hay API key đã lưu.

Hãy sử dụng tính năng này khi bạn muốn thiết lập ban đầu chỉ trong vài phút thay vì bấm qua hàng chục trang, hoặc khi bạn quản lý nhiều hệ thống cài đặt và muốn lưu cấu hình của chúng trong một file.

## Ba cách sử dụng {#three-ways-to-use-it}

| Cách thức | Bên tương tác với AI | Nơi chạy | Bắt đầu từ đây |
|---|---|---|---|
| **AI Chat trong trang quản trị** | Bạn, trong trang admin NexCMP | Nguồn AI bạn chọn: API key từ OpenAI, Anthropic, Gemini hoặc OpenRouter, nhà cung cấp AI riêng của panel, hoặc CLI AI chính thức mà bạn đã đăng nhập | [AI Chat trong trang quản trị](https://nexcmp.com/vi/docs/configure-with-ai/ai-chat-in-admin/) |
| **Client AI của bạn qua MCP** | Bạn, trong Claude Code, Codex CLI, Gemini CLI, Cursor, Claude Desktop, claude.ai hoặc ChatGPT | Trên máy của bạn hoặc trong ứng dụng của nhà cung cấp, kết nối tới panel của bạn tại `https://cloud.example.com/mcp/admin` | [Kết nối client AI](https://nexcmp.com/vi/docs/configure-with-ai/mcp-admin/) |
| **Configuration as code** | Bạn hoặc một script | File YAML và lệnh `nexcmp config` trên máy chủ (hoặc trang Import/Export) | [Configuration as code](https://nexcmp.com/vi/docs/configure-with-ai/config-as-code/) |

Cả ba cách đều gọi các tool tương tự và đi qua cùng một lớp bảo mật, vì vậy bạn có thể kết hợp chúng: soạn thảo cấu hình với trợ lý, xuất ra dạng YAML, xem lại trong trình soạn thảo và áp dụng sau.

## Mô hình an toàn {#safety-model}

| Quy tắc | Ý nghĩa đối với bạn |
|---|---|
| **Scope** | Key hoặc kết nối bị giới hạn trong các scope bạn đã đánh dấu chọn (`admin:read`, `catalog:write`, `infra:write`, `billing:write`, `customers:write`, `settings:write`, `ai:write`, `secrets:write`). Nếu không có scope phù hợp, yêu cầu gọi sẽ bị từ chối. Xem [Admin API keys](https://nexcmp.com/vi/docs/configure-with-ai/admin-api-keys/#scopes). |
| **Expiry** | Mọi key và kết nối đều có hạn sử dụng: từ 1 đến 90 ngày đối với key bạn tạo, mặc định là 30 ngày. Token truy cập OAuth có hiệu lực trong một giờ. |
| **Giới hạn IP và rate limit** | Key có thể được giới hạn theo dải IP và số lượt gọi mỗi phút (mặc định là 120). |
| **Xác nhận hai bước** | Các thao tác luân chuyển tiền, xóa dữ liệu, thay đổi thông tin thanh toán hoặc đổi bảo mật đăng nhập sẽ hiển thị bản xem trước và không thực hiện gì cho đến khi bạn phê duyệt. Trong AI Chat, mỗi thay đổi là một thẻ xác nhận do bạn tự bấm duyệt. |
| **Những việc khóa không bao giờ làm được** | Tạo quản trị viên, đổi 2FA, tạo hoặc thu hồi khóa, đăng nhập dưới danh nghĩa khách hàng, sao lưu, khôi phục hoặc cập nhật panel, và các thao tác tương tự. Những việc này yêu cầu bạn tự thao tác trong admin. |
| **Nhật ký hoạt động** | Mọi lệnh gọi, dù được phép hay bị từ chối, đều được ghi lại cùng với khóa, client, công cụ, IP và kết quả. Xem System › Settings › API & AI agents › Activity. |
| **Thông tin bí mật không bao giờ được trả về** | Mật khẩu, API key và token có thể được thiết lập nhưng không bao giờ đọc lại được. Các câu trả lời mà AI nhìn thấy đều đã được che đi. |
| **Bản cài đặt demo ở chế độ chỉ đọc** | Trên panel demo, mọi thao tác ghi đều bị từ chối với `demo_read_only`. |

::: important Những gì AI có thể đọc
Với `admin:read`, trợ lý có thể đọc tên khách hàng, địa chỉ email, số dư và bản ghi thanh toán. Khi bạn sử dụng nguồn AI chạy tại nhà cung cấp bên ngoài (OpenAI, Anthropic, Google, OpenRouter), dữ liệu đó sẽ được gửi tới nhà cung cấp đó để trả lời câu hỏi của bạn. Hãy chỉ cấp cho trợ lý phạm vi quyền (scope) tối thiểu cần thiết và chọn nguồn AI mà bạn tin tưởng đối với dữ liệu đó.
:::

## Bắt đầu nhanh {#quick-start}

1. Đăng nhập vào admin và mở **AI Chat**. Nếu chưa có nguồn AI nào được kết nối, hãy mở **System › Settings › AI accounts** và kết nối một nguồn (xem [AI accounts and subscriptions](https://nexcmp.com/vi/docs/configure-with-ai/ai-accounts-and-subscriptions/)).
2. Nhập "Check my setup progress" và nhấn Enter. Trợ lý sẽ đọc [Setup progress checklist](https://nexcmp.com/vi/docs/configure-with-ai/setup-checklist/) và cho bạn biết những việc còn lại.
3. Yêu cầu trợ lý thực hiện bước tiếp theo. Xem lại từng thẻ xác nhận và nhấn **Confirm** để áp dụng.

Để tham khảo những nội dung nên hỏi ban đầu, hãy xem [Example prompts](https://nexcmp.com/vi/docs/configure-with-ai/example-prompts/).

![Trang AI Chat với một cuộc trò chuyện, kết quả công cụ và một thẻ xác nhận](https://nexcmp.com/vi/docs/images/configure-with-ai/overview-01-ai-chat.webp)

## Hạn mức & lưu ý {#limits-notes}

- **Bản demo và chế độ chỉ đọc.** Các trang vẫn hiển thị trên panel demo, nhưng không thể lưu bất kỳ thay đổi nào tại đó.
- **Không có shell.** Trợ lý chỉ có thể gọi các công cụ admin được liệt kê trong [Connect an AI client](https://nexcmp.com/vi/docs/configure-with-ai/mcp-admin/#tools). Trợ lý không thể chạy lệnh trên máy chủ.
- **Các module mạng và định tuyến** (BGP, XDP, interfaces, NAT và tương tự) đều ở chế độ chỉ đọc đối với AI; những phần nhạy cảm như tài khoản quản trị viên, bản sao lưu và cập nhật hoàn toàn không cho phép truy cập qua khóa.
- **Giá** được tính bằng USD: giá gói tính bằng đô la mỗi giờ, số dư tính bằng cent.
- **Chi phí.** Các câu trả lời của AI được thanh toán cho nguồn AI bạn kết nối (mức sử dụng API hoặc gói đăng ký của chính bạn). Trong AI Chat, bạn có thể đặt hạn mức chi tiêu hàng ngày. Về mô hình giấy phép NexCMP, xem https://nexcmp.com/pricing.

## Xử lý sự cố {#troubleshooting}

| Hiện tượng | Nguyên nhân | Cách khắc phục |
|---|---|---|
| AI Chat thông báo chưa kết nối nguồn AI | Chưa thiết lập nguồn cho tài khoản admin của bạn | Mở System › Settings › AI accounts và kết nối một nguồn. |
| Trợ lý phản hồi `insufficient_scope` | Khóa hoặc kết nối thiếu scope cho công cụ đó | Tạo một khóa với scope cần thiết, hoặc kết nối lại và đánh dấu chọn nó trên màn hình chấp thuận. Xem [Admin API keys](https://nexcmp.com/vi/docs/configure-with-ai/admin-api-keys/#errors). |
| Mọi thay đổi đều hiển thị thẻ xác nhận | Đúng như dự kiến trong AI Chat | Nhấn **Confirm** để áp dụng hoặc **Reject** để hủy bỏ. |
| Thao tác ghi thất bại với `demo_read_only` | Panel đang ở chế độ demo | Sử dụng bản cài đặt không phải demo. |