- はじめに
- Maestro Automate とは?
- 登録
- コーディング エージェントを設定する
- 最初のワークフロー
- 開発
- デプロイして実行する
- 例
- 参照
Maestro Automate とは?
Maestro Automate: トリガーやノードからテスト、デプロイ、実行履歴に至るまでのワークフローの各要素を、1 つの注文受付の例に示します。
Maestro Automate は、AI エージェントと API が連携するワークフローを構築するための UiPath 製品です。ワークフローとは、ワークフローの開始時、スケジュールに従うとき、または別のアプリで何かが発生したときに実行される一連のステップです。このページでは、1 つのワークフロー (注文の取り込み) を、最初のノードから実行履歴まで追跡し、Maestro Automate の各部分の動作を確認できます。
例: 受注
オンライン ストアは顧客からの注文を受け取ります。注文を受け付ける前に、店舗は商品の在庫があることと、顧客の信用が良好かどうかという 2 つのことを知りたいと考えています。受理された注文は、顧客関係管理 (CRM) アプリに入力されます。残りは営業担当者に送られ、営業担当者が顧客をフォローアップします。
手作業で行うと、注文ごとに 2 回の検索と決定が行われます。Maestro Automate では、これは 1 つのワークフローです。
各ボックスは 1 つのノードです。各ノードは 1 つのジョブを実行し、その結果をノードに渡します。ノード間の線はエッジであり、ノードが実行される順序を設定します。これらすべては、コーディング エージェントにワークフローを説明するか、ノードを自分で追加することによって、視覚的なワークスペースであるフロー キャンバスで構築します。
ワークフローはどのように始まりますか?
使用する手順は、[ 新しい注文]、[ 手動トリガー] です。
すべてのワークフローはトリガーで始まります。トリガーによって、ワークフローの実行タイミング (開始時、スケジュールに従う、または別のアプリで何かが発生した時) が決まります。この例では、「 新規注文 は 手動トリガーです。」というエラーの実行ごとに、1 つの注文の製品 ID と顧客 ID が入力として受け取ります。ライブストアでは、代わりに注文が到着するたびに コネクタ トリガーでワークフローを開始することができます。各注文はワークフローの独自の実行を開始するので、10 個の注文は 10 回の実行を意味します。
[トリガー] にトリガーの種類を示します。
データはどこから取得されるのですか?
使用します: Check stock と Check credit、2 つの HTTP 要求 ノード。
HTTP 要求ノードが別のシステムの API を呼び出します。在庫確認は在庫システムに品目が利用可能かどうかを尋ね、クレジット確認は顧客について与信システムに尋ねます。
各回答は、そのノードの出力になります。ノードはデータを自動的に共有しないため、後のノードは式を介して前のノードの出力を読み取ります。たとえば、Check stock の応答の$vars.checkStock.output.bodyです。変数とデータ フローは 、ノード間でデータがどのように移動するかを記述します。
誰が決めるのか?
使用します。 [注文確認]、[ 自律型エージェント ] ノード。
エージェントとは、ユーザーが指示とツールを与える AI モデルです。決まったルールに従う代わりに、注文と両方の回答を読み、注文を受け入れるかどうかを決定します。ガードレールは、エージェントが受け取り、返す内容をスクリーニングするルールです。たとえば、プロンプトに個人データが表示されないようにするためです。
ワークフローに AI エージェントを追加するには、その設定方法を示します。
この後の流れ
使用します。[ 承諾?] ( [判断 ] ノード)、[ CRM で注文を作成] ノード、CRM コネクタの代わりとなるスクリプト ノード、および [ 営業担当者に通知] (Slack コネクタ ノード) です。
判断ノードは 1 つの条件をチェックし、その実行を 2 つのパスのいずれかに送信します。エージェントが注文を受け入れると、 CRM の [注文を作成] に その注文が記録されます。見逃しない場合、[ 営業担当者に通知 ] は Slack で営業担当者にメッセージを投稿します。
Notify 営業担当 は、別のアプリとの既製の連携であるコネクタを使用するため、API 呼び出しを自分で記述する必要はありません。コネクション、つまりそのアプリのアカウントを介して Slack にサインインします。[コネクタ] にはすべてのコネクタが一覧表示され、[ Slack ] では Slack コネクタで何ができるかが説明されています。
それは機能しますか?テストしてみる
使用します。 キャンバスの下部のツールバーにある [デバッグを実行 ] (▶) を使用して、デバッグ実行を開始します。
ワークフローに依存する前に、ワークフローをテストします。[ デバッグを実行] を選択し、ダイアログで入力を求められたらトリガーの入力を入力すると、ワークフローがキャンバス上で実行され、サンプル データが表示されます。この例では、サンプル注文を使用して実行します。
- 各ノードを実行すると、成功すると緑色のチェック マークが、失敗すると赤色のマークが表示されます。
- 実行トレースには、実行されたすべてのノードと、実行にかかった時間が順番に一覧表示されます。[ 注文を確認 ] を選択して、エージェントが受け取った注文データと返された決定を確認します。
- ノードに障害が発生すると、[ インシデント ] タブにエラーが表示されます。たとえば、インベントリ システムにアクセスできなかったなどのエラーです。
- 1 つのステップを詳しく確認するには、ブレークポイントを追加します。ノード上でホバーし、[ ⋮ (その他のオプション)] > [ ブレークポイントを追加] を選択します。そのノードで実行が一時停止します。
- 実際のシステムを呼び出さずにテストするには、ノードをモックします。代わりに、定義したサンプル データが返されます。出力モックでは 、その方法について説明します。
エージェントは、同じ注文であっても、実行するたびに異なる回答を行うことができます。評価によって、エージェントが実行間で信頼性が維持されていることを確認します。予想される判断に基づいてサンプル注文を収集し、ワークフロー全体を実行して、結果を比較します。デプロイ前に実行し、エージェントの指示またはモデルを変更した後にもう一度実行します。評価の設定方法については、「評価」をご覧ください。
「デバッグの基本」では、テスト ツールについて詳しく説明しています。
本稼働: デプロイ
テストと評価で期待される結果が得られたら、ワークフローをデプロイします。それ以降は、新しい注文はすべて、キャンバスを開かずに実行を開始します。
ワークフローをデプロイする 手順について説明します。
すべての注文が実行になります
各実行は 24 時間以内に完了する必要があり、同時に最大 50 回の実行を進行できます。「制限とフェアユース」では、制限について説明します。人間が 1 人の場合など、待機時間が長いプロセスの場合、「 Maestro Orchestrate に変換 」では、ワークフローを Maestro Orchestrate に移行するタイミングについて説明します。
CRM が利用できないなどためにステップが失敗した場合、実行はそのステップで一時停止して待機します。CRM が復元されたら、失敗したステップから実行をリトライするか、キャンセルします。「リトライしてキャンセルする」で、その方法について説明します。また、ノードのエラー パスを他のステップ (チームへのメッセージなど) に接続して、ワークフローでエラー自体を処理するようにすることもできます。「エラー処理」 では、その方法について説明します。
何が起こったのですか?実行履歴
Maestro は、すべての実行を終了後 30 日間保持します。各注文について、実行を開始した理由、実行がたどったパス、およびすべてのステップのデータとタイミングを確認できます。「実行の監視」では、その方法について説明します。
表示された内容
どのワークフローも同じ 5 つのステージを経て、すべてのステージで同じワークフロー ファイルが使用されます。そのため、テスト対象はデプロイ後に実行されます。
- 構築: トリガー、それぞれが 1 つのジョブを実行するノード、順序を設定するエッジ。
- テスト: サンプル データを使用したデバッグ実行と、エージェントの判断の評価。
- デプロイ: ワークフローが稼働し、トリガーの実行を開始します。
- 実行: 注文ごとに 1 回実行。ステップが失敗すると、リトライまたはキャンセルするまで実行は一時停止します。
- 監視: 30 日間の実行履歴。
他に構築できるもの
注文受付ワークフローでは、いくつかの種類のノードを使用します。[ ノードを追加] パネルには、さまざまな機能が、実行する作業の種類別にグループ化されています。
| 目標 | カテゴリ (Category) | ノードには以下が含まれます |
|---|---|---|
| ワークフローは、オンデマンドで、スケジュールに基づいて開始するか、または別のアプリで何かが発生したときに開始します | トリガー | 手動トリガー、フォーム トリガー、スケジュール設定済みトリガー、コネクタ トリガー |
| 個人データとプロンプト インジェクションのガードレールを使用して、AI に決定、書き込み、回答を任せる | オペレーター | 自律型エージェント、会話型エージェント (プレビュー)、音声エージェント (プレビュー) |
| 別のアプリまたは API から読み取るか、別のアプリまたは API で操作する | コネクタ | HTTP 要求、 および Salesforce 、 ServiceNow 、 Slack などのアプリ用の コネクタ |
| データの形状を変更するか、Data Fabric に保存する | データ | バッチ変換、フィルター、グループ化、マップ、変換、Data Fabric エンティティ レコード |
| ドキュメントからデータを抽出したり、要約したりする | ドキュメント (プレビュー) | [ドキュメントを要約]、[抽出] |
| 人間にフォームの承認または入力を依頼する | 人間 | クイック フォーム、アクション アプリ |
| 分岐、繰り返し、または停止 | 制御 | 判断、切り替え、ループ、結合、終了、終了 |
| 独自のコードを実行するか、作業をキューに追加する | ツール | スクリプト、キュー ツール |
| 時間が経過するかイベントが到来するまで一時停止します | イベントを待機 | 待機、コネクタ イベント、HTTP Webhook |
| 既存のワークフロー、エージェント、ロボット、または API ワークフローを再利用する | 既存の作業を呼び出す | Maestro Flow、Maestro BPMN、Maestro Case、RPA ワークフロー、API ワークフロー、関数 (プレビュー) |
構築する場所
構築する最も簡単な方法は、Claude Code や Codex などのコーディング エージェントにワークフローを記述し、そのエージェントにワークフローを構築させることです。コーディング エージェントを設定するには 、3 つのステップで準備を整えます。
フロー キャンバス上で自身で構築するには、VS Code、ブラウザーの Studio Web、またはデスクトップ版の Studio を使用します。キャンバスは 3 つすべてで同じです。[構築する場所] では、それらを比較します。
次のステップ
- 登録: サインインするか、UiPath のアカウントを作成します。
- 最初のワークフロー: この受注ワークフローを約 15 分で自分で構築します。
- コミュニティ: 質問したり、他のビルダーとワークフローを共有したりできます。