Fluxos de trabalho sem código (automação DAG)

Visão geral

Os fluxos de trabalho permitem encadear etapas em um pipeline automatizado — um DAG (grafo acíclico dirigido) de nós — sem escrever código. Um fluxo de trabalho pode gerar conteúdo, invocar capacidades de IA, acessar APIs externas, ramificar, iterar em loop, esperar, obter aprovações e publicar resultados. Cada etapa é executada com seu próprio tempo limite, orçamento e política de erros, de modo que uma única etapa instável não possa sair do controle nem travar toda a execução.

Tipos de nó

Os fluxos de trabalho oferecem suporte a estes tipos de etapa:

1. Capability — invoca uma capacidade de IA (chat, imagem, TTS, tradução, etc.)
2. Tool — invoca uma ferramenta/função registrada
3. HttpRequest — chama um endpoint HTTP externo
4. Branch — roteia com base em uma condição
5. Loop — itera sobre uma coleção
6. FanOut / FanIn — paraleliza e reúne
7. Transform — define/remodela variáveis
8. ArtifactSave — persiste um recurso transitório no seu CDN
9. Publish — envia para um canal (webhook, artefato markdown, etc.)
10. SubWorkflow — chama outro fluxo de trabalho como uma etapa
11. HumanApproval — faz uma pausa para uma aprovação
12. Wait — atraso
13. Webhook — POST para um hook externo

Controles por etapa

Cada nó inclui:

• Timeout — por quanto tempo a etapa pode ser executada antes de ser interrompida.
• Error policy — o que acontece em caso de falha: fazer a execução falhar, repetir ou continuar/ignorar. Por exemplo, defina uma etapa de notificação como ignorar para que uma indisponibilidade ali não faça toda a execução falhar, e defina uma etapa de busca como repetir para falhas transitórias upstream.

Variáveis e artefatos

• Variables transmitem dados entre etapas. As etapas leem saídas anteriores com a interpolação {{vars.name}}.
• Artifacts são saídas que você persiste — o ArtifactSave volta a hospedar URLs transitórias do provedor como URLs permanentes do Bunny CDN para que os links não expirem.

Custo

Não há nenhuma taxa de execução de fluxo de trabalho separada. Uma execução é cobrada como a soma do BillingRecord de cada etapa — exatamente a mesma cobrança por chamada que executar cada etapa manualmente. As etapas que não fazem nenhuma chamada de IA (HTTP, transform, wait, webhook) não têm custo. Os custos de subfluxo de trabalho somam-se ao total da execução principal.

Execução e monitoramento

Inicie uma execução e depois acompanhe-a na página de execuções de fluxo de trabalho. Cada execução registra suas etapas, seus resultados e o custo total. As etapas com falha exibem seu erro de acordo com a política de erros da etapa.

Dicas

• Atribua às etapas externas/de notificação uma política de erros tolerante (repetir ou continuar) e às etapas essenciais uma política estrita.
• Use o ArtifactSave em qualquer mídia gerada que você queira manter — as URLs do provedor expiram.
• Extraia subgrafos reutilizáveis para um SubWorkflow e o chame a partir de vários fluxos principais.
• Teste um fluxo com etapas econômicas de echo/transform antes de conectar etapas dispendiosas de capacidade de IA.