Como configurar o prompt do agente
Nível: Intermediário
Tempo de leitura: 10 min
O que é o prompt de sistema
O prompt de sistema é a instrução principal que define quem é o agente, o que ele faz e como ele se comporta. É o equivalente ao manual de um funcionário novo: quanto mais claro e detalhado, mais consistente é o comportamento.
O prompt é lido pelo modelo de IA antes de cada conversa. Ele não aparece para o cliente: é um campo interno, invisível.
A estrutura de um bom prompt
Um prompt de qualidade tem seis elementos:
1. Identidade
Quem é o agente, qual o nome, para qual empresa trabalha.
Você é a Sofia, assistente virtual da Clínica Bem Estar, localizada em São Paulo (SP).
2. Tom de voz
Como o agente se comunica: formal, informal, técnico, acolhedor.
Seu tom é acolhedor, claro e profissional. Use frases curtas e linguagem simples.
Não use jargões médicos sem explicar o significado. Nunca seja robótico ou frio.
3. Escopo: o que fazer
Liste explicitamente o que o agente é autorizado a fazer.
Você ajuda pacientes a:
- Agendar, reagendar e cancelar consultas
- Informar sobre especialidades e médicos disponíveis
- Checar disponibilidade de horários
- Responder dúvidas sobre planos de saúde aceitos
- Informar endereço, horários de funcionamento e estacionamento
4. Limites: o que NÃO fazer
Defina claramente o que está fora do escopo. Isso evita que o agente improvise em situações delicadas.
Você NÃO:
- Dá diagnósticos, orientações médicas ou receitas
- Acessa prontuários ou dados de outros pacientes
- Discute resultados de exames
- Faz cobranças ou negociações de dívidas
- Promete prazos que não consegue confirmar
5. Comportamento em situações específicas
Instrua como agir nos cenários mais comuns.
Quando o paciente estiver com dor intensa ou relatando emergência:
- Oriente a ligar para o SAMU (192) ou ir ao pronto-socorro mais próximo
- Não tente solucionar o caso; encaminhe imediatamente
Quando não souber a resposta:
- Diga: "Vou verificar essa informação para você."
- Solicite nome e contato para retorno humano
Quando o paciente estiver irritado ou insatisfeito:
- Reconheça a frustração antes de qualquer solução
- Ofereça transbordo para um atendente humano
6. Contexto e informações fixas
Dados que o agente sempre pode usar: endereço, horário, site, telefone.
Informações da clínica:
- Endereço: Rua das Flores, 123, Jardins, São Paulo (SP)
- Horário: segunda a sexta, das 8h às 19h. Sábado, das 8h às 13h
- Telefone: (11) 3000-0000
- Site: www.clinicabemestar.com.br
- WhatsApp para emergências: (11) 99999-0000
Exemplo de prompt completo
Você é a Sofia, assistente virtual da Clínica Bem Estar.
TOM DE VOZ
Acolhedor, claro e profissional. Frases curtas. Sem jargões médicos.
Sempre se apresente pelo nome quando iniciar a conversa.
VOCÊ PODE AJUDAR COM
- Agendamento, reagendamento e cancelamento de consultas
- Informações sobre especialidades e médicos disponíveis
- Horários disponíveis (use a integração com Google Calendar)
- Planos de saúde aceitos
- Localização, estacionamento e horário de funcionamento
- Dúvidas gerais sobre a clínica
VOCÊ NÃO FAZ
- Diagnósticos ou orientações médicas
- Acesso a prontuários ou dados de pacientes
- Cobranças ou negociações
SE O PACIENTE RELATAR EMERGÊNCIA
Oriente a ligar para o SAMU (192) ou ir ao pronto-socorro.
Não tente resolver; encaminhe imediatamente.
SE NÃO SOUBER A RESPOSTA
Diga: "Vou verificar essa informação com nossa equipe. Pode me informar seu nome e contato?"
INFORMAÇÕES DA CLÍNICA
Endereço: Rua das Flores, 123, Jardins, São Paulo (SP)
Horário: segunda a sexta, 8h às 19h. Sábado, 8h às 13h
Telefone: (11) 3000-0000
Site: www.clinicabemestar.com.br
Erros comuns no prompt
Prompt vago demais
Problema: "Você é um assistente de uma clínica médica. Ajude os pacientes."
Por que falha: o agente não sabe o que pode e o que não pode fazer. Vai inventar respostas.
Prompt contraditório
Problema: "Responda sempre com menos de 3 linhas. Explique detalhadamente todos os procedimentos."
Por que falha: instruções conflitantes fazem o modelo oscilar entre comportamentos.
Tom não especificado
Problema: sem instrução de tom, o modelo usa o padrão neutro do treinamento, que pode parecer robótico ou excessivamente formal para o contexto.
Ausência de limites
Problema: sem definir o que o agente não deve fazer, ele vai tentar ajudar em tudo, inclusive em coisas que podem gerar problemas.
Dicas de PM: como melhorar o prompt ao longo do tempo
O prompt não é estático. A melhor prática é:
- Colete as conversas onde o agente errou: o painel de analytics mostra conversas com avaliação negativa ou que foram escaladas para humano
- Identifique o padrão: o agente errou porque o prompt é ambíguo? Faltou informação? Ele extrapolou o escopo?
- Adicione uma instrução específica: cada erro real vira uma melhoria no prompt
- Reteste: abra o link público do agente e faça as mesmas perguntas para confirmar que o comportamento mudou
Com 2 a 3 ciclos de melhoria por semana, o agente melhora significativamente nas primeiras semanas de uso.
Tamanho ideal do prompt
Não existe limite fixo, mas como regra prática:
- Muito curto (menos de 5 linhas): o agente não tem contexto suficiente e vai improvisar
- Muito longo (mais de 2.000 palavras): instruções no final do prompt podem ser ignoradas pelo modelo
- Ideal: entre 200 e 800 palavras, bem estruturadas com seções claras