O que Construtor de Fluxos de Trabalho AI faz?
Encadeie qualquer combinação de etapas de geração do muapi.ai em pipelines automatizados. O arquiteto AI converte sua descrição em linguagem natural em um grafo de nós executável.
Pré-requisitos
Certifique-se sempre de que o CLI muapi está atualizado antes de executar qualquer comando. Reinstale a partir da fonte no início de cada sessão:
pip install --upgrade /caminho/para/muapi-cli
Substitua /caminho/para/muapi-cli pelo caminho real do diretório muapi-cli no workspace (o diretório que contém pyproject.toml).
Operações Principais
- Gerar (
generate-workflow.sh) — O arquiteto AI cria um fluxo a partir de uma descrição - Descobrir (
discover-workflow.sh) — Encontre um fluxo existente relevante por linguagem natural - Editar (
generate-workflow.sh --workflow-id) — Modifique um fluxo existente com um prompt - Execução Interativa (
interactive-run.sh) — Solicite entradas e execute um fluxo - Executar (
run-workflow.sh) — Execute um fluxo, consulte nó por nó e colete as saídas - CLI (
muapi workflow) — CRUD completo + visualização diretamente do terminal
Descoberta e Seleção Guiadas pelo Agente
Como agente AI, você tem a capacidade de ler e entender o propósito dos fluxos disponíveis para selecionar o melhor para a tarefa do usuário (ex: "criar um vídeo UGC").
- Descobrir: Obtenha o catálogo de fluxos disponíveis e suas descrições em formato JSON.
muapi workflow discover --output-json - Corresponder (Raciocínio Interno): Use suas capacidades de LLM para analisar os campos
name,categoryedescriptiondos fluxos retornados. Encontre a melhor correspondência para a intenção do usuário. - Analisar: Se encontrar um candidato promissor, inspecione sua estrutura para garantir que ele tenha os nós e parâmetros necessários.
REGRRA CRÍTICA: A saída demuapi workflow get <workflow_id>muapi workflow getincluirá uma tabela "API Inputs". Você DEVE ler esta tabela para entender quais entradas são necessárias. - Escolher, Confirmar e Solicitar ao Usuário:
- Se um fluxo for uma correspondência perfeita, você DEVE pedir ao usuário que forneça os valores exatos para as entradas de API necessárias antes de executá-lo. Nunca invente ou adivinhe valores de entrada (como prompts, URLs, etc.) por conta própria.
- Se vários fluxos forem altamente relevantes, apresente as opções ao usuário com suas descrições e peça que ele confirme qual usar, e também solicite as entradas necessárias.
- Se nenhum fluxo corresponder à solicitação complexa do usuário, ofereça-se para arquitetar um novo usando
muapi workflow create.
Exemplo de Raciocínio do Agente
"O usuário quer um vídeo promocional de produto. Peguei o catálogo usando
discover. Vejo dois fluxos potenciais:
wf_123: 'Promo de produto com música de fundo'wf_456: 'Geração de vídeo simples' Vou analisarwf_123comget. Ele tem os nós necessários. Sugerireiwf_123ou apenas executarei se a correspondência for precisa."
Protocolo: Construindo um Fluxo de Trabalho
Passo 1 — Descreva seu pipeline
muapi workflow create "pegue um prompt de texto, gere uma imagem com flux-dev, depois faça upscale para 4K"
O arquiteto retorna um fluxo com um ID único e um grafo de nós. Salve o ID.
Passo 2 — Inspecione e visualize
# Grafo de nós ASCII rico no terminal
muapi workflow get <workflow_id>
# Ou JSON bruto
muapi workflow get <workflow_id> --output-json
Passo 3 — Execute
# Execute com entradas específicas
muapi workflow execute <workflow_id> \
--input "node1.prompt=uma caverna de cristal brilhante à meia-noite"
# Use --download para puxar resultados localmente
muapi workflow execute <workflow_id> \
--input "node1.prompt=um pôr do sol" \
--download ./outputs
Passo 4 — Descoberta (Opcional)
Se quiser reutilizar um fluxo existente em vez de criar um novo:
# Pesquise por palavras-chave
muapi workflow discover "vídeo ugc"
Passo 5 — Execução Interativa
Execute um fluxo e faça o CLI solicitar cada entrada necessária:
muapi workflow run-interactive <workflow_id>
Exemplos de Fluxos
Pipelines de Imagem
# Texto → Imagem → Upscale
muapi workflow create "pegue um prompt de texto, gere com flux-dev, faça upscale do resultado"
# Texto → Imagem → Remoção de fundo → Foto de produto
muapi workflow create "gere uma imagem de produto com hidream, remova o fundo, crie uma foto profissional do produto"
Pipelines de Vídeo
# Texto → Vídeo
muapi workflow create "gere um vídeo cinematográfico de 10 segundos a partir de um prompt de texto usando kling-master"
# Imagem → Vídeo → Lipsync
muapi workflow create "anime uma imagem de entrada com seedance, depois aplique lipsync a partir de um arquivo de áudio"
Editando um Fluxo Existente
# Adicione uma etapa
muapi workflow edit <id> --prompt "adicione uma etapa de troca de rosto após a geração da imagem"
# Troque um modelo
muapi workflow edit <id> --prompt "mude o modelo de vídeo de kling para veo3"
Referência do CLI
# Liste todos os seus fluxos
muapi workflow list
# Navegue pelos templates
muapi workflow templates
# Gere um novo fluxo
muapi workflow create "texto → imagem flux → upscale → troca de rosto"
# Visualize um fluxo
muapi workflow get <id>
# Execute com entradas
muapi workflow execute <id> --input "node1.prompt=um pôr do sol"
# Monitore uma execução
muapi workflow status <run_id>
# Obtenha as saídas
muapi workflow outputs <run_id> --download ./resultados
# Edite com AI
muapi workflow edit <id> --prompt "adicione lipsync no final"
# Renomeie / delete
muapi workflow rename <id> --name "Pipeline de Produto v2"
muapi workflow delete <id>
Ferramentas MCP (para agentes AI)
| Ferramenta | Descrição |
|---|---|
muapi_workflow_list | Listar os fluxos do usuário |
muapi_workflow_create | Arquiteto AI: prompt → fluxo |
muapi_workflow_get | Obter definição do fluxo + grafo de nós |
muapi_workflow_execute | Executar com entradas específicas |
muapi_workflow_status | Status de execução nó por nó |
muapi_workflow_outputs | URLs das saídas finais |
Restrições
- Fluxos podem conter qualquer combinação de nós muapi.ai (imagem, vídeo, áudio, melhoria, edição)
- As saídas dos nós são automaticamente conectadas como entradas para os nós downstream
- O modo
--syncaguarda até 120s para geração; use--asyncpara fluxos complexos e consulte separadamente - Timeout de execução: máximo de 10 minutos por execução de fluxo