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 écrit, compresse, débogue et exploite des projets UiPath Flow — workflows de forme graphique composés de nœuds (activités, déclencheurs, connecteurs) connectés par des bords. Flow est l'une des deux interfaces d'orchestration dans UiPath; voir uip maestro pour l'orchestration des processus métier basée sur BPMN, son frères.

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.

Quand utiliser Flow vs Maestro

Surface	Format du graphique	Fichier de ressource	Cas d'utilisation principal
Flux	Graphique visuel des nœuds et des bords	.flow (JSON)	Workflows agentiques, automatisations des connecteurs, enchaînement des nœuds d'IA
Maestro	Diagramme BPMN 2.0	.bpmn	Orchestration des processus métier de longue durée

Les deux outils publient des packages .nupkg dans Orchestrator et partagent les primitives d'exécution (processes, instance, incident, job, registry).

Création du flux

Un projet Flow est un répertoire avec un manifeste project.uiproj et un ou plusieurs fichiers .flow (ainsi que les fichiers associés générés au moment du package).

# 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

Création de commandes

Commande	Objectif
uip maestro flow init	Élaborer un nouveau projet Flow
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	Valider un fichier .flow par rapport au schéma (et à la politique de gouvernance)
uip maestro flow debug	Charger le projet dans Studio Web et exécuter une session de Debug
uip maestro flow pack	Créer un déployable .nupkg
uip maestro flow registry	Parcourir et rechercher les types de nœuds disponibles (OOTB + connecteur)

Assistants de variable, de liaison et de mise en page

Ces interfaces CLI ne se trouvent pas encore sur la barre latérale, mais sont appelables aujourd'hui — ce sont des encapsuleurs légers pour modifier le JSON .flow par programmation:

• uip maestro flow variable — add / list / remove top-level workflow variables (in, out, inout). See node-edge.md.
• uip maestro flow variable-update — joignez une expression d'affectation JS à un nœud (=js:ctx.output) qui s'exécute à la fin.
• uip maestro flow binding — add / list / remove resource bindings (process, agent, connection, etc.) that are resolved at publish time.
• uip maestro flow format — mise en page automatique: repositionnez les nœuds pour supprimer les chevauchements.

Runtime

Lors de l'exécution, un paquet de flux publié devient un processus sur Orchestrator. L'étape de démarrage crée une instance; chaque tentative d'exécution est une tâche; les échecs font l'objet d' un incident.

Commande	Objectif
uip maestro flow process	Répertorier et exécuter les processus de flux déployés (list, get, run)
uip maestro flow processes	Résumés des processus dans tous les dossiers et incidents par processus
uip maestro flow instance	Inspectez et pilotez les instances en cours d'exécution (list, get, pause, resume, cancel, retry, migrate, goto, variables, …)
uip maestro flow incident	Lire les résumés et les détails des incidents
uip maestro flow job	Flux des traçages (traces) et inspecter le statut de la tâche

Les tâches et les processus dans Orchestrator sont manipulés via l'outil Orchestrator — voir Tâches Orchestrator et Processus Orchestrator.

Conventions

• Chaque sous-commande uip maestro flow respecte les options globales (--output, --output-filter, --log-level, --log-file).
• La sortie par défaut est JSON.
• Les codes de sortie suivent le contrat standard.
• La plupart des commandes de runtime nécessitent d'abord uip login - voir Authentification.

Voir également

• uip maestro — Simultanéité BPMN pour l'orchestration des processus métier
• Outils (extensions)
• Authentification
• Options globales, codes de sortie