Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt

Use this file to discover all available pages before exploring further.

Quando um projeto tem vários workflows, o AI Routing decide automaticamente qual executar para cada mensagem recebida. Em vez de rotear por palavras-chave exatas, o sistema compara semanticamente a mensagem com o nome e a descrição de cada workflow e escolhe a melhor correspondência — similar a um coordenador que lê o contexto completo antes de atribuir uma tarefa.

​
Como funciona

As mensagens iniciais são comparadas automaticamente com o nome e a descrição de todos os workflows do projeto. O sistema escolhe o workflow cujo propósito mais se aproxima do que o usuário está perguntando e o executa. Se nenhum workflow for adequado, o workflow de fallback é executado.
O AI Routing é configurado em dois níveis: no nível do projeto (estratégia geral e habilitação) e no nível do workflow (nome, descrição e regras de execução individuais).

​
Configuração por projeto

A página de AI Routing em Ajustes centraliza a configuração de roteamento para cada projeto. Selecione o projeto no seletor do lado esquerdo para ver todos os cartões de configuração.
Página de AI Routing em Ajustes com seletor de projeto, estratégia de implantação e workflows configurados

​
Estratégia de implantação

Esta seção só aparece se o projeto ainda tiver intenções legadas configuradas.
Define como o tráfego é distribuído em direção ao AI Routing. Escolha entre dois modos: Porcentagem ativa — use o slider ou o campo numérico para definir que porcentagem de usuários usará AI Routing. O restante continua com as intenções legadas.
  • 0 % → todo o tráfego usa intenções legadas
  • 100 % → todo o tráfego usa AI Routing
  • Útil para fazer uma migração progressiva sem desligar o sistema anterior de uma só vez
Número de telefone — insira uma lista específica de números que poderão testar o AI Routing. Os demais usuários continuam com o sistema legado. Ideal para validar o roteamento com um grupo controlado antes de abri-lo a 100 %.

​
Workflow de fallback

Selecione no menu suspenso o workflow que será executado quando o AI Routing não conseguir determinar uma intenção clara, ou quando o AI Routing estiver desabilitado. Clique em Salvar para aplicar a alteração.

​
Exportar descrições

Baixe um arquivo com a lista de todos os workflows do projeto e suas descrições atuais. Escolha entre formato Markdown ou Excel conforme seu fluxo de trabalho. Útil para revisar ou auditar a qualidade das descrições que o AI Routing usa para rotear.

​
Workflows com AI Router

O cartão inferior mostra todos os workflows do projeto divididos em dois grupos — os que já têm AI Routing configurado e os que ainda não têm — com um indicador de status:
  • Ponto verde — o workflow tem descrição e o AI Routing pode usá-lo para rotear.
  • Ponto laranja — o workflow não tem descrição; o AI Routing não conseguirá selecioná-lo corretamente.
Clique em qualquer workflow para abri-lo diretamente no canvas e configurá-lo.
Workflows sem descrição não são roteados corretamente. Se você vir pontos laranjas, adicione uma descrição clara a esses workflows a partir do nó Start.

​
Configuração por workflow

Acesse o painel de configuração a partir do nó Start de qualquer workflow. O painel tem três abas.
Painel de configuração do nó Start com aba AI Router e modal de testar roteamento

​
Aba AI Router

Configure o nome e a descrição que o sistema usa para rotear mensagens para este workflow.
CampoDescriçãoLimite
NomeIdentificador curto do workflow. Deve descrever de forma concisa o que ele faz.50 caracteres
DescriçãoExplica em detalhes quando este workflow deve ser executado e que tipo de mensagens ele atende. Quanto mais específica, mais preciso o roteamento.5.000 caracteres
Workflow de fallbackMarca este workflow como destino padrão quando nenhum outro workflow corresponder à mensagem. Só pode haver um workflow de fallback por projeto.—
Escreva descrições claras e específicas: que tipos de solicitações o workflow atende, que problemas resolve e em quais contextos deve ser executado. Quanto mais detalhada for a descrição, mais preciso será o roteamento.

​
Testar roteamento

Antes de publicar, verifique se as mensagens são roteadas para o workflow correto diretamente nesta aba.
1

Abra o painel de testes

Clique em Testar roteamento. O modal de avaliação é aberto.
2

Insira as mensagens a avaliar

Escreva uma ou várias frases no campo de texto, ou baixe o modelo, preencha-o com as mensagens que deseja avaliar e faça upload para testar em volume.
3

Interprete os resultados

Para cada mensagem avaliada você verá:
  • Workflow selecionado: o workflow para o qual a mensagem seria roteada.
  • Raciocínio: breve explicação de por que esse workflow foi escolhido.
  • Indicador de correspondência: verde se a mensagem corresponde ao workflow que está sendo testado, cinza se corresponde a outro workflow do projeto, âmbar se não houve nenhuma correspondência e o workflow de fallback será executado.

​
Aba Avançado

Configure regras de execução que restringem quando e para quem o workflow é ativado. Ocultar workflow — exclui este workflow do AI Routing. Quando oculto, o sistema nunca o selecionará automaticamente; ele só pode ser executado por meio de um redirecionamento forçado a partir de outro workflow.
Você não pode ocultar o workflow de fallback. Desative-o como workflow padrão antes de ocultá-lo.
As seguintes regras restringem a execução do workflow a usuários ou contextos específicos:
Restringe o workflow a um grupo específico de números de telefone. Somente os usuários da lista poderão ativá-lo, independentemente do conteúdo da mensagem.
  • Formato obrigatório: E.164 (ex. +5511999123456, +5215512345678)
  • Máximo de 20 entradas por workflow
  • Cada entrada inclui número de telefone e nome opcional para identificação
Se você ativar esta regra e um usuário fora da lista enviar uma mensagem, o workflow não será executado mesmo que o conteúdo corresponda semanticamente. A mensagem é roteada para o workflow de fallback.
Limita o workflow a usuários que se comunicam de certos países, usando o prefixo telefônico internacional.
  • Exemplos: +55 (Brasil), +57 (Colômbia), +52 (México), +593 (Equador)
  • Você pode selecionar vários prefixos simultaneamente
  • Se o número do usuário não corresponder a nenhum prefixo, a mensagem é roteada para o workflow de fallback

​
Aba Intenções Legacy

Esta aba só aparece se a conta ainda tiver intenções configuradas.
Se 100 % do tráfego já usa AI Routing, as intenções legadas não têm efeito. Você pode mantê-las como reserva durante a transição.
Gerencie as frases-chave do sistema de roteamento anterior. Essas intenções ativavam o workflow antes de o AI Routing estar disponível e são mantidas para projetos que migram gradualmente usando a estratégia de implantação por porcentagem.

​
Migrar de intenções legadas

Os projetos que ainda usam o sistema de intenções legadas verão o botão Migrar projeto na página de AI Routing em Ajustes. Ao abrir a janela de migração, o sistema usa as intenções configuradas em cada workflow para inferir automaticamente uma descrição inicial — a mesma que o AI Routing usará para rotear mensagens.
Janela de migração de projeto com descrições inferidas e controle de porcentagem de implantação
1

Abra a janela de migração

Na página de AI Routing, clique no botão Migrar projeto. A janela exibe todos os workflows do projeto junto com a quantidade de intenções legadas associadas a cada um.
2

Revise as descrições inferidas

A lista mostra cada workflow com sua quantidade de intenções e a descrição inferida a partir delas. Revise cada descrição e ajuste as que não refletem com precisão o propósito do workflow — quanto mais clara for a descrição, mais preciso será o roteamento.
3

Defina a porcentagem de implantação

Ajuste o slider para determinar que porcentagem do tráfego começará a usar AI Routing. O tráfego restante continuará usando as intenções legadas. Comece com um valor baixo — entre 10 % e 20 % — para validar o roteamento antes de escalar.
4

Confirme a migração

Clique em Migrar. A porcentagem configurada entra em vigor imediatamente. Você pode ajustá-la a qualquer momento na seção Estratégia de implantação.
Antes de aumentar a porcentagem, use Testar roteamento a partir do nó Start de cada workflow para verificar se as mensagens são roteadas corretamente com AI Routing.
As intenções legadas não são excluídas durante a migração. Elas permanecem ativas para a porcentagem do tráfego que ainda não usa AI Routing.

​
Casos de uso

Um projeto com workflows de suporte (devoluções, reclamações), vendas (catálogo, preços) e pagamentos (faturamento, métodos de pagamento): o AI Routing analisa a mensagem do usuário e a direciona para o workflow correto sem menus ou botões de seleção. O workflow de fallback lida com consultas ambíguas com uma resposta genérica.
Uma empresa com três linhas de produto configura um workflow por linha, cada um com uma descrição detalhada dos problemas que atende. As mensagens que mencionam sintomas específicos chegam diretamente ao workflow especializado sem que o usuário precise indicar o produto.
Uma equipe de atendimento ao cliente ativa a lista de usuários permitidos no seu workflow de suporte premium. Somente os números registrados como VIP acessam esse workflow; os demais usuários são atendidos pelo workflow padrão.
Uma equipe que já tem intenções configuradas usa a estratégia de implantação por porcentagem para migrar gradualmente. Começa com 20 % do tráfego no AI Routing, valida os resultados com o painel de testes e aumenta a porcentagem semana a semana até chegar a 100 %.

Publicar versões

Implante seu projeto com o AI Routing configurado em produção.

Histórico de versões

Revise e restaure versões anteriores da sua configuração.

Execuções de workflow

Monitore como os workflows roteados são executados em produção.

Nó AI Agent

Configure o AI Agent dentro de cada workflow para processar as mensagens roteadas.