---
title: 提示詞範例
description: AI Chat 或您專屬 AI 客戶端的隨附即用提示詞：初始設定、新增 Proxmox、帶有毛利的方案表格、SMTP、Stripe、Telegram、客戶餘額與匯出您的設定。
url: https://nexcmp.com/zh-tw/docs/configure-with-ai/example-prompts/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# 提示詞範例 {#example-prompts}

> **管理員位置：**任意管理員頁面上的 AI Chat (`/agent`) 或浮動的 **Ask AI** 按鈕。透過 [MCP](https://nexcmp.com/zh-tw/docs/configure-with-ai/mcp-admin/) 連線的任何 AI 客戶端也適用相同的提示詞。

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

這些提示詞展示瞭如何提問。每一個提示詞都列出了助理在幕後執行的動作、它需要的權限範圍（針對外部客戶端或金鑰），以及系統會要求您批准的位置。請將範例數值替換為您自己的數值。

::: tip 切勿在聊天文字中輸入任何機密資料
密碼、API 金鑰與權杖請使用 AI Chat 輸入框旁邊的 **Secret** 欄位（[details](https://nexcmp.com/zh-tw/docs/configure-with-ai/ai-chat-in-admin/#secrets)）。AI 看到的僅是用於代表該機密資料的預留位置，而非實際數值。若使用外部 AI 客戶端，機密資料會透過該客戶端傳遞，因此建議優先在管理員介面中輸入。
:::

## 檢查您的目前狀態 {#check-where-you-are}

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

助理會呼叫 `setup_checklist` 與 `system_health`（範圍 `admin:read`）並根據真實狀態回答。請參閱 [Setup progress checklist](https://nexcmp.com/zh-tw/docs/configure-with-ai/setup-checklist/)。

## 初始設定 {#first-setup}

```text
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.
```

這與 MCP 提示詞 `initial-setup` 相同。它需要 `admin:read` 以及您接受的操作步驟範圍。在 AI Chat 中，每個變更都會出現確認卡片。

## 新增 Proxmox VE 叢集 {#add-a-proxmox-ve-cluster}

```text
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.
```

運作方式：

1. 助理會詢問 API token id (`user@realm!tokenid`) 及其密鑰。請將密鑰填入 **Secret** 欄位。請先建立一個權限受限的權杖：[Proxmox VE](https://nexcmp.com/zh-tw/docs/infrastructure/proxmox/)。
2. 它會呼叫 `proxmox_add`、`proxmox_test`、`zone_create` 與 `proxmox_attach_zone`。
3. 它會提出包含 `plans_from_offerings` 的方案並等待您的批准（請參閱下一個範例）。

範圍：`infra:write`、`secrets:write`、`catalog:write`、`admin:read`。

## 建立具有 40% 毛利的方案表格 {#create-a-plan-table-with-a-40-margin}

```text
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.
```

助理會呼叫`plans_from_offerings`，並帶入`margin_pct` 40與您的成本。利潤率是利潤佔售價的比例：在40%利潤率下，成本為$60的方案售價為$100。第一次呼叫僅會回傳預覽。在您核准後，它會再次呼叫該工具並帶入`apply=true`，一步完成方案建立，且因涉及價格會要求確認一次。針對Proxmox，它會使用`backend_id`與預設規格清單（1、2、2與4 vCPU）。Scopes：`catalog:write`、`admin:read`。請參閱[Plans](https://nexcmp.com/zh-tw/docs/catalog/plans/)。

![AI Chat 回答，顯示包含成本、月費與時費的方案預覽表格](https://nexcmp.com/zh-tw/docs/images/configure-with-ai/example-prompts-01-plan-preview.webp)

## 設定電子郵件並傳送測試訊息 {#configure-email-and-send-a-test-message}

```text
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.
```

助理會呼叫 `smtp_get`、`smtp_configure` 與 `smtp_test`，並告訴您訊息是否被接受。範圍：`settings:write`、`secrets:write`。請參閱 [SMTP and e-mail templates](https://nexcmp.com/zh-tw/docs/administration/smtp-and-emails/)。

## 設定 Stripe {#set-up-stripe}

```text
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` 始終是一個兩步驟動作：您會看到一個隱藏機密數值的預覽並予以批准。接著 `payment_test` 會向 Stripe 驗證憑證。範圍：`billing:write`、`secrets:write`。請僅在測試付款成功後再切換至正式環境。請參閱 [Stripe](https://nexcmp.com/zh-tw/docs/billing/stripe/)。

## 啟用 Telegram 警報 {#turn-on-telegram-alerts}

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

助理會呼叫 `telegram_configure` 與 `telegram_test`。範圍：`settings:write`、`secrets:write`。請參閱 [Telegram notifications](https://nexcmp.com/zh-tw/docs/administration/telegram-notifications/)。

## 尋找客戶並新增餘額 {#find-a-customer-and-add-credit}

```text
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.
```

助理會呼叫`customers_search`與`customer_get`（唯讀），接著呼叫`customer_adjust_balance`，並附帶`delta_cents` 1000與原因。這**一律**需要您的核准：確認卡片會顯示「changes a customer balance」，並呈現將記錄至稽核日誌的金額與原因。Scopes：`admin:read`、`billing:write`。

## 匯出我的設定 {#export-my-configuration}

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

助理會呼叫 `config_export`。機密資料會被替換為 `secret://` 參照。請將結果儲存為 `nexcmp.yaml` 並放入版本控制中。請參閱 [Configuration as code](https://nexcmp.com/zh-tw/docs/configure-with-ai/config-as-code/)。範圍：`admin:read`。

## 撰寫良好的提示詞 {#write-good-prompts}

- 提供目標與事實：名稱、價格、電子郵件地址。請勿貼上機密。
- 對於任何涉及金錢花費或刪除資料的操作，請先要求預覽。
- 請要求助理「在變更之前讀取目前的值」。內建指示已經這麼說了。
- 如果答案看起來不對，請詢問「你呼叫了哪個工具、帶了什麼參數？」。AI Chat 中的工具卡片兩者都會顯示。

## 故障排除 {#troubleshooting}

| 症狀 | 原因 | 修正方式 |
|---|---|---|
| 助理表示沒有對應功能的工具 | 該工具的範圍未授權，或者該動作對 AI 關閉 | 檢查 [Admin API keys](https://nexcmp.com/zh-tw/docs/configure-with-ai/admin-api-keys/#what-a-key-can-never-do)，或在管理員後台操作。 |
| 它要求您貼上密碼 | 模型忽略了指示 | 拒絕；請使用 Secret 欄位或在管理員後台輸入該值。 |
| 點擊「執行」後沒有任何變化 | 變更正在等待您的確認 | 捲動至確認卡片並按下 **Confirm**。 |
| 建立的方案價格不如預期 | 提示中的成本或利潤率錯誤 | 在方案頁面上編輯方案，或要求助理重新定價；變更價格需要確認。 |