AgentFlow
Guia completo para criar seu primeiro pipeline de automação de conteúdo com IA
v2.0 — Modo Avançado (input_schema)1 Introdução
O que é um Pipeline?
Um pipeline é uma sequência de workers que processam conteúdo em etapas. Cada worker recebe dados do anterior, processa com IA ou sistema, e passa o resultado adiante. No final, um artigo completo é publicado automaticamente no WordPress.
Fluxo típico (na prática)
Um pipeline real geralmente começa com um Agendador, seguido por workers de texto que geram notícia, título e conteúdo, depois workers de imagem (FLUX para destaque, Seedream para imagem inline) e finalmente o Publicador. Veja a ordem exata:
Esse fluxo gera automaticamente um artigo completo com imagem destacada (FLUX) e uma imagem ilustrativa dentro do corpo (Seedream), usando [[IMAGEM]] no texto.
2 Dashboard
Ao fazer login, você vê o Dashboard com:
- Saldo de créditos (pill verde no canto superior direito) — clique para recarregar
- Meus Pipelines — lista de todos os seus pipelines
- Templates — pipelines prontas para clonar
- + Novo pipeline — cria do zero
- Sites WordPress — gerencia conexões
- Comunidade — pipelines públicas de outros usuários
Cada pipeline na lista mostra seu nome, os tipos de worker que contém, e se é rascunho ou publicado.
3 Criar Pipeline
Opção 1: A partir de um Template
No Dashboard, clique em Templates. Escolha um modelo, dê um nome, selecione um site WordPress, e pronto — você tem um pipeline funcional em segundos.
Opção 2: Criar do Zero (recomendado para aprender)
No Dashboard, clique em + Novo pipeline. Você será levado ao Editor.
Editor de Pipeline — Passo a Passo
Configurações básicas
Dê um nome ao pipeline e selecione o site WordPress onde o conteúdo será publicado. Escolha se o padrão é “Rascunho” ou “Publicado”.
Ativar modo avançado (v2)
Role até o fim da seção de Configuração e clique em “Ativar modo avançado (v2)”. Isso permite controlar entradas e saídas de cada worker com precisão.
Adicionar workers
Clique em + Adicionar worker. Um modal de 3 etapas aparece:
- 1. Tipo: Texto, Imagem, Busca, Upload de Imagem, Image Fetcher, Organizador, Publicador, Agendador
- 2. Modelo: (para tipos com IA) escolha o modelo — cada um tem um custo em créditos
- 3. Configuração: nome da saída, conexões de entrada, prompt
Ordenar workers
Arraste e solte os cards dos workers para reordenar. O Agendador sempre fica na primeira posição.
Salvar
Clique em Salvar (canto superior direito). Um “✓ Salvo” confirma.
4 Tipos de Worker
Usa IA (Deepseek, GPT, Claude, Gemini) para gerar conteúdo escrito a partir de um prompt.
Requer: modelo de IA + prompt + nome da saída
Custo: 1-3 créditos por chamada
Gera imagens com IA (FLUX, Seedream, DALL-E) a partir de uma descrição textual.
Requer: modelo de imagem + prompt + nome da saída
Custo: 4-8 créditos por imagem
Busca informações atualizadas na internet. Usa Gemini com Google Grounding (quando disponível) ou fallback via OpenRouter.
Requer: modelo de busca + prompt + nome da saída
Pega uma imagem gerada (em base64) e envia para a biblioteca de mídia do WordPress.
Requer: input_key (qual imagem pegar) + output_key (nome da saída)
Produz: {output_key}.attachment_id e {output_key}.url
Baixa uma imagem de uma URL externa, converte para WebP e envia para o WordPress.
Requer: input_key (URL da imagem) + output_key
Produz: {output_key}.attachment_id e {output_key}.url
Renomeia ou redireciona chaves do contexto. Útil para compatibilidade entre workers.
Config: mapeamentos de from_key → to_key
Monta o post completo e publica (ou salva como rascunho) no WordPress.
Requer: site WordPress configurado
Config: título, corpo, imagem destacada, categorias, tags, imagens inline
Define quando o pipeline roda: imediato, diário ou semanal. Sempre na primeira posição.
Modos: uma vez, diário (horário), semanal (dia + horário)
Após a publicação, registra o link do post na página Comunidade do AgentFlow.
Posição: coloque depois do Publicador no pipeline
5 Conexões entre Workers (v2)
Como os workers se comunicam
Cada worker pode produzir uma saída (com um nome, o output_key) e consumir saídas de workers anteriores (as input_connections). Isso cria um fluxo de dados controlado.
Exemplo prático: pipeline completo (ordem vertical)
Veja abaixo a sequência exata de workers, na ordem em que aparecem no editor, com suas conexões de entrada e saída:
noticias_rawnoticias_raw · output: títulonoticias_raw, título · output: conteudotítulo · output: img_featimg_feat · output: img_feat_wp.attachment_idnoticias_raw · output: img_inlineimg_inline · output: img_inline_wp.attachment_idtítulo · body_from=conteudo · featured=img_feat_wp.attachment_id · inline=img_inline_wp.attachment_id| Worker | output_key | input_connections | Custo |
|---|---|---|---|
| Agendador | — | — | — |
| Texto (noticias_raw) | noticias_raw | — | 1cr |
| Texto (título) | título | noticias_raw | 1cr |
| Texto (conteúdo) | conteudo | noticias_raw, título | 1cr |
| Imagem FLUX.2 Max | img_feat | título | 8cr |
| Upload Imagem (featured) | img_feat_wp | img_feat | — |
| Imagem Seedream 4.5 | img_inline | noticias_raw | 3cr |
| Upload Imagem (inline) | img_inline_wp | img_inline | — |
| Publicador | — | título, conteudo, img_feat_wp.attachment_id, img_inline_wp.attachment_id | — |
{noticias_raw} ou {título} para referenciar saídas anteriores.Campos de entrada do pipeline
No modo v2, você pode definir campos de entrada que o usuário preenche ao executar. Ex: campo “tema” usado como {tema} no prompt.
6 Configurar o Publicador
O Publicador é o worker mais configurável. Veja o que cada campo significa:
| Campo | O que faz |
|---|---|
| Título | Qual saída de worker anterior contém o título do post |
| Corpo | Qual saída contém o HTML do conteúdo |
| Excerpt | Qual saída tem o resumo (opcional) |
| Imagem destacada | Qual output_key.attachment_id usar como imagem principal |
| Status | Rascunho, Publicado ou Pendente |
| Autor WP | ID do autor no WordPress (opcional) |
| Categorias | IDs separados por vírgula (ex: 3,7,12) |
| Tags | Nomes separados por vírgula (ex: política, brasil) |
| Imagens no corpo | Mapeia marcadores [[NOME]] no HTML para imagens inline |
Usando imagens inline
1. No prompt do worker de texto, insira [[IMAGEM]] no lugar onde a imagem deve aparecer.
2. Crie um worker de Imagem + Upload para gerar a imagem.
3. No Publicador, em “Imagens no corpo”, adicione: marcador = IMAGEM, attachment_id = saída do upload.
7 Executar o Pipeline
Clique em ▶ Executar
Botão verde no canto superior direito do Editor.
Preencha os campos de entrada (se houver)
Se você definiu campos de entrada no pipeline, um modal aparece para você preencher (ex: o tema da notícia).
Veja o custo estimado
Um modal mostra o custo estimado e seu saldo. Se tiver saldo suficiente, confirme.
Acompanhe a execução
Você é redirecionado para a página da execução, que atualiza a cada 2 segundos mostrando o progresso.
8 Acompanhar Resultados
A página de execução (/runs/:id) mostra:
- Barra de progresso — quantos workers já completaram
- Lista de workers — cada um com status (⏳ pendente, ⚡ executando, ✓ completo, ✗ falhou)
- Outputs expansíveis — clique em um worker completo para ver o resultado
- Links do WordPress — se o Publicador completou, links “Ver post →” e “Editar no WordPress →”
- Botão “Publicar agora” — se o post foi salvo como rascunho, você pode publicar direto da página
Em caso de falha
Se um worker falhar, a execução para e mostra o erro. Você pode clicar em “Tentar novamente” para retomar de onde parou (workers já concluídos não são refeitos, e o custo já debitado não é cobrado de novo).
Histórico de execuções
No Editor do pipeline, role até o final para ver o histórico de todas as execuções daquele pipeline, com status, custo e data.
9 Agendar Execuções
Para executar um pipeline automaticamente em horários específicos:
- Adicione um worker do tipo Agendador como primeiro worker do pipeline
- Configure o modo: Diário ou Semanal
- Defina horário (horário de Brasília) e, se semanal, o dia da semana
- Salve e clique em ▶ Agendar
Modos de agendamento
| Modo | Comportamento |
|---|---|
| Uma vez | Executa imediatamente ao clicar em ▶ Executar |
| Diário | Executa todos os dias no horário definido |
| Semanal | Executa uma vez por semana no dia+horário definidos |
10 Dicas Avançadas
Usando 2 imagens diferentes
Um padrão comum para artigos no WordPress:
- Worker Imagem (FLUX.2 Max) → foto realista para imagem destacada
- Worker Upload → envia ao WP, produz
imagem_wp.attachment_id - Worker Imagem (Seedream 4.5) → arte conceitual para o corpo do artigo
- Worker Upload → envia ao WP, produz
imagem_inline_wp.attachment_id - Publicador: featured =
imagem_wp.attachment_id, inline =imagem_inline_wp.attachment_id
Referenciando saídas no prompt
No prompt de um worker, use {chave} para inserir o valor de uma saída anterior:
{noticias_raw}— insere o resultado de uma busca ou texto anterior{briefing}— insere o briefing do pipeline (modo v1){tema}— insere o valor do campo de entrada “tema”
Evitando markdown no HTML
No prompt do worker de texto, seja explícito: "Gere HTML puro, sem ```html, sem markdown."
Padrão completo para artigo autoral
9 workers em sequência:
- Agendador
- Busca →
noticias_raw - Texto →
titulo - Texto →
conteudo(com[[IMAGEM]]) - Imagem FLUX →
imagem_gerada - Upload →
imagem_wp - Imagem Seedream →
imagem_inline - Upload →
imagem_inline_wp - Publicador