Content Flows — Guia Completo
Content Flows são o recurso de automação central do Fozzels. Um Flow é uma regra que gera automaticamente conteúdo de IA para um atributo de produto selecionado e escreve o resultado de volta na sua loja.
O que um Flow faz
- Filtra produtos por suas condições (por exemplo, "description is empty")
- Envia dados de produtos para a IA com seu prompt
- Armazena o conteúdo gerado como uma "completion"
- Empurra o conteúdo para seu atributo de loja
Criando um Flow
Acesse Flows → Create Flow
Etapa 1 — Loja e atributo de destino
- Selecione a loja cujos produtos deseja processar
- Dê um nome ao Flow
- Selecione o target attribute — o atributo que receberá o conteúdo gerado por IA
- Deve ter a flag Mutable habilitada em Integration → Attributes
Etapa 2 — Provedor de IA
- Escolha o fornecedor de IA: OpenAI GPT-4o, Google Gemini 2.5 Flash, ou Anthropic Claude
- Selecione um modelo específico
- Configure parâmetros de modelo, se necessário
Etapa 3 — Produtos e prompt
- Conditions — construtor de consultas visuais para filtrar quais produtos este Flow processa
- Exemplo: "description is empty AND category equals Electronics"
- Deixe vazio para processar todos os produtos na loja
- Uma visualização de contagem de produtos mostra quantos produtos correspondem
- Prompt template — a instrução enviada para a IA, com placeholders
{{attribute_code}}- Exemplo:
Write a product description for {{name}} (SKU: {{sku}}) in category {{category}} - Attributes tab (
{{attribute_code}}) — sempre incluído no prompt, mesmo que o produto não tenha valor para esse atributo - Attributes (if filled) tab (
#attribute_code) — incluído apenas no prompt quando o produto realmente tem um valor; útil para evitar enviar linhas vazias para a IA
- Exemplo:
Etapa 4 — Configurações de automação
- Active toggle — habilitar/desabilitar o Flow
- Batch size — quantos produtos processar por execução (padrão 10)
- Automation toggle — quando ON, conteúdo confirmado é automaticamente empurrado para sua loja sem revisão manual
- Regenerate on attribute change — re-executar quando atributos de origem são atualizados (⚠ pode causar recursão se o atributo de destino também for uma origem)
- Prevent overlapping generation — cooldown entre regenerações por produto:
- Inherit — use cooldown global das configurações da conta
- Override — defina um cooldown customizado apenas para este Flow
- Turn off — sempre regenere independentemente de execuções anteriores
Dicas de modelo de prompt
Referencie atributos com {{attribute_code}} — use o código exato mostrado em Integration → Attributes.
Duas sintaxes de atributo:
{{attribute_code}}— sempre incluído (corresponde à aba Attributes no editor). Use isto por padrão.#attribute_code— incluído apenas se o produto tiver um valor (corresponde à aba Attributes (if filled)). Use para pular campos vazios.
Seja específico sobre:
- Formato e comprimento ("150–200 words")
- Idioma ("in English")
- Tom ("professional but friendly")
- O que evitar ("do not mention competitors")
Exemplo para descrição de produto:
Write a compelling product description (150–200 words) in English.
Product name: {{name}}
Brand: {{brand}}
Category: {{category_name}}
Current short description: {{short_description}}
Focus on benefits, not just features. Use a professional but friendly tone.
Se a saída deve conter HTML, habilite as tags relevantes em Settings → Flow Settings → Trusted HTML Tags.
Executando um Flow
Run Now — processa imediatamente até 10 produtos. Use isto para testar ou para pequenos lotes.
Plan & Close — coloca em fila o lote completo para processamento em segundo plano. Use isto para execuções em massa.
Ciclo de vida da conclusão
Cada item gerado passa por esses estágios:
| Status | Significado |
|---|---|
| Pending | Gerado, aguardando revisão |
| Confirmed | Aprovado por você, pronto para sincronizar |
| Synchronized | Empurrado com sucesso para a loja |
| Suspicious | Contém conteúdo sinalizado — exige revisão manual antes da sincronização |
Com Automation ON — conteúdo limpo é confirmado e empurrado automaticamente. Conteúdo suspeito sempre aguarda revisão manual.
Com Automation OFF — todo conteúdo aguarda você revisar e confirmar antes de sincronizar.
Revendo conclusões
Acesse um Flow → View Completions para ver todo o conteúdo gerado.
Por item você pode:
- Edit o texto gerado manualmente
- Regenerate — peça à IA para gerar novamente
- Confirm — aprovar conteúdo para sincronização
- Synchronize — empurrar para sua loja
- View revisions — ver histórico de edição completo e diff entre versões
Ações em lote: selecione vários itens → Confirm & Sync, Regenerate, ou Push.
Conteúdo suspeito
Fozzels sinaliza automaticamente conteúdo que parece errado:
- Artefatos de IA: "Sorry, I can't...", "As an AI...", "Note:", "Please"
- Valores vazios
- HTML com dupla codificação (
<,>) - Sintaxe Markdown em um campo não-markdown
- Suas palavras suspeitas customizadas (configure em Settings → Flow Settings)
Conteúdo sinalizado mostra exatamente por que foi sinalizado. Você pode:
- Editar e corrigir
- Regenerar
- Override e aprovar mesmo assim (se for um falso positivo)
Por que o conteúdo não sincroniza (push bloqueado)
| Motivo | Solução |
|---|---|
| Flow is inactive | Habilite o toggle Active no Flow |
| Not confirmed | Confirme a completion (ou habilite Automation) |
| Suspicious content | Revise e aprove, ou edite e re-salve |
| Product deleted from store | Nada a fazer — produto não existe mais |
| Store/integration inactive | Habilite a loja ou integração |
| Attribute not mutable | Habilite a flag Mutable em Integration → Attributes |
Gerenciamento de Flow
- Duplicate — copie um Flow para a mesma loja ou uma diferente
- Archive — oculte o Flow da lista principal; dados são preservados e podem ser restaurados
- Delete — remoção permanente
- Obsolete — quando um Flow é clonado devido a mudanças estruturais (atributo de destino ou condições mudaram), a versão antiga se torna obsoleta; seu histórico de conclusão é preservado
Aviso de mudanças estruturais
Se você mudar o target attribute ou conditions em um Flow que já tem conclusões, Fozzels avisará e oferecerá "Obsolete and Duplicate" — isto cria um Flow novo com suas mudanças, preservando o histórico do antigo.
Aviso de recursão
Disparado quando o mesmo atributo aparece como:
- Uma entrada em seu prompt (
{{attr_code}}) - O atributo de destino de saída
Isto cria um loop infinito — cada geração sobrescreve a entrada para a próxima execução.
Solução:
- Remova
{{attr_code}}do modelo de prompt - OU desabilite "Regenerate on attribute change"
Problemas comuns
Nenhum produto corresponde ao Flow
- Verifique suas condições — tente removê-las temporariamente para ver todos os produtos
- Verifique se os atributos usados nas condições têm a flag Filterable em Integration → Attributes
Saída de IA vazia
- Verifique se os atributos de origem têm valores para seus produtos
- Verifique se os atributos referenciados no prompt têm a flag Filterable
- Torne o prompt mais específico
Conteúdo não está sendo empurrado para a loja
- Verifique os motivos de bloqueio de push acima
- Verifique se o toggle Active da integração está ON
- Verifique se o atributo de destino tem a flag Mutable
Cota OpenAI excedida
- Recarregue em platform.openai.com/settings/organization/billing
- Ou reduza volume diário nas configurações de automação do Flow
Conteúdo duplicado entre Flows
- Habilite "Prevent overlapping generation" com um período de cooldown (por exemplo, 7 dias)
- Isto impede que vários Flows regenerem o mesmo produto dentro da janela de cooldown