Workflows

Descreva um workflow e o Mothership constrói. Referencie um existente pelo nome e ele edita. Sem precisar navegar no canvas — cada mudança aparece no painel de recursos em tempo real.

Criando workflows

Descreva o que o workflow deve fazer — o que o dispara, o que ele deve fazer, quais integrações precisa e o que deve retornar. O Mothership constrói e abre o canvas no painel de recursos.

  • "Construa um workflow que receba uma URL, faça scrape da página, resuma com Claude e envie o resumo para um canal do Slack"
  • "Crie um workflow disparado por webhook que extraia dados de fatura de um PDF e grave na tabela de billing"
  • "Construa um workflow de outbound: pegue o nome e domínio de uma empresa, enriqueça com dados firmográficos, pontue o fit e rascunhe um cold email personalizado"
  • "Crie um workflow de enriquecimento de leads que pegue um e-mail de um formulário, busque a empresa e grave o registro enriquecido na tabela de leads"
  • "Construa um workflow de onboarding de clientes: quando um novo usuário se cadastrar, envie um e-mail de boas-vindas, crie um contato no HubSpot e poste uma notificação em #new-customers no Slack"

Editando workflows

Abra um workflow existente com @workflow-name ou o menu +, depois descreva a mudança. O Mothership lê a estrutura atual antes de modificar — você não precisa explicar o que já existe.

  • "Adicione uma condição que roteie para um branch diferente se o score de confiança for menor que 0.7"
  • "Substitua o modelo GPT-4o por Claude Opus 4.6 no bloco summarizer"
  • "Adicione uma notificação no Slack no final que inclua a saída"

Executando workflows

Peça ao Mothership para rodar um workflow e ele cuida da execução:

  • "Rode o workflow de data sync"
  • "Rode o processador de faturas com este PDF [anexe o arquivo]"
  • "Teste o workflow de lead scoring com estes inputs: name=Acme, score=0.4"

A execução faz stream de volta para o chat. O workflow no painel de recursos mostra o estado ao vivo, bloco a bloco.

Lendo logs

O Mothership pode recuperar e interpretar logs de execução de qualquer workflow no workspace:

  • "Mostre as últimas 10 execuções do workflow pipeline"
  • "Por que o workflow de faturas falhou ontem?"
  • "O que o bloco extractor retornou na execução mais recente?"

Os logs incluem estado de execução por bloco, saídas, erros e timing.

Depurando

Quando um workflow falha, diga ao Mothership para depurar:

  • "Depure a última execução que falhou do content pipeline"
  • "O bloco summarizer está retornando saída vazia — descubra por quê"

O Mothership lê os logs de falha, identifica a causa, aplica uma correção e pode reexecutar para confirmar.

Publicando

O Mothership pode publicar um workflow como qualquer um dos três tipos de deployment:

Tipo de deploymentO que cria
APIUm endpoint REST em https://app.zoen.space/api/workflows/{id}/execute
ChatUma interface conversacional hospedada com URL compartilhável
Ferramenta MCPUm servidor MCP que expõe o workflow como ferramenta

Peça: "Publique o workflow de faturas como API e gere uma API key."

O Mothership também pode fazer rollback: "Reverta o workflow de billing para a versão de terça-feira passada."

Veja API Deployment e Chat Deployment para detalhes completos de cada tipo de deployment.

Organizando workflows

O Mothership pode criar e gerenciar pastas para manter o workspace organizado.

Pastas:

  • "Crie uma pasta chamada 'Data Pipelines'"
  • "Mova o workflow de faturas para a pasta billing"
  • "Mova a pasta billing para dentro da pasta finance"
  • "Delete a pasta old-experiments"

Renomeando e movendo:

  • "Renomeie o workflow 'test_v2' para 'lead-scorer'"
  • "Mova o workflow summarizer para a pasta research"

Variáveis de workflow

O Mothership pode definir variáveis globais em um workflow — valores acessíveis em todos os blocos daquele workflow em runtime:

  • "Defina a variável API_ENDPOINT no workflow sync como 'https://api.example.com/v2'"
  • "Atualize a variável MAX_RETRIES no workflow pipeline para 5"

Variáveis definidas assim ficam disponíveis via sintaxe <variable.VARIABLE_NAME> dentro de qualquer bloco do workflow.

Deletando workflows

  • "Delete o workflow old_api_prototype"
  • "Delete todos os workflows na pasta deprecated"

Common Questions

Sim. Editar um workflow não afeta o deployment ao vivo. A versão publicada é um snapshot — você precisa pedir ao Mothership para republicar para empurrar as mudanças para produção.
Sim. Descreva os inputs na mensagem e o Mothership os passa para o bloco start do workflow.
Quando você referencia um workflow, o Mothership carrega a estrutura completa — cada bloco, conexão e configuração — antes de agir.
O workflow e todos os seus deployments são removidos permanentemente. Qualquer endpoint de API, URL de chat ou ferramenta MCP que apontava para aquele workflow para de funcionar.

On this page