> ## 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.
# Mapa do projeto
> Visualize o AI Router e todos os workflows em um único canvas dentro da visão Gerenciar workflows.
O **Mapa do projeto** é a visão visual dentro de **Gerenciar workflows** que mostra o **AI Router** conectado a todos os workflows do projeto. O nó do AI Router fica à esquerda, cada nó de workflow representa um workflow do projeto e as linhas representam as rotas que o roteador pode tomar. A partir dali você vê rapidamente quantos workflows tem, quais estão ativos, quais estão ocultos do roteador e como estão distribuídos por canal — sem sair da seção de workflows.
O mapa está disponível apenas em projetos com **AI Routing** ativo. Se o seu projeto não tem AI Routing, a seção **Gerenciar workflows** leva você para a lista tabular clássica.
## Como acessar
Entre no projeto onde você quer ver o mapa.
Na barra lateral, abra **Gerenciar workflows** (`/brain/projects/:projectId/workflows`).
Se o projeto tem AI Routing ativo, em telas maiores a visão abre com o mapa à esquerda e a lista de workflows à direita (em telas pequenas se agrupam em um switch — veja [Anatomia do mapa](#anatomia-do-mapa)).
Não é necessário configurar nada extra: o mapa é ativado automaticamente sempre que o AI Router está ligado.
## Anatomia do mapa
A tela é dividida em dois painéis redimensionáveis, cada um com seus próprios controles:
**Canvas à esquerda — grafo do roteador.** O **AI Router** aparece à esquerda; os workflows aparecem à direita, um por nó, conectados ao roteador por uma aresta. Cada nó mostra o nome do workflow e os ícones de todos os canais para os quais tem um canvas associado. Workflows ocultos aparecem atenuados com borda pontilhada; o workflow de backup recebe o badge **Backup** e uma borda pontilhada destacada.
No canto superior direito do canvas ficam os **chips de canal** (um por cada canal presente no projeto ou nos workflows) e o botão **Auto-organizar**; no canto inferior direito há um minimapa.
**Lista à direita — accordion de workflows.** Os mesmos workflows em formato de lista, com a mesma UX do card **Configurações → AI Routing**. No topo há um filtro com três opções: **Todos**, **AI Router** (apenas workflows que participam do roteador) e **Ocultos**, com a contagem de cada grupo. Cada linha mostra:
* Um **ponto de status** — verde se o workflow tem descrição, âmbar se não tem.
* O **nome** do workflow e uma descrição resumida (se for longa, um chevron à direita a expande dentro da linha).
* Badge **Backup** para o workflow padrão.
* Um **switch Ocultar/Mostrar no AI Routing**. O workflow padrão fica sempre ativo e não pode ser ocultado.
* Dois ícones que aparecem ao passar o cursor: **Configurações** abre o painel lateral com a configuração do workflow (mesmo painel que abre ao clicar em seu nó no canvas); **Link externo** abre o workflow no Studio, na mesma aba.
Clicar na linha em si não abre nada — apenas os ícones de hover e o chevron reagem.
Em telas pequenas, os dois painéis se agrupam em um switch entre as abas **Mapa** e **Workflows**.
## Principais interações
Clique no nó do mapa ou no ícone **Configurações** (hover) da linha para abrir o painel lateral com a configuração inline do workflow (mesmo painel do nó Start): nome, descrição, regras de roteamento e opções avançadas como allowlist de usuários, prefixo de país e agendamento. Para abrir o canvas completo do workflow, use o ícone de link externo — no cabeçalho do painel ou na própria linha.
Clique no nó do AI Router para abrir o painel de configuração do roteador. A partir dali você ajusta as configurações a nível de projeto e testa o roteamento com mensagens reais usando o botão **Testar roteamento** — o mapa destaca o workflow para o qual o roteador encaminharia cada mensagem. O ícone de link externo no cabeçalho leva você à tela completa de **AI Routing** em Configurações.
Você tem duas formas: usar o **switch** da linha do workflow, ou arrastar seu nó para o painel **Ocultos** (aparece à direita do canvas assim que houver ao menos um workflow oculto). Ambas fazem a mesma coisa — o workflow fica excluído do AI Router mas continua acessível pela visão. Para expô-lo novamente, ative o switch de volta ou arraste seu card do painel de ocultos para o mapa. Cada vez que a visibilidade muda, o mapa reorganiza os nós automaticamente para que nunca fiquem apertados.
Selecione um canal nos chips do canto superior direito do canvas. Apenas os workflows que têm canvas para esse canal são exibidos. O mapa faz *fitView* automaticamente ao trocar de canal para maximizar a visibilidade. Um segundo clique no canal ativo remove o filtro.
Use o filtro no topo da lista para alternar entre **Todos**, **AI Router** e **Ocultos**. O filtro afeta apenas a lista; o mapa mantém sua visão.
Você pode arrastar cada nó livremente e sua posição é mantida mesmo depois de selecionar outro nó ou o roteador. Para voltar ao layout automático, use o botão **Auto-organizar** no canto superior direito do canvas: ele reaplica o algoritmo Dagre LR e faz fitView.
Antes de publicar mudanças de visibilidade, rode **Testar roteamento** no painel do AI Router com mensagens reais da sua operação. O destaque no mapa mostra se uma mensagem que antes ia para um workflow agora cai no de backup por tê-lo ocultado.
## Casos de uso
Uma equipe prestes a lançar o projeto no WhatsApp e no Instagram: abre o mapa, filtra por cada canal com os chips e confirma que os workflows críticos aparecem em ambos. Workflows sem canvas para um canal desaparecem do canvas, então as lacunas de cobertura ficam evidentes de imediato.
Uma equipe que recebeu um chamado de um usuário cuja mensagem foi parar no workflow errado: abre o mapa, clica no AI Router, cola a mensagem real em **Testar roteamento** e vê destacado o workflow para o qual o roteador a encaminharia hoje. A partir dali ajusta a descrição ou as regras do workflow correto sem sair da vista.
Uma equipe que está construindo dois workflows novos que ainda não devem receber tráfego: os oculta com o switch ou arrastando-os para o painel **Ocultos**, mantém o restante da lista intacto e publica o projeto. Os workflows ocultos continuam editáveis pela lista e pelo mapa, mas o roteador não os considera até que sejam expostos novamente.
## Estados do mapa
**Projeto vazio.** Se o projeto não tem workflows, aparece um estado vazio convidando você a criar o primeiro.
**Um único workflow.** Se o projeto tem exatamente um workflow, o mapa não é desenhado: aparece um estado vazio com o CTA **Abrir workflow** que leva direto ao canvas dele.
**Todos os workflows ocultos.** Se todos os workflows estão ocultos, aparece um estado vazio indicando que nenhum workflow está exposto ao roteador; exponha ao menos um para recuperar o mapa.
## Perguntas frequentes
Não. A tela inicial do projeto continua a mesma. O mapa vive dentro de **Gerenciar workflows**, então você só o vê ao abrir essa seção.
Ocultar um workflow pelo mapa **sim** altera o roteamento em produção — mesmo efeito de ocultá-lo em Configurações → AI Routing — e passa a valer quando você publica o projeto. As demais interações com o mapa (mover nós, filtrar por canal, filtrar a lista) são puramente visuais e não afetam como o roteador decide.
Clique no nó do AI Router para abrir seu painel lateral e use o botão **Testar roteamento**. Digite mensagens reais; o mapa destaca o workflow para o qual o roteador encaminharia cada mensagem.
É intencional: o clique na própria linha não dispara nenhuma ação para que você possa selecionar texto ou rolar sem abrir o painel por acidente. Use o ícone **Configurações** para abrir a configuração inline, ou o ícone **Link externo** para saltar ao canvas do workflow no Studio.
## Conteúdo relacionado
Aprenda como o AI Routing é configurado no nível de projeto e de workflow — o recurso que habilita o mapa.