Pular para o conteúdo principal

​
O que é a mudança de agente

Quando um bot tem múltiplos agentes, ele precisa saber quando passar de um para outro. A aba Mudança de Agente é onde você configura essas regras de transferência — se você ainda não tem claro quando vale a pena dividir seu bot em vários agentes, veja Princípios de design. Cada regra tem duas partes:
  1. Motivo da mudança — uma descrição em linguagem natural de quando a mudança deve ocorrer. O LLM usa esse texto para decidir, durante a conversa, se deve disparar a mudança.
  2. Destino — para qual agente a conversa é transferida. Pode ser um destino fixo, ou pode depender de uma ou mais condições sobre variáveis do contexto (veja abaixo).
Aba Mudança de Agente com uma regra configurada (recolhida)

​
Como adicionar uma regra

1

Abra a aba Mudança de Agente

Dentro do editor do agente, clique na aba Mudança de Agente.
2

Clique em Adicionar mudança de agente

Uma nova regra é adicionada, expandida e vazia.
3

Escreva o Motivo da mudança

Descreva em linguagem natural quando a mudança deve ocorrer. Seja específico — o LLM usa esse texto para tomar a decisão. Por exemplo: “quando o cliente confirma o pagamento mínimo”.
4

Escolha o destino

Se a mudança sempre vai para o mesmo agente, selecione-o diretamente em Transferir para. Se o destino depende de uma variável, adicione uma ou mais condições (próxima seção).

​
Conectar agentes arrastando no Canvas

Você também pode iniciar uma regra de mudança de agente sem entrar nesta aba: diretamente do canvas, aproximando o cursor da borda direita de um nó.
1

Aproxime o cursor da borda direita do agente de origem

Aparece uma seta azul de conexão.Seta de conexão ao aproximar o cursor da borda de um nó
2

Arraste a seta até o agente destino

Enquanto você arrasta, é desenhada uma linha pontilhada entre os dois agentes.Arrastando a conexão de um agente para outro
3

Solte sobre o agente destino

Abre-se o painel Criar transferência — o mesmo formulário que você já viu acima (Motivo da mudança, condições opcionais, Transferir para), só que já vem com o destino pré-carregado.Painel Criar transferência aberto a partir do canvas, com origem e destino pré-carregados
4

Preencha o Motivo da mudança e crie a regra

Igual a como se você tivesse montado pela aba Mudança de Agente.
É a mesma regra, duas formas de criá-la: pela aba Mudança de Agente do agente de origem, ou arrastando no canvas. Use a que for mais prática dependendo se você já está vendo o fluxo completo ou editando um agente específico.

​
Exemplos de Motivo da mudança

O Motivo da mudança mais eficaz descreve a intenção do contato, não o texto exato que ele pode dizer. O LLM é flexível na interpretação — você não precisa cobrir todas as variações de uma frase.

​
Condições baseadas em variáveis do contexto

Além do Motivo da mudança, cada regra pode ter uma ou mais condições que comparam diretamente uma variável do contexto com um valor — sem precisar descrever em linguagem natural nem escrever código:
  • Variável — o nome da variável (uma do arquivo de campanha, ou uma que você calculou na aba Lógica).
  • Operador — a comparação a aplicar (=, >, <, entre outros).
  • Valor — o valor com o qual é comparada.
Você pode adicionar várias comparações dentro de uma mesma condição com Adicionar comparação, e várias condições com Adicionar condição — cada condição aponta para o seu próprio agente destino em Transferir para. Se nenhuma condição for cumprida, o bot transfere para o agente padrão que você definir (opcional). Por exemplo, para direcionar de acordo com pago_minimo (uma variável numérica que vem do arquivo de campanha):

​
Ordem de avaliação

O bot avalia as condições na ordem em que são carregadas: a primeira que se cumpre define o agente destino. Se nenhuma se cumprir, é usado o agente padrão (se você configurou um). Tenha isso em mente ao ordenar condições que possam se sobrepor — a mais específica deveria vir primeiro. É um dos erros mais comuns ao montar essas regras — veja Erros comuns.
Antes de publicar, use Abrir conversa para simular diferentes valores de contexto e confirmar que cada regra dispara a mudança de agente correta.