Prompt mẫu

Vị trí trong admin: AI Chat (/agent) hoặc nút nổi Ask AI trên bất kỳ trang admin nào. Các prompt tương tự cũng hoạt động trong mọi AI client được kết nối qua MCP.

Chức năng

Các prompt này hướng dẫn cách yêu cầu trợ lý. Mỗi prompt liệt kê những việc trợ lý thực hiện ngầm, các scope cần thiết (cho client bên ngoài hoặc key) và nơi bạn được yêu cầu phê duyệt. Hãy thay thế các giá trị ví dụ bằng giá trị của bạn.

Không bao giờ nhập secret vào nội dung chat

Đối với mật khẩu, API key và token, hãy sử dụng trường Secret bên cạnh ô nhập AI Chat (chi tiết). AI chỉ nhìn thấy placeholder đại diện cho secret chứ không thấy giá trị thực. Với AI client bên ngoài, secret sẽ đi qua client đó, vì vậy bạn nên ưu tiên nhập trong admin.

Kiểm tra tiến trình hiện tại

Check my setup progress and tell me the next three things to do, in order.

Trợ lý gọi setup_checklist và system_health (scope admin:read) và trả lời từ trạng thái thực tế. Xem Checklist tiến trình cài đặt.

Thiết lập ban đầu

Help me finish the initial setup. Go through the checklist, explain each open step
in one sentence, ask me for what you need, and show me every change before it is applied.

Prompt này tương đương với prompt MCP initial-setup. Nó cần admin:read cùng với scope của các bước mà bạn chấp nhận. Mỗi thay đổi sẽ xuất hiện một thẻ xác nhận trong AI Chat.

Thêm cluster Proxmox VE

I want to sell servers from my Proxmox VE cluster at https://pve.example.com:8006.
Add it, test the connection, create a zone called "New York" in the US, attach the cluster
to it, and then propose starter plans.

Điều gì sẽ diễn ra:

1. Trợ lý sẽ yêu cầu API token id (user@realm!tokenid) và secret của nó. Hãy nhập secret vào trường Secret. Trước tiên, hãy tạo một token bị giới hạn quyền: Proxmox VE.
2. Nó gọi proxmox_add, proxmox_test, zone_create và proxmox_attach_zone.
3. Nó đề xuất các plan bằng plans_from_offerings và chờ bạn phê duyệt (xem ví dụ tiếp theo).

Scope: infra:write, secrets:write, catalog:write, admin:read.

Tạo bảng plan với biên lợi nhuận 40%

Suggest a starter plan table from my CloudStack offerings. My costs are $4 per vCPU per month,
$2 per GB of RAM per month and $0.08 per GB of disk per month. Use a 40% margin, show me the
table with cost, price per month and price per hour, and create the plans only after I approve.

Trợ lý gọi plans_from_offerings với margin_pct 40 cùng chi phí của bạn. Biên lợi nhuận là tỷ lệ phần trăm lợi nhuận trên giá bán: ở mức 40%, một plan có chi phí $60 sẽ được bán với giá $100. Lần gọi đầu tiên chỉ trả về bản xem trước. Khi bạn phê duyệt, trợ lý sẽ gọi lại công cụ với apply=true để tạo các plan trong một bước và yêu cầu một lần xác nhận vì có liên quan đến giá bán. Đối với Proxmox, trợ lý sử dụng backend_id cùng danh sách cấu hình mặc định (1, 2, 2 và 4 vCPU). Scope: catalog:write, admin:read. Xem Plans.

Cấu hình email và gửi thư thử nghiệm

Configure outgoing email with smtp.example.com, port 587, STARTTLS, user "mailer@example.com",
sender name "Example Cloud", sender address "no-reply@example.com". Use my Secret field for the
password "smtp_password". Then send a test email to admin@example.com.

Trợ lý gọi smtp_get, smtp_configure và smtp_test, sau đó thông báo cho bạn biết thư đã được chấp nhận hay chưa. Scope: settings:write, secrets:write. Xem SMTP và mẫu email.

Thiết lập Stripe

Set up Stripe in test mode. My publishable key is pk_test_XXXX. Use the secret key and the
webhook secret from my Secret field (names stripe_secret_key and stripe_webhook_secret).
Then test the credentials and tell me which webhook URL I must add in Stripe.

payment_configure luôn là thao tác gồm hai bước: bạn xem bản xem trước với các giá trị bí mật được ẩn và phê duyệt. Sau đó payment_test kiểm tra thông tin xác thực với Stripe. Scopes: billing:write, secrets:write. Chỉ chuyển sang chế độ live sau khi thanh toán thử nghiệm. Xem Stripe.

Bật cảnh báo Telegram

Add my Telegram chat 123456789 for admin alerts. The bot token is in my Secret field as
telegram_bot_token. Send a test message.

Trợ lý gọi telegram_configure và telegram_test. Scopes: settings:write, secrets:write. Xem Thông báo Telegram.

Tìm khách hàng và nạp credit

Find the customer with e-mail customer@example.com, show me their balance and servers,
and add $10.00 of credit because of the outage on Monday.

Trợ lý gọi customers_search và customer_get (chỉ đọc), sau đó gọi customer_adjust_balance với delta_cents 1000 và lý do. Thao tác này luôn cần bạn phê duyệt: thẻ xác nhận hiển thị "changes a customer balance" cùng số tiền và lý do sẽ được ghi vào audit log. Scopes: admin:read, billing:write.

Xuất cấu hình của tôi

Export my whole configuration as YAML. Do not include secrets. Then tell me which settings
differ from a typical new installation.

Trợ lý gọi config_export. Các secret được thay bằng tham chiếu secret://. Lưu kết quả dưới dạng nexcmp.yaml và đưa vào hệ thống kiểm soát phiên bản. Xem Cấu hình dưới dạng mã. Scope: admin:read.

Viết prompt hiệu quả

• Cung cấp mục tiêu và dữ kiện cụ thể: tên, giá, địa chỉ email. Không dán secret.
• Luôn yêu cầu xem trước đối với bất kỳ thao tác nào tốn chi phí hoặc xóa dữ liệu.
• Yêu cầu trợ lý "đọc giá trị hiện tại trước khi thay đổi". Hướng dẫn tích hợp sẵn đã quy định điều này.
• Nếu câu trả lời có vẻ không đúng, hãy hỏi "bạn đã gọi tool nào và với đối số nào?". Các thẻ tool trong AI Chat hiển thị cả hai.

Xử lý sự cố

Hiện tượng	Nguyên nhân	Cách khắc phục
Trợ lý báo không có tool cho tác vụ nào đó	Scope cho tool đó chưa được cấp, hoặc tác vụ không mở cho AI	Kiểm tra Admin API keys, hoặc thực hiện trong admin.
Trợ lý yêu cầu bạn dán mật khẩu	Mô hình đã bỏ qua hướng dẫn	Từ chối; sử dụng trường Secret hoặc nhập giá trị trong admin.
Không có gì thay đổi sau lệnh "do it"	Các thay đổi đang chờ bạn xác nhận	Cuộn đến thẻ xác nhận và nhấn Confirm.
Các gói dịch vụ được tạo với mức giá ngoài dự kiến	Chi phí hoặc biên lợi nhuận trong prompt bị sai	Chỉnh sửa các gói trên trang Plans hoặc yêu cầu trợ lý định giá lại; thay đổi giá sẽ yêu cầu xác nhận.