Flow Spec v1
O contrato portátil de workflow compartilhado entre autoria visual, código e agentes.
Blocchi Flow Spec v1 é a representação portátil de um workflow.
O contrato exclui intencionalmente tenant ID, revisão do workflow e estado de lifecycle. Esses campos pertencem à plataforma.
executionMode é uma política de interação no nível do workflow, não uma permissão do Agent. agent-driven é o padrão compatível com workflows existentes. guided pausa após cada etapa de raciocínio do Agent para continuação humana, preservando todas as regras independentes de aprovação de Governed Actions.
Checkpoints gerados pelo modo Guided são detalhes internos do runtime. Autoria visual, Flow-as-code e MCP retornam o grafo portátil sem esses nodes de Approval gerados.
Limites no v1
- Nome: 1–200 caracteres.
- Descrição: até 2.000 caracteres.
- Modo de execução:
guidedouagent-driven. - Nodes: 1–200.
- Edges: até 500.
- Campos top-level desconhecidos são rejeitados.
Um único schema
Autoria visual, Flow-as-code e flows criados por agentes fazem round-trip pelo mesmo contrato. Se uma capacidade não puder ser representada com segurança no Flow Spec, ela não deve criar uma segunda linguagem oculta de workflow.
Clientes MCP pertencentes a usuários humanos podem usar blocchi.list_workflows, blocchi.get_workflow, blocchi.create_workflow e blocchi.save_workflow_revision. Create/save usam exatamente o contrato Flow Spec v1, incluindo executionMode, e criam revisões imutáveis em draft pelo mesmo serviço de workflow usado pela UI. A ativação continua sendo uma etapa separada de governança humana.
A persistência de workflows atualmente registra autoria contra um perfil humano. Por isso, essas ferramentas MCP de autoria ficam intencionalmente indisponíveis para service actors, em vez de representar uma identidade não humana como se fosse uma pessoa.
Acompanhamento da execução (prévia)
O editor visual define o workflow; em Atividade é possível acompanhar o que realmente foi executado. A visualização da Sala de Controle para execuções (PR #987, em draft) usa a revisão imutável exata vinculada à execução, o node atual e seu histórico de eventos. As bolhas reutilizam a experiência de Blocchi Views e levam aos detalhes existentes e ao Trabalho Humano. O grafo de autoria continua sendo a referência para ramificações, loops e dependências; o resumo de execução não inventa conexões lineares entre nodes.
A página Automação oferece outra Sala de Controle, restrita a administradores, para execuções recentes de agentes e para os passos da revisão ativa de um plano. Concluir um passo não significa comprovar o resultado de negócio nem avançar uma etapa de venda. Ambas as visualizações são somente leitura.
O GET /v1/ecosystem/operating-runs/{runId} e
blocchi.get_agent_run continuam sujeitos ao escopo da identidade de
automação. Esta visualização não cria uma API ou ferramenta MCP de escrita
genérica. A PR #987 exige certificação local e no navegador antes do
lançamento.
Última atualização em