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.
Última atualização em