> ## Documentation Index
> Fetch the complete documentation index at: https://docs.inceptia.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Instruções que funcionam
> Como estruturar o prompt de um agente para que o LLM não se perca
## O campo com mais impacto
As Instruções (aba [Identidade](/pt-BR/construccion/agentes/identidad)) 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:
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.
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](/pt-BR/construccion/agentes/herramientas).
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.
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.
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.
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.
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](/pt-BR/construccion/agentes/logica) 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](/pt-BR/construccion/agentes/herramientas)) é 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](/pt-BR/construccion/agentes/cambio-de-agente) é mais adequada do que mais uma condição dentro do mesmo prompt — veja [Princípios de design](/pt-BR/construccion/buenas-practicas/principios-de-diseno).
***
## 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:
| Regra | Por quê |
| ----------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Números por extenso** ("mil e quinhentos reais", não "1500") | Evita que o motor de voz os leia de forma estranha. |
| **Perguntas sem pontuação de abertura incomum** | Muitos motores de síntese usam a pontuação para decidir a entonação; pontuação de abertura fora do padrão pode gerar resultados inconsistentes. |
| **Datas faladas, não escritas** ("doze de setembro", não "12/09") | Soa natural em uma conversa de curta duração; omita o ano a menos que o contexto exija. |
| **Evite vícios de linguagem repetidos** ("entendo", "perfeito") | Se destacam como um padrão artificial quando se repetem na mesma chamada. |
| **Não comece duas mensagens seguidas da mesma forma** | Ajuda a conversa a não soar roteirizada. |
| **Tom de acordo com o canal** | Um bot de voz pode (e geralmente deve) soar mais coloquial do que um de texto — dentro dos limites de profissionalismo que seu caso de uso exigir. |
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](/pt-BR/construccion/voz) — é a forma mais rápida de confirmar que soa bem.