Skip to main content

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.
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.
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

Como utilizar

1. Criar um fluxo

1

Clique em Novo fluxo

2

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.
3

Clique em Criar

O editor do fluxo abre em seguida.

2. Conhecer o editor

O editor tem três áreas: 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

1

Arraste um nó da paleta para a tela

2

Conecte os nós

Clique no ponto de conexão de um nó e arraste até o próximo.
3

Clique em um nó para configurá-lo no painel Propriedades

4

Repita até chegar ao nó de Saída

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

4. Tipos de nó

5. Configurar cada nó

  • 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.
No agendamento semanal, escolha pelo menos um dia. Sem isso, o fluxo nunca roda.
  • Agente — escolha um dos agentes que você pode usar. Se a lista estiver vazia, crie um agente primeiro (veja 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.
  • 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.
  • 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.
Para usar a Condição, peça ao agente anterior uma resposta padronizada. Ex.: “Responda apenas APROVADO ou REPROVADO.”
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.
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.
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.
Em Formato, escolha Texto simples ou JSON.
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.

6. Validar e salvar

1

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.
2

Clique em Salvar

Ou use Ctrl + S.
Os problemas mais comuns:

7. Executar o fluxo

1

Salve o fluxo

O botão Executar só funciona com tudo salvo.
2

Clique em Executar

3

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.
4

Confirme

Durante a execução, cada nó mostra o próprio status na tela.
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:

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.
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.

Exemplo prático: resumo de contratos

1

Crie o fluxo "Resumo de contratos"

2

Arraste um nó Início e ative Entrada de conteúdo

3

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.”
4

Arraste outro nó Agente para os riscos

Escreva nas Instruções: “A partir do resumo, liste os três principais riscos para a empresa.”
5

Arraste um nó Saída

6

Conecte os nós

Início → Agente (resumo) → Agente (riscos) → Saída.
7

Clique em Validar, depois em Salvar

8

Clique em Executar, escolha Arquivo e envie o contrato

9

Leia o Resultado final

Baixe o .txt, se quiser guardar.

Atalhos de teclado

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

Há alterações não salvas. Clique em Salvar e tente de novo.
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.
Sim, qualquer agente que você tem permissão para usar, inclusive os compartilhados com você.
Só se você compartilhou com a permissão Pode editar. Com Pode executar, a pessoa apenas roda o fluxo.
Cada empresa pode iniciar até 30 execuções por minuto. Aguarde alguns segundos e tente de novo.
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).

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.