uip maestro flow

Commands for authoring, packing, debugging, and operating UiPath Flow graph-shaped workflow projects using the `uip maestro flow` tool.

uip maestro flow , pacotes, depurações e opera projetos UiPath Flow — fluxos de trabalho em forma de gráficos feitos de nós (atividades, gatilhos, conectores) conectados por bordas. Flow é uma das duas superfície de orquestração no UiPath; consulte uip maestro para orquestração de processos de negócios baseada em BPMN.

The tool is shipped as part of the @uipath/maestro-tool plugin (command prefix maestro flow). See Tools (plugins) for how plugins are installed and versioned.

Quando usar Flow versus Maestro

Superfície	Forma de gráfico	Arquivo do ativo	Caso de uso principal
Fluxo	Gráfico visual de nós e borda	.flow (JSON)	Fluxos de trabalho de agentes, automações de conectores, encadeamento de nós de IA
Maestro	Diagrama do BPMN 2.0	.bpmn	Orquestração de processos de negócios de longa duração com intervenção humana

Ambas as ferramentas publicam pacotes .nupkg no Orchestrator e compartilham os primitivos de runtime (processes, instance, incident, job, registry).

Fluxo de criação

Um projeto de fluxo é um diretório com um manifesto project.uiproj e um ou mais arquivos .flow (além dos arquivos de suporte gerados no momento do pacote).

# 1. Scaffold a new project
uip maestro flow init invoice-flow

# 2. Discover nodes in the registry
uip maestro flow registry pull
uip maestro flow registry search slack

# 3. Edit the .flow file — add nodes, edges, variables, bindings
uip maestro flow node add invoice-flow/invoice-flow.flow uipath.connector.slack.send-message --label "Notify"
uip maestro flow edge add invoice-flow/invoice-flow.flow start node_a1b2c3d4
uip maestro flow node configure invoice-flow/invoice-flow.flow node_a1b2c3d4 --detail '{"connectionId":"…","folderKey":"…","method":"POST","endpoint":"/…"}'

# 4. Validate structure (and optionally governance policy)
uip maestro flow validate invoice-flow/invoice-flow.flow

# 5. Run against Studio Web to smoke-test
uip maestro flow debug ./invoice-flow

# 6. Pack for deployment
uip maestro flow pack ./invoice-flow ./dist --version 1.0.0

Criando comandos

Command	Finalidade
uip maestro flow init	Estruturar um novo projeto de fluxo
uip maestro flow node	Add, configure, list, and remove nodes in a .flow file
uip maestro flow edge	Add, list, and remove edges between nodes
uip maestro flow validate	Validar um arquivo .flow em relação ao esquema (e à política de governança)
uip maestro flow debug	Carregue o projeto para o Studio Web e execute uma sessão de depuração
uip maestro flow pack	Produzir um implantável .nupkg
uip maestro flow registry	Navegue e pesquise os tipos de nó disponíveis (OTB + conector)

Auxiliares de variável, associação e layout

Essas superfícies de CLI ainda não estão na barra lateral, mas podem ser chamadas hoje — elas são wrapper finos para editar o JSON .flow programaticamente:

• uip maestro flow variable — add / list / remove top-level workflow variables (in, out, inout). See node-edge.md.
• uip maestro flow variable-update — anexe uma expressão de atribuição JS a um nó (=js:ctx.output) que é executado na conclusão.
• uip maestro flow binding — add / list / remove resource bindings (process, agent, connection, etc.) that are resolved at publish time.
• — layout uip maestro flow format : reposicionar nós para remover sobreposições.

Runtime

No runtime, um pacote de fluxo publicado torna-se um processo no Orchestrator. Iniciar um cria uma instância; cada tentativa de execução é um trabalho; as falhas aparecem como incidentes.

Command	Finalidade
uip maestro flow process	Listar e executar processos de fluxo implantados (list, get, run)
uip maestro flow processes	Resumos de processos em pastas e incidentes por processo
uip maestro flow instance	Inspecionar e orientar instâncias em execução (list, get, pause, resume, cancel, retry, migrate, goto, variables,…)
uip maestro flow incident	Ler resumos e detalhes de incidentes
uip maestro flow job	Transmitir rastreamentos (traces) e inspecionar o status dos trabalhos

Trabalhos e processos no Orchestrator devidamente são manipulados por meio da ferramenta do Orchestrator — consulte Trabalhos do Orchestrator e Processos do Orchestrator.

Convenções

• Cada uip maestro flow subcomando honra as opções globais (--output, --output-filter, --log-level, --log-file).
• A saída padrão é JSON.
• Os códigos de saída seguem o contrato padrão.
• A maioria dos comandos de runtime requer uip login primeiro — consulte Autenticação.

Veja também

• uip maestro — irmãos BPMN para orquestração de processos de negócios
• Ferramentas ( plugins )
• Autenticação
• Opções globais, Códigos de saída