Pular para o conteúdo principal

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.

Princípios de design

As regras gerais antes de escrever a primeira linha de um prompt.

Instruções que funcionam

Como estruturar o prompt de um agente para que o LLM não se perca.

Erros comuns

Os erros mais frequentes ao construir um bot, e o checklist antes de publicar.

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.
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 — em vez de resolver com condicionais dentro de um mesmo prompt.

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.

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 e Arquivo de entrada de campanha.

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.
Veja a lista de erros frequentes e o checklist antes de publicar em Erros comuns.