> Editor visual em canvas para desenhar fluxos passo a passo, com versões, publicação e comparação — recurso avançado. # Flows Um **flow** é um fluxo desenhado em um canvas visual, onde cada nó é uma ação ou uma decisão. Ele descreve, passo a passo, um comportamento mais rígido — um menu de opções, uma sequência de perguntas, um roteiro de diagnóstico. > **Atenção.** > **Recurso avançado — não é como a IA responde hoje.** Em produção, o atendimento é conduzido pela **persona + base de conhecimento + ferramentas** do agente, não por flows. O editor de flows existe e é completo, mas os fluxos **não estão no caminho da conversa real** no momento. Trate esta seção como um recurso avançado/preview: útil de conhecer, opcional de usar. ## A tela `/flows` A lista mostra cada flow com nome, tipo e última edição, mais indicadores de total, publicados e rascunhos. Os estados de um flow são: | Estado | Significa | |--------|-----------| | **rascunho** | Em edição — é onde você trabalha | | **publicado** | Versão promovida para produção | | **arquivado** | Versões anteriores, preservadas | ## Criar um flow — 2 passos Em `/flows/new`: 1. **Identidade.** Nome, slug, tipo (**Main** — invocável pelo agente / **Sub-flow** — chamado por outros flows) e uma descrição que a IA lê para decidir quando usar o flow. 2. **Contrato.** Os **parâmetros de entrada** e o **retorno** do flow (pode ficar vazio e ser definido depois no editor). Ao criar, você vai para o editor de canvas. ## O editor de canvas Em `/flows/[id]/edit`, o editor tem três colunas: - **Paleta** (esquerda) — os tipos de nó que você arrasta para o canvas, agrupados por categoria (Fluxo, Conversa, Voz, Inteligência, Cliente, Ações, Dados). Alguns nós são marcados **Só voz** e outros ficam em modo avançado. - **Canvas** (centro) — onde você conecta os nós. Salva sozinho a cada poucos segundos. - **Inspetor** (direita) — a configuração do nó selecionado. Pode alternar para o **painel de teste**. No topo há **Testar**, **Exportar/Importar** (JSON), **Histórico**, **Salvar** e **Publicar**, além de badges que mostram a versão em rascunho e a versão publicada. ## Testar o flow O **Modo Teste** simula uma conversa (WhatsApp ou Voz), realça os nós executados no canvas e mostra um trace técnico com a ordem dos nós e as variáveis finais. Use mocks de cliente para experimentar sem tocar em dados reais. ## Versões — publicar, comparar, reverter Você edita **sempre num rascunho** — a versão publicada nunca é alterada direto. 1. **Publicar** promove o rascunho para produção e arquiva a versão publicada anterior. Você pode escrever notas da versão. (Requer a permissão de publicar flows.) 2. **Histórico** (`/flows/[id]/history`) lista todas as versões, com quem publicou e quando. 3. **Comparar** (`/flows/[id]/compare`) mostra o diff entre duas versões — nós e conexões adicionados, removidos ou modificados. 4. **Reverter** (rollback) volta uma versão anterior para produção. > **Nota.** > **Comece pela base de conhecimento.** Antes de desenhar um flow, veja se o problema não se resolve com uma boa entrada na [base de conhecimento](/ambiente-ia/conhecimento) — quase sempre resolve, e dá muito menos manutenção. ## Próximo passo → [Ferramentas (Tools)](/ambiente-ia/tools) → [Boas práticas](/ambiente-ia/boas-praticas)