Exemplos de prompts

Onde encontrar no painel: AI Chat (/agent) ou o botão flutuante Ask AI em qualquer página administrativa. Os mesmos prompts funcionam em qualquer cliente de IA conectado via MCP.

O que faz

Estes prompts mostram como perguntar. Cada um lista o que o assistente faz nos bastidores, os escopos necessários (para um cliente externo ou uma chave) e onde sua aprovação é solicitada. Substitua os valores de exemplo pelos seus.

Nunca digite um segredo no texto do chat

Para senhas, chaves de API e tokens, use o campo Secret ao lado da entrada do AI Chat (details). A IA vê apenas um espaço reservado que representa o segredo, e não o valor. Com um cliente de IA externo, o segredo passa por esse cliente, portanto, prefira inseri-lo no painel administrativo.

Verifique onde você está

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

O assistente chama setup_checklist e system_health (escopo admin:read) e responde com base no estado real. Consulte Setup progress checklist.

Primeira configuração

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.

Isso é o mesmo que o prompt do MCP initial-setup. Requer admin:read mais os escopos das etapas aceitas. Espere um cartão de confirmação para cada alteração no AI Chat.

Adicionar um 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.

O que acontece:

1. O assistente solicita o ID do token de API (user@realm!tokenid) e seu segredo. Coloque o segredo no campo Secret. Crie um token limitado primeiro: Proxmox VE.
2. Ele chama proxmox_add, proxmox_test, zone_create e proxmox_attach_zone.
3. Ele propõe planos com plans_from_offerings e aguarda sua aprovação (consulte o próximo exemplo).

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

Criar uma tabela de planos com margem de 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.

O assistente chama plans_from_offerings com margin_pct 40 e seus custos. Margem é a parcela do preço de venda que corresponde ao lucro: a 40%, um plano que custa $60 para você é vendido por $100. A primeira chamada retorna apenas uma prévia. Quando você aprova, ela chama a ferramenta novamente com apply=true, o que cria os planos em uma única etapa e solicita uma confirmação, pois há preços envolvidos. Para o Proxmox, ela usa backend_id e uma lista de tamanhos padrão (1, 2, 2 e 4 vCPUs). Escopos: catalog:write, admin:read. Consulte Plans.

Configurar e-mail e enviar uma mensagem de teste

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.

O assistente chama smtp_get, smtp_configure e smtp_test e informa se a mensagem foi aceita. Escopos: settings:write, secrets:write. Consulte SMTP and e-mail templates.

Configurar o 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 é sempre uma ação em duas etapas: você visualiza uma prévia com os valores secretos mascarados e a aprova. Em seguida, payment_test verifica as credenciais com o Stripe. Escopos: billing:write, secrets:write. Alterne para o modo de produção apenas após um pagamento de teste. Consulte Stripe.

Ativar alertas do 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.

O assistente chama telegram_configure e telegram_test. Escopos: settings:write, secrets:write. Consulte Telegram notifications.

Encontrar um cliente e adicionar crédito

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.

O assistente chama customers_search e customer_get (somente leitura), e depois customer_adjust_balance com delta_cents 1000 e um motivo. Isso sempre requer sua aprovação: o cartão de confirmação diz "changes a customer balance" e mostra o valor e o motivo que serão registrados no log de auditoria. Escopos: admin:read, billing:write.

Exportar minha configuração

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

O assistente chama config_export. Os segredos são substituídos por referências secret://. Salve o resultado como nexcmp.yaml e mantenha-o no controle de versão. Consulte Configuration as code. Escopo: admin:read.

Escrever bons prompts

• Forneça o objetivo e os fatos: nomes, preços, endereços de e-mail. Não cole segredos.
• Peça uma prévia primeiro para qualquer coisa que custe dinheiro ou exclua dados.
• Peça ao assistente para "ler o valor atual antes de alterá-lo". As instruções integradas já dizem isso.
• Se uma resposta parecer incorreta, pergunte "qual ferramenta você chamou e com quais argumentos?". Os cartões de ferramenta no AI Chat mostram ambos.

Resolução de problemas

Sintoma	Causa	Correção
O assistente diz que não tem ferramenta para algo	O escopo para essa ferramenta não foi concedido ou a ação está fechada para a IA	Verifique Admin API keys ou faça isso no painel admin.
Ele pede para você colar uma senha	O modelo ignorou as instruções	Recuse; use o campo Secret ou insira o valor no painel admin.
Nada muda após "fazer isso"	As alterações estão aguardando sua confirmação	Role até o cartão de confirmação e pressione Confirm.
Planos foram criados a um preço que você não esperava	Os custos ou a margem no prompt estavam incorretos	Edite os planos na página Plans ou peça ao assistente para precificá-los novamente; alterações de preço exigem confirmação.