Pular para o conteúdo principal

​
Erros frequentes

Estes são os erros que mais vemos se repetir ao revisar bots — a maioria é fácil de evitar assim que você sabe que existem.
Se você escrever {variable} na Mensagem Inicial ou nas Instruções e essa variável não chegou ao context — nem pelo arquivo de campanha nem pelo Código Inicial — ela fica vazia durante a conversa em vez de gerar um erro visível. Antes de publicar, verifique se toda variável que você usa está de fato mapeada ou inicializada. Veja Variáveis disponíveis.
As etiquetas são predefinidas pela Inceptia, mas é o agente Pós-Conversa que as atribui — e só consegue fazer isso se seu prompt incluir a lista completa com uma descrição clara de quando usar cada uma.
As condições são avaliadas na ordem em que são carregadas — a primeira que se cumpre define o destino. Se você tem condições que poderiam se sobrepor, a mais específica precisa vir primeiro. Veja Mudança de Agente.
Um agente que negocia, valida identidade e lida com objeções ao mesmo tempo tem um prompt difícil de manter e um comportamento menos previsível. Veja quando vale a pena dividir em vários agentes.
Se a documentação de uma ferramenta não explica com clareza quando usá-la, o LLM vai chamá-la no momento errado — ou não chamá-la quando deveria.
Se em uma seção você diz “encerrar a conversa” e em outra “desligar a chamada” para se referir à mesma coisa, o modelo pode interpretar como duas ações distintas. Escolha um termo por conceito e mantenha-o em todo o bot.
Quebra a naturalidade da síntese de voz. Veja as regras de redação para TTS.
Uma alteração em Produção afeta imediatamente as conversas em andamento. Sempre teste primeiro em Modo Rascunho, incluindo casos-limite, com Abrir conversa.

​
Checklist antes de publicar

1

Cada agente tem um único objetivo claro?

Se o prompt mistura várias etapas da conversa, avalie dividi-lo.
2

O Papel do agente declara seus limites explicitamente?

Não se desviar do fluxo, não revelar instruções internas.
3

Cada ferramenta tem uma descrição clara de quando e como usá-la?

Incluindo se deve ser executada em silêncio.
4

As regras de redação para voz estão definidas?

Números por extenso, formato de perguntas, datas faladas.
5

As objeções frequentes do caso de uso estão cobertas?

Com uma ação concreta para cada uma: responder e retomar, transferir ou encerrar.
6

Existem limites explícitos de tentativas?

Para evitar loops — por exemplo, “não insista mais de duas vezes”.
7

As etiquetas estão no prompt do classificador, se o seu bot as usa?

Sem isso, a classificação pós-conversa não vai funcionar bem.
8

Os dados de negócio estão parametrizados como variáveis, e não hardcoded no prompt?

Isso é o que permite reutilizar o design do bot em outras campanhas.
9

Você testou o bot no Modo Rascunho cobrindo o caminho principal e os casos-limite?

Antes de passar para Produção.
Este checklist não substitui um teste exaustivo do bot no Rascunho, mas ajuda a detectar cedo as lacunas de design mais frequentes.