Flux Maestro uip

Commandes pour la création, la compression, le débogage et l'exploitation de projets de workflow de forme graphique UiPath Flow à l'aide de l'outil « uip maestro flow ».

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.

L'outil est livré dans le cadre du plug-in @uipath/maestro-tool (préfixe de commande maestro flow). Voir Outils pour savoir comment les plug-ins sont installés et versionnés.

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	Ajouter, configurer, répertorier et supprimer des nœuds dans un fichier .flow
uip maestro flow edge	Ajouter, répertorier et supprimer des bords entre les nœuds
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 debug-instance	Contrôle de la session de débogage au niveau inférieur, étape par étape
uip maestro flow eval	Gérer les évaluateurs/ensembles d’évaluation/points de données et les exécuter dans Studio Web
uip maestro flow hitl	Ajouter un nœud Human-in-the-Loop à un fichier .flow
uip maestro flow migrate	Mettre à niveau un fichier .flow vers la version actuelle du schéma
uip maestro flow pack	Créer un déployable .nupkg
uip maestro flow publish	Créer le package et télécharger directement dans les packages Orchestrator
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 — ajouter / répertorier / supprimer les variables de workflow de niveau supérieur (in, out, inout). Voir node-edge.md.
• uip maestro flow binding — ajouter / répertorier / supprimer les liaisons de ressources (processus, agent, connexion, etc.) qui sont résolues au moment de la publication.
• 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