# Como escrever boas instruções para um agente de IA

*Por MAIA Tecnologia em 2026-10-19 · Estratégia & IA · 4 min de leitura*

> Guia prático para escrever o prompt de um agente de atendimento: estrutura, escopo, exemplos, regras de exceção e erros comuns que prejudicam as respostas.

As instruções do agente, também chamadas de prompt, são o manual de trabalho que a IA lê a cada conversa. Instruções ruins produzem agentes confusos, repetitivos ou fora do escopo. Instruções boas fazem a diferença entre um assistente confiável e um que exige correção constante.

Neste artigo, você entenderá uma estrutura simples para escrever instruções e os erros que mais atrapalham.

---

## 1. Estrutura recomendada

1. **Papel:** quem o agente é e a quem atende.
2. **Objetivo:** o que ele deve alcançar na conversa.
3. **Escopo:** o que faz e o que não faz.
4. **Tom de voz:** como se comunica.
5. **Fluxo:** passos esperados, como acolher, entender a necessidade e conduzir ao próximo passo.
6. **Regras e exceções:** o que fazer em casos específicos e quando transferir para uma pessoa.
7. **Exemplos:** respostas boas e ruins para calibrar.

---

## 2. Escreva com clareza

- **Frases diretas e afirmativas:** "Faça uma pergunta por vez" funciona melhor do que "tente não fazer muitas perguntas".
- **Prioridades explícitas:** indique o que é mais importante quando regras entram em conflito.
- **Evite ambiguidade:** "às vezes", "talvez" e "se achar necessário" deixam o agente sem critério.
- **Uma regra por linha** facilita a revisão.

---

## 3. Erros comuns

- Instruções longas demais, com informações repetidas e contraditórias.
- Misturar conhecimento da empresa com comportamento. Preços e políticas ficam melhor na base de conhecimento, que é mais fácil de atualizar.
- Esquecer de definir o que fazer quando o agente não sabe.
- Não prever tentativas de desviar o assunto.

---

## 4. Teste com casos reais

Depois de escrever, teste com conversas parecidas com as que acontecem no dia a dia: perguntas confusas, clientes impacientes, pedidos fora do escopo. Cada falha mostra uma regra que faltou ou ficou ambígua.

---

## 5. Revise por versões

Mantenha registro das mudanças e, ao alterar, entregue o texto completo atualizado em vez de remendos soltos, para que a leitura continue coerente. Ajustes pequenos e frequentes funcionam melhor do que reescritas grandes.

**Dica prática:** depois de escrever as instruções, peça a alguém da equipe que leia o texto e descreva, com as próprias palavras, o que o agente deve fazer. Se a explicação divergir do que você pretendia, há ambiguidade a corrigir. Essa leitura por uma segunda pessoa encontra falhas que o autor dificilmente percebe.

---

## Conclusão

Boas instruções são claras, enxutas e testadas. Trate o prompt como um documento vivo: ele melhora a cada conversa analisada e é a base do comportamento do seu agente.

---

## Sobre a MAIA
A **MAIA** (Maia Tecnologia LTDA · CNPJ 60.433.326/0001-34) é uma empresa brasileira de tecnologia focada na criação e operação de agentes de inteligência artificial autônomos.

Conheça as soluções da MAIA:
- [Plataforma MAIA](https://okmaia.com/): criação, personalização de prompts, subagentes e orquestração de IA.
- [Agente de IA para WhatsApp](https://okmaia.com/agente-ia-whatsapp): integração oficial à WhatsApp Business Cloud API para vendas, suporte e atendimento.
- [Mentoria Digital](https://okmaia.com/mentor-ia): transforme infoprodutos, cursos e métodos em atendimento individual pelo WhatsApp.

Saiba mais em: https://okmaia.com/