プロンプトの例

管理画面での場所： AI Chat（/agent）または任意の管理画面ページのフローティングのAsk AIボタン。MCP経由で接続された任意のAIクライアントでも同じプロンプトが動作します。

動作内容

これらのプロンプトは質問の仕方の例を示しています。それぞれ、アシスタントが裏側で実行する処理、必要なスコープ（外部クライアントまたはキーの場合）、および承認を求められる場所が記載されています。例の値を独自の値に置き換えてください。

チャットテキストに機密情報を入力しないでください

パスワード、APIキー、トークンには、AI Chat入力欄の隣にあるSecretフィールドを使用します（詳細）。AIには値そのものではなく、機密情報を表すプレースホルダーのみが表示されます。外部AIクライアントを使用する場合、機密情報は経由するため、管理画面での入力を優先してください。

現在の状態を確認する

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

アシスタントはsetup_checklistとsystem_healthを呼び出し（スコープadmin:read）、実際の状態に基づいて回答します。Setup progress checklistを参照してください。

初期セットアップ

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クラスターの追加

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トークンID（user@realm!tokenid）とそのシークレットを要求します。シークレットをSecretフィールドに入力してください。最初に制限付きトークンを作成します：Proxmox VE。
2. proxmox_add、proxmox_test、zone_create、proxmox_attach_zoneを呼び出します。
3. plans_from_offeringsを使用してプランを提案し、承認を待ちます（次の例を参照）。

スコープ：infra:write、secrets:write、catalog:write、admin:read。

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.

アシスタントはplans_from_offeringsを呼び出し、margin_pct 40と原価を指定します。マージンとは販売価格に占める利益の割合です。40%の場合、原価$60のプランは$100で販売されます。最初の呼び出しではプレビューのみが返されます。承認すると、ツールをapply=trueで再度呼び出します。これによりプランがワンステップで作成され、価格が関係するため1回の確認が求められます。Proxmoxの場合、backend_idとデフォルトのサイズリスト（1、2、2、4 vCPU）を使用します。スコープ: catalog:write、admin:read。Plansを参照してください。

メールの設定とテストメッセージの送信

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を参照してください。

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は常に2段階のアクションです：シークレット値がマスクされたプレビューが表示され、それを承認します。その後、payment_testがStripeで資格情報を確認します。スコープ：billing:write、secrets:write。テスト決済が成功した後にのみライブモードに切り替えてください。Stripeを参照してください。

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.

アシスタントはtelegram_configureとtelegram_testを呼び出します。スコープ：settings:write、secrets:write。Telegram notificationsを参照してください。

顧客の検索とクレジットの追加

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と理由を指定して呼び出します。これには必ず承認が必要です：確認カードには「顧客残高を変更します」と表示され、金額と監査ログに記録される理由が表示されます。スコープ：admin:read、billing:write。

設定のエクスポート

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を参照してください。スコープ：admin:read。

効果的なプロンプトの作成

• 目的と事実（名前、価格、メールアドレスなど）を伝えてください。機密情報を貼り付けないでください。
• 費用が発生する操作やデータを削除する操作については、事前にプレビューを求めてください。
• アシスタントに「変更する前に現在の値を読み取る」よう依頼してください。組み込みの指示ですでに指定されています。
• 回答がおかしいと感じた場合は、「どのツールをどのような引数で呼び出しましたか？」と尋ねてください。AI Chatのツールカードに両方が表示されます。

トラブルシューティング

症状	原因	対処法
アシスタントが「そのようなツールはない」と答える	そのツールのスコープが許可されていないか、アクションがAIに対して禁止されています	Admin API keysを確認するか、管理画面で行ってください。
パスワードの入力を求めてくる	モデルが指示を無視した	拒否し、Secretフィールドを使用するか、管理画面で値を入力してください。
「do it」を実行しても何も変わらない	変更が確認待ちの状態になっている	確認カードまでスクロールし、Confirmを押してください。
予期しない価格でプランが作成された	プロンプト内のコストまたはマージンが間違っていた	Plansページでプランを編集するか、アシスタントに価格の再設定を依頼してください。価格変更には確認が必要です。