> ## 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.
# AI Routing
> Configure o roteamento inteligente de conversas para que cada mensagem chegue ao workflow correto automaticamente.
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.
### 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 %.
### Tomada de controle
Define quando o AI Router assume o controle da conversa. É útil para lidar com usuários que iniciam com uma saudação antes de expor sua dúvida real.
Escolha entre dois modos:
**Roteamento imediato** — o AI Router tenta encaminhar o usuário desde sua primeira mensagem. Ideal quando seus usuários costumam escrever diretamente sua dúvida sem preâmbulos.
**Filtrar saudações** — o sistema ignora mensagens curtas de cortesia como "Oi" ou "Bom dia" e aguarda detectar uma intenção real antes de rotear o usuário. Com este modo ativo, você pode configurar dois valores adicionais:
| Campo | Descrição |
| ------------------- | --------------------------------------------------------------------------------------------- |
| **Tempo de espera** | Segundos que o sistema aguarda sem detectar intenção antes de enviar uma mensagem ao usuário. |
| **Mensagem padrão** | Texto enviado ao usuário quando o tempo de espera vence sem que uma intenção seja detectada. |
### 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.
### Aba AI Router
Configure o nome e a descrição que o sistema usa para rotear mensagens para este workflow.
| Campo | Descrição | Limite |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------- |
| **Nome** | Identificador curto do workflow. Deve descrever de forma concisa o que ele faz. | 50 caracteres |
| **Descrição** | Explica 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 fallback** | Marca 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.
Clique em **Testar roteamento**. O modal de avaliação é aberto.
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.
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.
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.
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.
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.
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 %.
Implante seu projeto com o AI Routing configurado em produção.
Revise e restaure versões anteriores da sua configuração.
Monitore como os workflows roteados são executados em produção.
Configure o AI Agent dentro de cada workflow para processar as mensagens roteadas.
### Estratégia de implantação
### Aba AI Router
Configure o nome e a descrição que o sistema usa para rotear mensagens para este workflow.
| Campo | Descrição | Limite |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------- |
| **Nome** | Identificador curto do workflow. Deve descrever de forma concisa o que ele faz. | 50 caracteres |
| **Descrição** | Explica 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 fallback** | Marca este workflow como destino padrão quando nenhum outro workflow corresponder à mensagem. Só pode haver um workflow de fallback por projeto. | — |
