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

# Princípios de design

> Os critérios que diferenciam um bot que funciona bem de um que não funciona, aprendidos construindo bots de voz em produção

## Bots que funcionam

Esta seção resume os padrões que identificamos analisando bots da Inceptia já em produção — não é teoria genérica de IA, são os critérios concretos que separam um bot bem projetado de um que se comporta de forma inconsistente. Recomendamos ler antes de mergulhar em [construir seu agente](/pt-BR/construccion/agentes/canvas).

<CardGroup cols={3}>
  <Card title="Princípios de design" icon="compass" href="/pt-BR/construccion/buenas-practicas/principios-de-diseno">
    As regras gerais antes de escrever a primeira linha de um prompt.
  </Card>

  <Card title="Instruções que funcionam" icon="pen-to-square" href="/pt-BR/construccion/buenas-practicas/instrucciones-que-funcionan">
    Como estruturar o prompt de um agente para que o LLM não se perca.
  </Card>

  <Card title="Erros comuns" icon="list-check" href="/pt-BR/construccion/buenas-practicas/errores-comunes">
    Os erros mais frequentes ao construir um bot, e o checklist antes de publicar.
  </Card>
</CardGroup>

***

## Um objetivo por agente

Cada agente dentro do bot deveria ter uma única responsabilidade clara — validar identidade, negociar um pagamento, classificar uma chamada. Quando um agente tenta fazer coisas demais ao mesmo tempo, o prompt fica difícil de manter e o modelo começa a improvisar nas bordas.

<Tip>
  Se você perceber que suas Instruções precisam de seções do tipo "se estamos na etapa X, faça A; se estamos na etapa Y, faça B", é sinal de que provavelmente vale a pena dividir isso em dois agentes com uma transição explícita entre eles — veja [Mudança de Agente](/pt-BR/construccion/agentes/cambio-de-agente) — em vez de resolver com condicionais dentro de um mesmo prompt.
</Tip>

## Resolva a ambiguidade no prompt, não deixe para o modelo

Os bots de melhor desempenho não dizem "seja empático e lide com a situação": eles antecipam explicitamente os caminhos possíveis da conversa e indicam ao modelo o que fazer em cada um, incluindo quantas vezes insistir antes de encerrar ou transferir. Tudo o que ficar ambíguo, o modelo vai resolver de um jeito diferente em cada chamada.

## Projete para o ouvido, não para a vista

Um bot de voz não se lê, se escuta. As regras de redação (números por extenso, formato de perguntas, comprimento das respostas) não são um detalhe estético — determinam se o bot soa natural ou robótico. Veja o detalhe completo em [Instruções que funcionam](/pt-BR/construccion/buenas-practicas/instrucciones-que-funcionan).

## Separe o dado do comportamento

As informações específicas de cada campanha ou cliente (nome, valor, datas, nome da empresa) deveriam viver em variáveis — nunca hardcoded no prompt. Isso permite reutilizar o mesmo design de bot para múltiplas campanhas ou clientes sem tocar na lógica. Veja [Variáveis disponíveis](/pt-BR/construccion/agentes/identidad) e [Arquivo de entrada de campanha](/pt-BR/construccion/archivo-entrada-campana).

## Antecipe o pior caso, não só o caminho feliz

Grande parte da robustez de um bot está em como ele lida com o inesperado: o contato agressivo, a pergunta fora do assunto, o silêncio, a secretária eletrônica, a data inválida, a recusa categórica. Se esses casos não estiverem cobertos explicitamente nas Instruções, o bot vai resolvê-los de forma inconsistente.

<Tip>
  Veja a lista de erros frequentes e o checklist antes de publicar em [Erros comuns](/pt-BR/construccion/buenas-practicas/errores-comunes).
</Tip>
