Pular para o conteúdo principal

O campo com mais impacto

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:
1

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.
2

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.
3

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.
4

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.
5

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.
6

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.
7

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.