Como escrever um bom prompt de sistema
Nível: Intermediário
Tempo de leitura: 9 min
Por que o prompt importa tanto
O prompt de sistema é a instrução principal do agente. É ele que define a personalidade, o escopo, os limites e o comportamento em situações específicas. Um agente com prompt ruim vai responder de forma genérica, ultrapassar os limites que você quer impor ou simplesmente não performar o que você precisa, independente do modelo de IA escolhido.
Mudar o prompt é a ação de maior impacto que você pode tomar para melhorar um agente.
A estrutura de um prompt eficaz
Um bom prompt de sistema tem quatro blocos principais:
1. Identidade
Diga quem o agente é, com nome e personalidade. Seja específico no tom.
Você é a Sofia, assistente virtual da Clínica Bem Estar.
Seu tom é acolhedor, claro e profissional. Você trata os
pacientes pelo primeiro nome quando possível e evita
linguagem técnica desnecessária.
2. Escopo: o que o agente DEVE fazer
Liste as responsabilidades com clareza. Use verbos de ação.
Você ajuda os pacientes a:
- Agendar, reagendar e cancelar consultas
- Tirar dúvidas sobre especialidades e médicos disponíveis
- Informar sobre convênios aceitos
- Orientar sobre localização e horários de atendimento
- Enviar instruções de preparo para exames
3. Limites: o que o agente NÃO deve fazer
Esse bloco é tão importante quanto o anterior. Sem limites explícitos, o modelo tende a "improvisar" e responder sobre tudo.
Você NÃO:
- Dá diagnósticos ou orientações médicas
- Informa valores de consultas sem verificar a tabela atualizada
- Acessa ou comenta prontuários de outros pacientes
- Faz promessas sobre resultados de tratamentos
4. Comportamentos específicos
Defina como o agente deve agir em situações recorrentes.
Quando não souber a resposta, diga:
"Vou verificar essa informação para você. Posso te retornar
em instantes ou prefere que eu te transfira para um atendente?"
Quando o paciente parecer angustiado, priorize acolhimento
antes de passar informações práticas.
Quando houver urgência médica mencionada, oriente
imediatamente a buscar atendimento presencial ou ligar para
o SAMU (192).
Erros comuns e como evitar
Prompt vago demais
Ruim:
Você é um assistente prestativo de uma clínica médica.
Responda dúvidas dos pacientes.
Por que falha: o agente não sabe o que pode e o que não pode fazer. Vai responder sobre qualquer assunto, inclusive coisas que você não quer.
Bom:
Você é a Sofia, assistente virtual da Clínica Bem Estar.
[identidade + escopo + limites + comportamentos]
Prompt contraditório
Ruim:
Seja breve e direto. Sempre forneça respostas completas
e detalhadas com todos os contextos necessários.
Por que falha: o modelo não sabe qual instrução priorizar e pode alternar entre comportamentos inconsistentes.
Bom: escolha um e seja consistente. Se precisar de respostas longas em alguns casos e curtas em outros, especifique as condições.
Escopo indefinido
Ruim:
Responda sobre nossa empresa.
Por que falha: o agente não sabe quais partes da empresa cobrir, como responder perguntas que estão fora dos documentos e quando transferir para um humano.
Bom: liste explicitamente os assuntos cobertos e o que fazer quando a pergunta estiver fora deles.
Ausência de instruções para situações difíceis
Defina o comportamento para pelo menos três cenários:
- O agente não sabe a resposta
- O usuário está insatisfeito ou agressivo
- A situação requer intervenção humana
Técnicas avançadas
Exemplos dentro do prompt
Para comportamentos muito específicos, use exemplos de diálogo:
Exemplo de como responder sobre preços:
Usuário: "Quanto custa uma consulta de ortopedia?"
Agente: "Os valores variam conforme o convênio e o
profissional. Pode me informar seu plano de saúde? Assim
consigo te dar a informação correta."
Persona consistente
Se o agente tem nome e personalidade, mantenha isso ativo ao longo do prompt. Não misture "você deve" com "a Sofia deve": escolha uma voz e mantenha.
Instruções de formato
Se quiser respostas em formato específico, diga isso:
Quando listar horários disponíveis, use o formato:
- Segunda: 08h, 10h, 14h
- Terça: 09h, 11h, 15h
Nunca liste mais de 5 opções por vez.
Testando o prompt
Depois de escrever, teste com pelo menos estas categorias de perguntas:
- Perguntas que estão dentro do escopo
- Perguntas que estão fora do escopo (o agente deve recusar adequadamente)
- Perguntas ambíguas (o agente deve pedir esclarecimento)
- Situações de exceção (cliente insatisfeito, urgência, assunto sensível)
- Perguntas sobre o próprio agente ("você é um robô?")
Veja o guia completo de testes em: Como testar o agente antes de publicar →
Iterando o prompt
Um prompt nunca está terminado. Analise as conversas reais, identifique onde o agente errou e ajuste. As causas mais comuns de erros são:
- Falta de informação na base de conhecimento (solução: adicionar documentos)
- Instrução ausente no prompt (solução: adicionar o comportamento desejado)
- Instrução contraditória no prompt (solução: revisar e simplificar)
Veja como acompanhar a evolução em: Como monitorar e melhorar o agente ao longo do tempo →