uip maestro flow

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

UiPath Flow プロジェクトの作成、パッケージ化、デバッグ、運用uip maestro flow UiPath Flow プロジェクトです。グラフ形式のワークフローで、ノード (アクティビティ、トリガー、コネクタ) をエッジで接続して構成されています。フローは、UiPath の 2 つのオーケストレーション サーフェスの 1 つです。詳しくは、「BPMN ベースのビジネス プロセス オーケストレーション」の兄弟 uip maestro をご覧ください。

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.

Flow と Maestro の使い分け

表面	グラフの形状	アセット ファイル	主なユース ケース
フロー	視覚的なノードとエッジのグラフ	.flow (JSON)	エージェンティック ワークフロー、コネクタ オートメーション、AI ノード チェーン
Maestro	BPMN 2.0 ダイアグラム	.bpmn	長期実行、人間参加型のビジネス プロセス オーケストレーション

どちらのツールも .nupkg パッケージを Orchestrator にパブリッシュし、ランタイム プリミティブ (processes、 instance、 incident、 job、 registry) を共有します。

オーサリング フロー

Flowプロジェクトは、 project.uiproj マニフェストと1つ以上の .flow ファイル(およびパック時に生成されるサポートファイル)を含むディレクトリです。

# 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

オーサリングコマンド

コマンド	目的
uip maestro flow init	新しい 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	スキーマ (およびガバナンス ポリシー) に照らして .flow ファイルを検証します
uip maestro flow debug	プロジェクトを Studio Web にアップロードし、デバッグ セッションを実行します
uip maestro flow pack	デプロイ可能な .nupkg
uip maestro flow registry	使用可能なノードの種類を参照して検索する (OOTB + コネクタ)

変数、バインド、およびレイアウト ヘルパー

これらのCLIサーフェスはまだサイドバーにはありませんが、現在呼び出すことができます—それらはプログラムで .flow JSONを編集するための薄いラッパーです。

• uip maestro flow variable — add / list / remove top-level workflow variables (in, out, inout). See node-edge.md.
• uip maestro flow variable-update — 完了時に実行されるノード(=js:ctx.output)にJS代入式をアタッチします。
• uip maestro flow binding — add / list / remove resource bindings (process, agent, connection, etc.) that are resolved at publish time.
• uip maestro flow format — 自動レイアウト: オーバーラップを除去するためにノードを再配置します。

実行時

実行時に、パブリッシュされたフロー パッケージは Orchestrator 上の プロセス になります。1 つ起動する とインスタンスが作成されます。各実行試行は ジョブです。失敗 はインシデントとして表面化します。

コマンド	目的
uip maestro flow process	デプロイ済みのフロー プロセスの一覧を表示して実行する Flow プロセス (list、 get、 run)
uip maestro flow processes	複数のフォルダーにわたるプロセスの概要、およびプロセスごとのインシデント
uip maestro flow instance	実行中のインスタンス (list、 get、 pause、 resume、 cancel、 retry、 migrate、 goto、 variables、...) を検査およびステアリングします。
uip maestro flow incident	インシデントの概要と詳細を読む
uip maestro flow job	トレース (traces) をストリームし、ジョブのステータスを検査する

Orchestrator 内のジョブとプロセスは、Orchestrator ツールを使用して操作されます。詳しくは、「 Orchestrator のジョブ と Orchestrator のプロセス」をご覧ください。

命名規則

• すべての uip maestro flow サブコマンドは、 グローバルオプション (--output、 --output-filter、 --log-level、 --log-file) を尊重します。
• 既定の出力は JSON です。
• 終了コードは 標準コントラクトに従います。
• ほとんどのランタイム コマンドでは、最初に uip login が必要です — 「認証」をご覧ください。

参照

• uip maestro — BPMN のビジネス プロセス オーケストレーションの兄弟
• ツール (プラグイン)
• 認証
• グローバル オプション、 終了コード