Fluxos: automações visuais que rodam sempre do mesmo jeito
O módulo Fluxos do CollaborAI Enterprise monta automações como um desenho: gatilho, passos e setas. Veja o que é um fluxo, quando usar no lugar de um agente e o que dá para ligar nele.
Um fluxo é uma automação que executa sempre os mesmos passos, na ordem que você desenhou. Todo dia às 8h, consultar um sistema, conferir se a resposta veio certa, resumir com IA e mandar um e-mail. Amanhã ele faz exatamente a mesma coisa, e depois de amanhã também.
No CollaborAI, o módulo Fluxos é um editor visual: cada passo é um nó, e as setas mostram por onde os dados passam. Ele é exclusivo das contas Enterprise. Este artigo abre uma série sobre o módulo e explica o que ele é, quando usar e o que dá para ligar nele.
Fluxo ou agente?
Os dois automatizam trabalho, mas de jeitos opostos. O agente recebe um objetivo e decide sozinho como chegar lá. O fluxo não decide nada: segue o desenho.
| Agente | Fluxo | |
|---|---|---|
| Como trabalha | Interpreta o pedido e escolhe as ferramentas | Segue os passos desenhados, na ordem |
| Resultado | Pode variar de uma execução para outra | Previsível: mesma entrada, mesmo caminho |
| Bom para | Perguntas abertas, atendimento, análise | Rotinas, integrações, processos com regra clara |
| Quando erra | Você ajusta as instruções | Você vê o passo exato que falhou |
Na prática, os dois se combinam. Um fluxo pode chamar um agente no meio do caminho, só no passo em que é preciso interpretar alguma coisa. O resto continua previsível.
Uma regra simples para escolher: se você consegue descrever o processo como “primeiro isso, depois aquilo, se der X faz Y”, é um fluxo. Se a descrição for “descubra o que o cliente precisa e resolva”, é um agente.
As peças de um fluxo
Todo fluxo tem quatro peças:
- Gatilho. É o primeiro nó e define quando o fluxo começa: manualmente, em um horário ou quando outro sistema chama. Cada fluxo tem exatamente um.
- Nós. Cada nó é um passo: consultar uma API, decidir um caminho, resumir um texto, mandar um e-mail.
- Setas. Ligam a saída de um nó à entrada do próximo. Nós de decisão têm mais de uma saída, como verdadeiro e falso.
- Itens. São os dados que trafegam pelas setas. Uma lista de 20 pedidos são 20 itens, e cada nó processa os itens que recebe.
O que dá para ligar em um fluxo
O painel de nós é dividido em sete famílias:
| Família | O que tem |
|---|---|
| Gatilhos | Execução manual, agendamento e webhook |
| Lógica | Se, Escolher, Filtrar, Unir, Loop, Aguardar e Parar execução |
| Dados | Editar campos, separar e agregar listas, ordenar, limitar, remover duplicados, ler JSON, XML e HTML, datas |
| Código | Python e JavaScript, em ambiente isolado |
| IA e Agentes | Um modelo de IA direto ou um dos seus agentes |
| Conectores | As contas que você já conectou ao CollaborAI, como e-mail, agenda e planilhas |
| Ações | Requisição HTTP, envio de e-mail e extração de texto de PDF |
O ponto forte está nas duas famílias do meio. Conectores e IA e Agentes reaproveitam o que a sua conta já tem: a caixa de e-mail conectada, a base de conhecimento, os agentes que você criou. O fluxo não é uma ferramenta à parte, e sim uma forma de encadear o que já existe na plataforma.
Você vê o que aconteceu em cada passo
Quando o fluxo roda, o próprio desenho mostra o resultado. Cada nó concluído ganha um selo com o número de itens que produziu, e as setas mostram quantos itens passaram por elas.
Abrindo um nó, você vê os dados que entraram, os parâmetros e os dados que saíram. Quando algo dá errado, o nó com falha fica marcado, com a mensagem de erro. Não é preciso adivinhar onde o processo parou.
Os limites, em números
- Até 100 nós por fluxo.
- Tempo máximo de execução de 30 minutos por padrão, ajustável de 1 a 120.
- O nó Aguardar pausa o fluxo por até 24 horas, e esse tempo não conta no limite acima.
- O agendamento roda, no máximo, uma vez por hora.
- A Requisição HTTP só chama domínios que você liberou nas configurações do fluxo.
Quem tem acesso
O módulo Fluxos é exclusivo das contas Enterprise, em que o CollaborAI roda em ambiente dedicado da organização. Nessas contas, o item Fluxos aparece no menu lateral.
Dois detalhes práticos:
- Use um computador. O editor precisa de tela grande e avisa quando a janela é pequena demais.
- O fluxo é de quem criou. Cada pessoa vê os próprios fluxos, e os conectores usam a conta de quem é dono do fluxo. Um fluxo de outra pessoa não usa a sua caixa de e-mail.
O que vem na série
Os próximos artigos entram em cada parte do módulo, sempre com um exemplo pequeno que dá para reproduzir:
- O primeiro fluxo, do zero: um monitor de API com alerta.
- Os três gatilhos: manual, agendamento e webhook.
- Lógica e dados: decidir, repetir e juntar listas.
- IA dentro do fluxo: modelo direto ou agente.
- Conectores: e-mail, agenda, planilhas, WhatsApp e banco de dados.
- Código e APIs externas, com credenciais guardadas.
- Testar, acompanhar execuções e tratar erros.
- Casos de uso por área da empresa.
Comece pela rotina mais chata e mais repetida da sua semana. Se ela tem regra clara e acontece sempre do mesmo jeito, provavelmente cabe em meia dúzia de nós.
