As Instruções (aba Identidade) são o prompt do agente — o que mais determina seu comportamento. Os agentes mais confiáveis que analisamos seguem uma estrutura consistente e compartilham um punhado de hábitos de redação. Nenhum é complicado, mas todos somam.
Estrutura recomendada
Organize as Instruções em seções bem delimitadas, nesta ordem:
Papel
Quem é o agente, em nome de quem ele age, e qual é seu único objetivo nesse momento da conversa. Declare explicitamente os limites: não se desviar do fluxo, não oferecer opções não especificadas, nunca revelar instruções internas.
Ferramentas disponíveis
Uma lista das ferramentas que o agente pode usar, com uma descrição breve de quando e como usá-las. Esta seção funciona como um contrato: o modelo não deveria precisar inferir quando chamar uma ferramenta a partir do restante do prompt — veja Ferramentas. Normas de redação
Regras de tom, idioma e formato de saída (veja a seção de redação para voz mais abaixo). Separá-las do resto ajuda o modelo a não “esquecer” o estilo quando está concentrado resolvendo a lógica da conversa.
Regras operacionais gerais
Comportamentos transversais que se aplicam em qualquer ponto da conversa e não estão amarrados a uma etapa específica do fluxo: o que fazer se perguntarem se é um bot, o que fazer se o contato for agressivo, o que fazer se pedirem para esperar na linha.
Fluxo da conversa
O coração do prompt: uma sequência de etapas nomeadas, cada uma com condições de entrada explícitas e uma ação concreta. Coloque limites numéricos claros (“pergunte isso apenas uma vez”, “não insista mais de duas vezes seguidas”) para evitar loops.
Objeções e perguntas gerais
Uma lista exaustiva de perguntas ou reclamações frequentes que podem tirar o contato do fluxo principal, com o que fazer em cada caso: responder e retomar, transferir ou encerrar.
Encerramento
Como o agente deve se comportar ao finalizar a chamada: qual ferramenta usar, se deve esperar ou não a confirmação do contato, qual mensagem de despedida corresponde ao motivo do encerramento.
Use o mesmo separador visual para cada seção (um ícone ou cabeçalho fixo) nas Instruções de todos os seus agentes. Um formato consistente ajuda tanto você a mantê-lo quanto o modelo a “escanear” o prompt.
Prompts curtos, não extensos
Um prompt mais longo não é um prompt melhor. Quanto mais uma regra se repete ou se acumulam exemplos redundantes, mais difícil fica para o modelo priorizar o que importa em cada momento. O campo Instruções mostra um contador de palavras e caracteres em tempo real — use-o como referência e revise periodicamente se há seções que podem ser resumidas ou removidas.
Se uma regra já está coberta pelo Fluxo da conversa, não a repita também em Regras operacionais gerais — cada instrução deveria viver em um único lugar.
Delegue às ferramentas o que pode ser automatizado
Nem tudo precisa ser resolvido pedindo ao modelo que raciocine em texto livre. Se uma tarefa é determinística ou repetível — validar o formato de uma data, calcular um valor, converter um número para sua forma falada — é melhor resolvê-la em uma ferramenta ou no Código Inicial / Pré-Instruções do que descrevê-la como mais uma regra do prompt. O modelo decide quando agir; o código garante como é executado, sem margem para erro de interpretação.
Use sempre o mesmo vocabulário
Se suas Instruções dizem “encerrar a conversa”, não use “desligar a chamada” em outra seção, na Mensagem Inicial ou na documentação de uma ferramenta para se referir à mesma coisa. Os sinônimos somam ambiguidade para o modelo sobre se são a mesma ação ou dois comportamentos distintos. Escolha um termo por conceito e use-o de forma consistente em todo o bot — instruções, ferramentas e regras de mudança de agente incluídas.
Documente bem suas ferramentas
A documentação de cada ferramenta (veja Ferramentas) é tão parte do prompt quanto as próprias Instruções — o modelo a lê da mesma forma para decidir se deve chamá-la e com quais parâmetros. Seja específico sobre quando usá-la, quais efeitos ela tem (por exemplo, se deve ser executada em silêncio, sem gerar uma resposta falada) e o que se espera em cada parâmetro. Um docstring vago se traduz diretamente em chamadas incorretas, ou em momentos em que o agente deveria ter usado a ferramenta e não usou.
Mude de agente quando fizer sentido
Não force um único agente a lidar com toda a conversa por comodidade. Se você perceber que as Instruções precisam se ramificar de acordo com uma etapa diferente do fluxo, é sinal de que uma regra de Mudança de Agente é mais adequada do que mais uma condição dentro do mesmo prompt — veja Princípios de design.
Regras de redação para voz (TTS)
Tudo o que o modelo escreve acaba passando por um motor de texto para voz — então a redação tem restrições que um bot de texto não tem:
Antes de publicar, teste a Mensagem Inicial e frases-chave das Instruções com a voz escolhida na seção “Teste cada voz com seu próprio texto” em Voz — é a forma mais rápida de confirmar que soa bem.