Fluxo de UIP

uip 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.

A ferramenta é enviada como o plug-in @uipath/flow-tool (prefixo de comando flow). Consulte Ferramentas ( plugins ) para saber como os plug-ins são instalados e versionados.

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 flow init invoice-flow

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

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

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

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

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

Criando comandos

Command	Finalidade
uip flow init	Estruturar um novo projeto de fluxo
uip flow node	Adicionar, configurar, listar e excluir nós em um arquivo .flow
uip flow edge	Adicionar, listar e excluir bordas entre nós
uip flow validate	Validar um arquivo .flow em relação ao esquema (e à política de governança)
uip flow debug	Carregue o projeto para o Studio Web e execute uma sessão de depuração
uip flow pack	Produzir um implantável .nupkg
uip 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 flow variable adicionar/listar/excluir variáveis de fluxo de trabalho de nível superior (in, out, inout). Consulte node-edge.md.
• uip flow variable-update — anexe uma expressão de atribuição JS a um nó (=js:ctx.output) que é executado na conclusão.
• uip flow binding adicionar / listar / excluir associações de recursos (processo, agente, conexão etc.) que são resolvidas no momento da publicação.
• — layout uip flow tidy : 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 flow process	Listar e executar processos de fluxo implantados (list, get, run)
uip flow processes	Resumos de processos em pastas e incidentes por processo
uip flow instances	Inspecionar e orientar instâncias em execução (list, get, pause, resume, cancel, retry, migrate, goto, variables,…)
uip flow incidents	Ler resumos e detalhes de incidentes
uip 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 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