---
title: Exemplos de prompts
description: Prompts prontos para AI Chat ou cliente de IA: setup inicial, Proxmox, planos com margem, SMTP, Stripe, Telegram, créditos e exportação de configuração.
url: https://nexcmp.com/pt/docs/configure-with-ai/example-prompts/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Exemplos de prompts {#example-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](https://nexcmp.com/pt/docs/configure-with-ai/mcp-admin/).

## O que faz {#what-it-does}

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.

::: tip 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](https://nexcmp.com/pt/docs/configure-with-ai/ai-chat-in-admin/#secrets)). 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-where-you-are}

```text
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](https://nexcmp.com/pt/docs/configure-with-ai/setup-checklist/).

## Primeira configuração {#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.
```

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 {#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.
```

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](https://nexcmp.com/pt/docs/infrastructure/proxmox/).
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% {#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.
```

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](https://nexcmp.com/pt/docs/catalog/plans/).

![Resposta do AI Chat mostrando uma tabela de prévia dos planos com custo, preço mensal e preço por hora](https://nexcmp.com/pt/docs/images/configure-with-ai/example-prompts-01-plan-preview.webp)

## Configurar e-mail e enviar uma mensagem de teste {#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.
```

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](https://nexcmp.com/pt/docs/administration/smtp-and-emails/).

## Configurar o 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` é 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](https://nexcmp.com/pt/docs/billing/stripe/).

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

O assistente chama `telegram_configure` e `telegram_test`. Escopos: `settings:write`, `secrets:write`. Consulte [Telegram notifications](https://nexcmp.com/pt/docs/administration/telegram-notifications/).

## Encontrar um cliente e adicionar crédito {#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.
```

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-configuration}

```text
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](https://nexcmp.com/pt/docs/configure-with-ai/config-as-code/). Escopo: `admin:read`.

## Escrever bons prompts {#write-good-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 {#troubleshooting}

| 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](https://nexcmp.com/pt/docs/configure-with-ai/admin-api-keys/#what-a-key-can-never-do) 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. |