- はじめに
- UiPath Agents の利用を開始する
- LangGraph を使用した UiPath Agents の利用を開始する
- Studio Web でローコード エージェントを構築する
- UiPath エージェントにツールを追加する
- Getting Started with UiPath Maestro Flow
フローをテストする
[デバッグ] を使用して価格ウォッチ フローをテストし、これをアップロードし、UiPath Cloud アカウントでデバッグ セッションとして実行し、出力を確認します。
フローを 2 回実行してテストし、現在の為替レートに基づいて各分岐をテストします。デバッグ実行では、フローをパブリッシュしてデプロイした場合と同じ方法でフローが実行されます。HTTP 要求ノードはフランクフルトを呼び出し、スクリプト・ノードは JavaScript を実行し、意思決定ノードはその 2 つのパスのいずれかを取ります。デバッグ実行は、サインインしているテナントのサーバー側で実行され、マシン上ではなく クラウドで 実行されます。
デバッグ実行は実際の実行です。API 呼び出しが発生し、フローに発生する副作用は実際の副作用です。フランクフルトは読み取り専用のパブリック サービスであるため、価格ウォッチの実行ではフランクフルト API 呼び出しによるコストは発生しませんが、フローがシステムに書き込まれると、デバッグ実行が運用トラフィックとして扱われます。
手順 4 - フローをテストする
フローをテストするには、VS Code の [デバッグ] ボタンを使用する方法 (オプション 1) と CLI コマンドを使用する方法 (オプション 2) の 2 つがあります。好みに応じて、どちらか、または両方を選択できます。
レートは各取引日に変動し、フランクフルトAPIは過去の日の最終レートのみを提供します。数値は、API を呼び出すタイミングに応じて、このチュートリアルの数値とは異なります。
オプション 1 - VS Code を使用してフローをテストする
-
キャンバスのツールバーで [ デバッグ ] を選択します (再生ボタン - ▶️ )。
-
プロンプトが表示されたときに、3 つのトリガー入力の値を指定します。以前に設定した既定値をそれぞれに設定する必要があります。
-
エディターの下部にある実行パネルで、トレースが 1 ノードずつ入力されていく様子を確認します。
実行が完了すると、各ノードに成功または失敗のインジケーターが表示されます。endAlert1 ノードが終了ノードだった場合の、正常な実行の様子は次のとおりです。
同じ手順に従って endNoAction1 ノードをテストし、 alertThreshold 現在のレートを下回る値に変更します (これは時間の経過とともに変化します)。0.1 を使用して [アクションなし] 分岐を確認すると、実行が成功すると次のようになります。
オプション 2 - CLI を使用してフローをテストする
uip コマンドを使用してターミナルからデバッグ実行を実行するには、デバッグを 2 回実行して両方の分岐をテストする必要があります。Alert ブランチを最初にテストするには、PriceWatchディレクトリではなく、ソリューションの最上位ディレクトリから以下を使用します。
uip maestro flow debug PriceWatch \
--inputs '{"baseCurrency": "USD", "quoteCurrency": "EUR", "alertThreshold": 0.9}' \
--output table \
--output-filter 'elementExecutions'
uip maestro flow debug PriceWatch \
--inputs '{"baseCurrency": "USD", "quoteCurrency": "EUR", "alertThreshold": 0.9}' \
--output table \
--output-filter 'elementExecutions'
応答は "Debug completed with status: Completed" で終わる必要があります。また、ログとトレースを関連付けるためのインスタンス ID が付きます。
上記の値では、本稿執筆時点ではEURへのUSD率は0.86111されており、 は 0.9未満であるため、判断ノードはアラート パスをたどり、実行は endAlert1で終了します。以下の応答では、 Data.elementExecutions にこの情報が含まれているため、コマンドに --output-filter 'elementExecutions' を追加することによってのみその情報が表示されます。
elementId | elementType | status | startedAt | completedAt
--------------------------------------|------------------|-----------|------------------------------|-----------------------------
start | StartEvent | Completed | 2026-09-09T14:45:11.1800316Z | 2026-09-09T14:45:11.5424344Z
fetchRate1 | SubProcess | Completed | 2026-09-09T14:45:12.0084766Z | 2026-09-09T14:45:15.4191562Z
_Implicit_StartEvent_fetchRate1 | StartEvent | Completed | 2026-09-09T14:45:12.5480076Z | 2026-09-09T14:45:12.811941Z
_Implicit_HttpTask_fetchRate1 | SendTask | Completed | 2026-09-09T14:45:13.1623209Z | 2026-09-09T14:45:14.0727369Z
_Implicit_EndEvent_Default_fetchRate1 | EndEvent | Completed | 2026-09-09T14:45:14.6862017Z | 2026-09-09T14:45:14.9360746Z
reshapeRate1 | ScriptTask | Completed | 2026-09-09T14:45:15.6366731Z | 2026-09-09T14:45:15.973426Z
belowThreshold1 | InclusiveGateway | Completed | 2026-09-09T14:45:16.3758949Z | 2026-09-09T14:45:16.4578181Z
endAlert1 | EndEvent | Completed | 2026-09-09T14:45:16.7053678Z | 2026-09-09T14:45:17.0385488Z
elementId | elementType | status | startedAt | completedAt
--------------------------------------|------------------|-----------|------------------------------|-----------------------------
start | StartEvent | Completed | 2026-09-09T14:45:11.1800316Z | 2026-09-09T14:45:11.5424344Z
fetchRate1 | SubProcess | Completed | 2026-09-09T14:45:12.0084766Z | 2026-09-09T14:45:15.4191562Z
_Implicit_StartEvent_fetchRate1 | StartEvent | Completed | 2026-09-09T14:45:12.5480076Z | 2026-09-09T14:45:12.811941Z
_Implicit_HttpTask_fetchRate1 | SendTask | Completed | 2026-09-09T14:45:13.1623209Z | 2026-09-09T14:45:14.0727369Z
_Implicit_EndEvent_Default_fetchRate1 | EndEvent | Completed | 2026-09-09T14:45:14.6862017Z | 2026-09-09T14:45:14.9360746Z
reshapeRate1 | ScriptTask | Completed | 2026-09-09T14:45:15.6366731Z | 2026-09-09T14:45:15.973426Z
belowThreshold1 | InclusiveGateway | Completed | 2026-09-09T14:45:16.3758949Z | 2026-09-09T14:45:16.4578181Z
endAlert1 | EndEvent | Completed | 2026-09-09T14:45:16.7053678Z | 2026-09-09T14:45:17.0385488Z
終了ノードは 1 つだけ表示され、これによりどの分岐が実行されたかを確認できます。fetchRate1の下に入れ子になった _Implicit_* エントリは、サブプロセスに展開される管理対象の HTTP ノードです。
実行完了時に各グローバル変数 ( Data.variables.globals単位) で何が保持されていたかを確認するには、完全な JSON 出力を表示する --output table オプションを指定せずにもう一度実行します。
uip maestro flow debug PriceWatch \
--inputs '{"baseCurrency": "USD", "quoteCurrency": "EUR", "alertThreshold": 0.9}' \
--output-filter 'variables.globals'
uip maestro flow debug PriceWatch \
--inputs '{"baseCurrency": "USD", "quoteCurrency": "EUR", "alertThreshold": 0.9}' \
--output-filter 'variables.globals'
返される JSON 内でこれらのセクションを探します。具体的には "belowThreshold": trueの行です。
{
"reshapeRate1.output": {
"pair": "USD/EUR",
"rate": 0.85946,
"asOf": "2026-09-10",
"belowThreshold": true
},
"start.output.baseCurrency": "USD",
"start.output.quoteCurrency": "EUR",
"start.output.alertThreshold": 0.9,
"watchResult": {
"pair": "USD/EUR",
"rate": 0.85946,
"asOf": "2026-09-10",
"belowThreshold": true
}
}
{
"reshapeRate1.output": {
"pair": "USD/EUR",
"rate": 0.85946,
"asOf": "2026-09-10",
"belowThreshold": true
},
"start.output.baseCurrency": "USD",
"start.output.quoteCurrency": "EUR",
"start.output.alertThreshold": 0.9,
"watchResult": {
"pair": "USD/EUR",
"rate": 0.85946,
"asOf": "2026-09-10",
"belowThreshold": true
}
}
上記のコマンドには、 --output-filter 'elementExecutions' と --output-filter 'variables.globals' が含まれており、応答の対象となる部分のみを返します。省略すると、すべての詳細を含む完全な JSON 応答が表示されます。--output table パラメーターは最初のコマンドで使用され、JSON 出力を読みやすいテキスト テーブルに書式設定することもできます。JSON フィールドが入れ子になっているため、2 番目のコマンドでは使用しません。読みづらいです。 --output tableを追加して自分で試してみてください。
次に、 No action ブランチをテストします。意図的に False パスを使用するには、 を に設定して別のデバッグalertThreshold0.1。この場合、レートはしきい値を超え belowThreshold falseになり、実行は endNoAction1で終了します。
uip maestro flow debug PriceWatch \
--inputs '{"baseCurrency": "USD", "quoteCurrency": "EUR", "alertThreshold": 0.1}' \
--output table \
--output-filter 'elementExecutions'
uip maestro flow debug PriceWatch \
--inputs '{"baseCurrency": "USD", "quoteCurrency": "EUR", "alertThreshold": 0.1}' \
--output table \
--output-filter 'elementExecutions'
以下の出力を見ると、最後の行で ではなく endNoAction1 が実行されたことがわか endAlert。
elementId | elementType | status | startedAt | completedAt
--------------------------------------|------------------|-----------|------------------------------|-----------------------------
start | StartEvent | Completed | 2026-09-09T19:35:16.9481084Z | 2026-09-09T19:35:17.8183474Z
fetchRate1 | SubProcess | Completed | 2026-09-09T19:35:18.2733427Z | 2026-09-09T19:35:23.0056514Z
_Implicit_StartEvent_fetchRate1 | StartEvent | Completed | 2026-09-09T19:35:19.2552152Z | 2026-09-09T19:35:19.6644838Z
_Implicit_HttpTask_fetchRate1 | SendTask | Completed | 2026-09-09T19:35:20.0168686Z | 2026-09-09T19:35:21.5714821Z
_Implicit_EndEvent_Default_fetchRate1 | EndEvent | Completed | 2026-09-09T19:35:21.8821048Z | 2026-09-09T19:35:22.2081364Z
reshapeRate1 | ScriptTask | Completed | 2026-09-09T19:35:23.7685642Z | 2026-09-09T19:35:24.3541723Z
belowThreshold1 | InclusiveGateway | Completed | 2026-09-09T19:35:24.6927348Z | 2026-09-09T19:35:24.8111957Z
endNoAction1 | EndEvent | Completed | 2026-09-09T19:35:25.393084Z | 2026-09-09T19:35:26.086936Z
elementId | elementType | status | startedAt | completedAt
--------------------------------------|------------------|-----------|------------------------------|-----------------------------
start | StartEvent | Completed | 2026-09-09T19:35:16.9481084Z | 2026-09-09T19:35:17.8183474Z
fetchRate1 | SubProcess | Completed | 2026-09-09T19:35:18.2733427Z | 2026-09-09T19:35:23.0056514Z
_Implicit_StartEvent_fetchRate1 | StartEvent | Completed | 2026-09-09T19:35:19.2552152Z | 2026-09-09T19:35:19.6644838Z
_Implicit_HttpTask_fetchRate1 | SendTask | Completed | 2026-09-09T19:35:20.0168686Z | 2026-09-09T19:35:21.5714821Z
_Implicit_EndEvent_Default_fetchRate1 | EndEvent | Completed | 2026-09-09T19:35:21.8821048Z | 2026-09-09T19:35:22.2081364Z
reshapeRate1 | ScriptTask | Completed | 2026-09-09T19:35:23.7685642Z | 2026-09-09T19:35:24.3541723Z
belowThreshold1 | InclusiveGateway | Completed | 2026-09-09T19:35:24.6927348Z | 2026-09-09T19:35:24.8111957Z
endNoAction1 | EndEvent | Completed | 2026-09-09T19:35:25.393084Z | 2026-09-09T19:35:26.086936Z
に設定された値を取得するには、次のコマンドを実行しますvariables.globals
uip maestro flow debug PriceWatch --output-filter 'variables.globals' --inputs \
'{"baseCurrency": "USD", "quoteCurrency": "EUR", "alertThreshold": 0.1}'
uip maestro flow debug PriceWatch --output-filter 'variables.globals' --inputs \
'{"baseCurrency": "USD", "quoteCurrency": "EUR", "alertThreshold": 0.1}'
返される JSON で次のセクションを探します。具体的には "belowThreshold": falseの行です。
{
"reshapeRate1.output": {
"pair": "USD/EUR",
"rate": 0.85946,
"asOf": "2026-09-10",
"belowThreshold": false
},
"start.output.baseCurrency": "USD",
"start.output.quoteCurrency": "EUR",
"start.output.alertThreshold": 0.1,
"watchResult": {
"pair": "USD/EUR",
"rate": 0.85946,
"asOf": "2026-09-10",
"belowThreshold": false
}
}
{
"reshapeRate1.output": {
"pair": "USD/EUR",
"rate": 0.85946,
"asOf": "2026-09-10",
"belowThreshold": false
},
"start.output.baseCurrency": "USD",
"start.output.quoteCurrency": "EUR",
"start.output.alertThreshold": 0.1,
"watchResult": {
"pair": "USD/EUR",
"rate": 0.85946,
"asOf": "2026-09-10",
"belowThreshold": false
}
}
両方のパスを 1 回実行すると、両方のブランチで [判断] ノードが正しく配線されていることを確認するのに最も早く役立ちます。2 回目の実行が endNoAction1 時に終了し、 watchResult が に設定され belowThreshold に設定されていることを確認します false。
(任意)別の通貨でテストする
別の相場通貨 ( "quoteCurrency": "GBP"など) で 3 回目の実行を試し、スクリプト ノードのルックアップが密 EURに関連付けられていないことを確認します。watchResult のpairとrateは、要求した通貨に従う必要があります。
uip maestro flow debug PriceWatch --output-filter 'variables.globals' --inputs \
'{"baseCurrency": "USD", "quoteCurrency": "GBP", "alertThreshold": 0.9}'
uip maestro flow debug PriceWatch --output-filter 'variables.globals' --inputs \
'{"baseCurrency": "USD", "quoteCurrency": "GBP", "alertThreshold": 0.9}'
{
"reshapeRate1.output": {
"pair": "USD/GBP",
"rate": 0.73782,
"asOf": "2026-09-10",
"belowThreshold": true
},
"start.output.baseCurrency": "USD",
"start.output.quoteCurrency": "GBP",
"start.output.alertThreshold": 0.9,
"watchResult": {
"pair": "USD/GBP",
"rate": 0.73782,
"asOf": "2026-09-10",
"belowThreshold": true
}
}
{
"reshapeRate1.output": {
"pair": "USD/GBP",
"rate": 0.73782,
"asOf": "2026-09-10",
"belowThreshold": true
},
"start.output.baseCurrency": "USD",
"start.output.quoteCurrency": "GBP",
"start.output.alertThreshold": 0.9,
"watchResult": {
"pair": "USD/GBP",
"rate": 0.73782,
"asOf": "2026-09-10",
"belowThreshold": true
}
}
次のステップ
期待どおりに動作していることを確認したので、UiPath クラウド アカウントのテナントに フローをデプロイ します。