> ## Documentation Index
> Fetch the complete documentation index at: https://symphony-docs.fcamara.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Fluxos

> Encadeie agentes de IA para automatizar uma tarefa inteira, do começo ao fim, manualmente ou em horários definidos.

## O que é

Os **Fluxos** permitem **encadear agentes de IA** para automatizar uma tarefa inteira, do começo ao fim, sem precisar copiar e colar respostas de uma conversa para outra.

Pense numa linha de montagem: cada etapa recebe o resultado da etapa anterior, faz a sua parte e passa adiante. Por exemplo:

> **Contrato recebido** → um agente **resume** o documento → outro agente **aponta os riscos** → o resultado final fica salvo para você consultar.

Você monta esse caminho uma vez, arrastando blocos na tela, e depois executa quantas vezes quiser, manualmente ou de forma **automática**, em horários definidos.

## Como acessar

* Barra lateral → **Fluxos**
* Para criar: botão **Novo fluxo**.

<Note>
  A página só aparece se a permissão de **Fluxos** estiver habilitada para você. Se não encontrar o menu, fale com o administrador da sua empresa.
</Note>

A página **Fluxos** tem duas abas:

* **Meus fluxos** — os fluxos que você criou e os que foram compartilhados com você.
* **Templates** — modelos prontos, disponibilizados pela sua empresa, que você pode usar como ponto de partida.

## Conceitos básicos

| Termo | O que significa |
| - | - |
| **Fluxo** | O caminho completo da automação, do início ao fim. |
| **Nó** | Cada bloco (etapa) do fluxo. Ex.: um nó de **Agente** que resume um texto. |
| **Conexão** | A linha que liga um nó ao próximo. Ela define a ordem em que as etapas acontecem. |
| **Execução** | Cada vez que o fluxo roda. Cada execução fica registrada no **Histórico de execuções**. |
| **Saída** | O resultado que um nó entrega para o próximo. O resultado do último nó é o **Resultado final**. |

## Como utilizar

### 1. Criar um fluxo

<Steps>
  <Step title="Clique em Novo fluxo" />

  <Step title="Preencha os campos">
    * **Nome do fluxo** *(obrigatório)* — entre **3 e 60 caracteres**. Não pode repetir o nome de outro fluxo.
    * **Descrição** *(opcional)* — o objetivo do fluxo, em poucas palavras.
  </Step>

  <Step title="Clique em Criar">
    O editor do fluxo abre em seguida.
  </Step>
</Steps>

### 2. Conhecer o editor

O editor tem três áreas:

| Área | Para que serve |
| - | - |
| **Paleta de nós** (à esquerda) | Lista os tipos de bloco que você pode usar. |
| **Tela central** | Onde você monta o fluxo, arrastando e conectando os nós. |
| **Propriedades** (à direita) | Mostra as configurações do nó selecionado. |

Na barra superior ficam os botões **Desfazer**, **Refazer**, **Validar**, **Executar**, **Histórico de execuções**, **Ajuda** e **Salvar**. Ao lado do nome do fluxo, você vê se há **Alterações não salvas** ou se está **Tudo salvo**.

### 3. Montar o fluxo

<Steps>
  <Step title="Arraste um nó da paleta para a tela" />

  <Step title="Conecte os nós">
    Clique no ponto de conexão de um nó e arraste até o próximo.
  </Step>

  <Step title="Clique em um nó para configurá-lo no painel Propriedades" />

  <Step title="Repita até chegar ao nó de Saída" />
</Steps>

Todo fluxo precisa de **um nó de Início** e de **pelo menos um nó de Saída**.

### 4. Tipos de nó

| Nó | O que faz | Quando usar |
| - | - | - |
| **Início** | Onde o fluxo começa. Define se o fluxo recebe um texto ou arquivo e se roda sozinho em horários definidos. | Sempre: é o primeiro nó de todo fluxo. |
| **Agente** | Chama um agente com a saída do nó anterior. | Para qualquer etapa que a IA deve fazer: resumir, classificar, traduzir, revisar, extrair dados. |
| **Ferramenta** | Chama uma ferramenta com a saída do nó anterior. | Quando a etapa usa uma ferramenta cadastrada na plataforma. |
| **Condição** | Escolhe um caminho com base na saída do nó anterior. | Para decisões do tipo "se a resposta contém APROVADO, siga por aqui; senão, por ali". |
| **Paralelo** | Divide o fluxo em caminhos que rodam ao mesmo tempo. | Quando várias análises independentes podem acontecer juntas, o que economiza tempo. |
| **Mesclar** | Junta os resultados de caminhos paralelos. | Logo depois de um nó **Paralelo**. |
| **Sub-fluxo** | Executa outro fluxo como uma única etapa. | Para reaproveitar um fluxo que você já montou. |
| **Saída** | Encerra o fluxo e guarda o resultado final. | Sempre: é o último nó. |

### 5. Configurar cada nó

<AccordionGroup>
  <Accordion title="Início" icon="play">
    * **Entrada de conteúdo** — quando ativado, ao clicar em **Executar** abre uma janela para você **colar um texto** ou **enviar um arquivo** (PDF, DOCX, XLSX, CSV, TXT, MD, JSON, HTML, PPTX, EPUB, RTF). Esse conteúdo é o ponto de partida do fluxo. Desativado, o fluxo começa sem pedir nada.
    * **Modo de início**:
      * **Manual** — você decide a hora de rodar, clicando em **Executar**.
      * **Automático** — o fluxo roda sozinho, no agendamento definido:
        * **Intervalo** — a cada X horas (ex.: a cada 6 horas).
        * **Semanal** — nos **dias da semana** e no **horário** escolhidos. A tela mostra quando será a **próxima execução**.

    <Warning>
      No agendamento semanal, escolha **pelo menos um dia**. Sem isso, o fluxo nunca roda.
    </Warning>
  </Accordion>

  <Accordion title="Agente" icon="robot">
    * **Agente** — escolha um dos agentes que você pode usar. Se a lista estiver vazia, crie um agente primeiro (veja [Agentes](/guia/agentes)).
    * **Instruções** — diga o que o agente deve fazer nesta etapa. Ex.: *"Liste os três principais riscos deste contrato."* A saída do nó anterior é adicionada logo depois das suas instruções.
    * **Tempo limite (ms)** — tempo máximo de espera pela resposta, em milissegundos (1.000 ms = 1 segundo). Deixe vazio para não ter limite.
  </Accordion>

  <Accordion title="Ferramenta" icon="screwdriver-wrench">
    * **Ferramenta** e **Função** — a ferramenta e a função dela que serão chamadas.
    * **Argumentos (JSON)** — os dados enviados para a ferramenta. Use `{{input}}` para incluir a saída do nó anterior.
  </Accordion>

  <Accordion title="Condição" icon="code-branch">
    * **Comparação** — **Contém**, **Não contém**, **Igual**, **Não é igual**, **Começa com**, **Termina com** ou **Corresponde ao regex**.
    * **Valor a comparar** — o texto procurado na saída do nó anterior. Ex.: `APROVADO`.
    * **Diferenciar maiúsculas de minúsculas** — ative se "Aprovado" e "APROVADO" devem ser tratados como diferentes.

    Se a condição for verdadeira, o fluxo segue pela **saída de cima** do nó. Caso contrário, segue pela **saída de baixo**.

    <Tip>
      Para usar a Condição, peça ao agente anterior uma resposta padronizada. Ex.: *"Responda apenas APROVADO ou REPROVADO."*
    </Tip>
  </Accordion>

  <Accordion title="Paralelo" icon="arrows-split-up-and-left">
    Todos os caminhos que saem deste nó rodam ao mesmo tempo. Conecte **pelo menos duas saídas** e use um nó **Mesclar** depois para juntar os resultados.
  </Accordion>

  <Accordion title="Mesclar" icon="code-merge">
    O **Mesclar** espera todos os caminhos chegarem antes de seguir. Conecte **pelo menos duas entradas**. Em **Estratégia de mesclagem**, escolha como juntar:

    * **Concatenar** — junta os textos, um depois do outro.
    * **Array JSON** — transforma cada resultado em um item de uma lista (útil quando o próximo passo é técnico).
    * **Primeiro não vazio** — usa o primeiro caminho que tiver conteúdo.
  </Accordion>

  <Accordion title="Sub-fluxo" icon="diagram-project">
    Escolha outro fluxo para rodar como uma etapa deste. O sub-fluxo aceita até **5 níveis** (um fluxo dentro de outro, dentro de outro...). Se o mesmo fluxo aparecer duas vezes na sequência, a execução é bloqueada.
  </Accordion>

  <Accordion title="Saída" icon="flag-checkered">
    Em **Formato**, escolha **Texto simples** ou **JSON**.
  </Accordion>
</AccordionGroup>

<Note>
  Os nós de Agente e de Ferramenta também mostram um campo **Taxa de falha (%)** / **Chance de falha (%)**. Ele serve só para **testar** como o fluxo se comporta quando uma etapa falha. Deixe em **0** no uso normal.
</Note>

### 6. Validar e salvar

<Steps>
  <Step title="Clique em Validar">
    O Symphony confere se o fluxo está pronto.

    * **Validação aprovada** — o fluxo pode ser salvo e executado.
    * **Problemas de validação** — aparece a lista do que corrigir. Clique em um item para ir direto ao nó com problema.
  </Step>

  <Step title="Clique em Salvar">
    Ou use **Ctrl + S**.
  </Step>
</Steps>

Os problemas mais comuns:

| Mensagem | O que fazer |
| - | - |
| Adicione um nó de início para o fluxo começar. | Arraste um nó **Início** para a tela. |
| Seu fluxo tem mais de um nó de início. | Deixe só um nó **Início**. |
| Adicione um nó de saída para o fluxo terminar. | Arraste um nó **Saída** e conecte ao final. |
| O fluxo está em looping. | Remova a conexão que volta para um nó anterior. |
| Selecione um agente no nó "...". | Abra o nó indicado e escolha o agente. |
| Conecte pelo menos duas saídas / entradas no nó "...". | Os nós **Paralelo** e **Mesclar** precisam de pelo menos dois caminhos. |

### 7. Executar o fluxo

<Steps>
  <Step title="Salve o fluxo">
    O botão **Executar** só funciona com tudo salvo.
  </Step>

  <Step title="Clique em Executar" />

  <Step title="Informe o conteúdo, se pedido">
    Se o nó de Início tiver **Entrada de conteúdo** ativada, escolha:

    * **Texto** — cole ou digite o conteúdo.
    * **Arquivo** — clique ou arraste o arquivo. Espere o processamento: aparece uma **prévia do conteúdo extraído**.
  </Step>

  <Step title="Confirme">
    Durante a execução, cada nó mostra o próprio status na tela.
  </Step>
</Steps>

| Status | Significado |
| - | - |
| **Na fila** | Aguardando para começar. |
| **Executando** | Em andamento. |
| **Concluído** | Terminou com sucesso. |
| **Falhou** | Deu erro nesta etapa. |
| **Ignorado** | Não rodou, porque o fluxo seguiu por outro caminho (por exemplo, numa Condição). |
| **Cancelado** | A execução foi interrompida. |

Enquanto o fluxo roda, a edição fica bloqueada. Para interromper, clique em **Parar**. O nó que já estava em andamento termina antes de a execução parar.

### 8. Ver o resultado

Ao terminar, o painel lateral mostra:

* **Resultado final** — o que o fluxo entregou. Clique em **Ver completo** para ler tudo e baixar o resultado em **.txt** ou **.json**.
* **Nó selecionado** — clique em qualquer nó para ver a **Entrada recebida** e a **Saída** daquela etapa. Isso ajuda a entender onde um resultado saiu diferente do esperado.

Clique em **Fechar execução** para voltar ao editor.

### 9. Histórico de execuções

O botão **Histórico de execuções** lista todas as vezes que o fluxo rodou, com status e horário. Clique em uma execução para ver o resultado e o detalhe de cada etapa.

Quando um fluxo **automático** começa, termina ou falha, você recebe uma **notificação** na plataforma, com o botão **Abrir** para ver o resultado.

### 10. Gerenciar fluxos

No menu de cada fluxo, na lista:

| Ação | O que faz |
| - | - |
| **Editar** | Abre o editor. |
| **Clonar** | Cria uma cópia do fluxo, que você pode alterar à vontade. |
| **Compartilhar** | Libera o fluxo para **grupos** da sua empresa, com uma destas permissões: **Pode executar** (só roda o fluxo) ou **Pode editar** (também altera o fluxo). |
| **Excluir** | Apaga o fluxo. |

### 11. Usar um template

Na aba **Templates** ficam fluxos prontos, oferecidos pela sua empresa. Eles são **somente leitura**: para adaptar um template, use **Clonar** e edite a sua cópia.

<Info>
  Administradores podem transformar um fluxo em template (**Transformar em template**) ou retirá-lo da lista (**Remover dos templates**). Templates ficam visíveis para todos da empresa.
</Info>

## Exemplo prático: resumo de contratos

<Steps>
  <Step title="Crie o fluxo &#x22;Resumo de contratos&#x22;" />

  <Step title="Arraste um nó Início e ative Entrada de conteúdo" />

  <Step title="Arraste um nó Agente para resumir">
    Escolha um agente e escreva nas **Instruções**: *"Resuma este contrato em até 10 tópicos, em português."*
  </Step>

  <Step title="Arraste outro nó Agente para os riscos">
    Escreva nas **Instruções**: *"A partir do resumo, liste os três principais riscos para a empresa."*
  </Step>

  <Step title="Arraste um nó Saída" />

  <Step title="Conecte os nós">
    **Início → Agente (resumo) → Agente (riscos) → Saída**.
  </Step>

  <Step title="Clique em Validar, depois em Salvar" />

  <Step title="Clique em Executar, escolha Arquivo e envie o contrato" />

  <Step title="Leia o Resultado final">
    Baixe o .txt, se quiser guardar.
  </Step>
</Steps>

## Atalhos de teclado

| Atalho | Ação |
| - | - |
| **Ctrl + Z** | Desfazer |
| **Ctrl + Y** | Refazer |
| **Ctrl + S** | Salvar |
| **Delete** | Excluir o item selecionado |
| **+** / **−** | Aproximar / afastar a visualização |

O botão **Ajuda**, no editor, mostra este resumo a qualquer momento.

## Boas práticas

* **Comece simples.** Monte primeiro um fluxo com Início → Agente → Saída, teste, e só depois acrescente etapas.
* **Uma tarefa por nó.** Instruções curtas e objetivas em cada agente funcionam melhor do que um agente fazendo tudo.
* **Teste com conteúdo real** antes de ativar o modo **Automático**.
* **Use o Histórico** para entender falhas: clique no nó que falhou e veja a entrada que ele recebeu.
* **Dê nomes claros aos nós** (campo **Nome**), como "Resumir contrato" ou "Classificar risco". Isso facilita a leitura do fluxo e do histórico.
* **Lembre do consumo.** Cada nó de Agente usa IA e conta no seu consumo, como uma mensagem no chat. Fluxos automáticos que rodam com frequência consomem continuamente.

## Perguntas frequentes

<AccordionGroup>
  <Accordion title="O botão Executar está desativado. Por quê?">
    Há alterações não salvas. Clique em **Salvar** e tente de novo.
  </Accordion>

  <Accordion title="Meu fluxo automático não rodou.">
    Confira no nó **Início** se o **Modo de início** está em **Automático** e, no agendamento **Semanal**, se pelo menos um dia está marcado. Confira também se o fluxo não tem problemas de validação.
  </Accordion>

  <Accordion title="Posso usar qualquer agente?">
    Sim, qualquer agente que você tem permissão para usar, inclusive os compartilhados com você.
  </Accordion>

  <Accordion title="Quem recebeu o fluxo compartilhado pode alterá-lo?">
    Só se você compartilhou com a permissão **Pode editar**. Com **Pode executar**, a pessoa apenas roda o fluxo.
  </Accordion>

  <Accordion title="Apareceu a mensagem de limite de execuções.">
    Cada empresa pode iniciar até **30 execuções por minuto**. Aguarde alguns segundos e tente de novo.
  </Accordion>

  <Accordion title="O fluxo parou no meio.">
    Abra a execução no **Histórico**, clique no nó com status **Falhou** e veja a mensagem de erro. Se o seu limite de consumo de IA tiver acabado, os nós de Agente também falham (veja [Configurações → Uso](/guia/configuracoes)).
  </Accordion>
</AccordionGroup>

## Limitações conhecidas

* O nome do fluxo deve ter entre **3 e 60 caracteres** e não pode repetir o de outro fluxo.
* O fluxo precisa de **exatamente um nó de Início** e **pelo menos um de Saída**, e não pode ter caminhos que voltam para trás (*loops*).
* Sub-fluxos aceitam até **5 níveis**.
* Cada empresa pode iniciar até **30 execuções por minuto**.
* Não é possível editar um fluxo enquanto ele está executando.
* Conexões não podem ser editadas: para mudar, exclua a conexão e crie outra.
* Templates são somente leitura: para alterar, clone.
* Criar e usar fluxos depende da permissão de **Fluxos**, definida pelo administrador.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.