Maestro ユーザーガイド

最終更新日時 2025年11月7日

Maestro でエージェントを使用する

Maestro でのエージェントの動作のしくみ

エージェントは、Maestro BPMN ワークフローでサービスタスクとして表されます。プロセスがサービスタスクを呼び出すと、Maestro は、特定のプロセスインスタンスに必要な入力パラメーターを使用して、対応するエージェントを呼び出します。

エージェントは出力データを Maestro に返し、このデータを使用してワークフローの次のステップが決定されます。使用されたツール、行われた判断、およびトレースデータを報告するようにエージェントを設定することで、デバッグと透過性をサポートできます。

エージェントは以下のことが可能です。

UiPath Platform 内で直接構築 (ローコードまたはコード化)
外部 API または Integration Service 経由で接続
ワークフローロジックに基づき、イベントまたはシグナルによってトリガー

実例を見る: UiPath Maestro: シームレスで透明性の高いローンオートメーションを司るブレーン。

Integration Service 経由でエージェントを接続する

UiPath Integration Service には、外部システムをオートメーションに連携させる次のような既製のカスタムコネクタが用意されています。

Salesforce、Microsoft 365、Google Workspace などのサービス用の事前構築済みコネクタ
任意の REST API を UiPath Platform に公開するためのカスタムコネクタビルダー
資格情報とコネクションの統合管理

Integration Service を使用すると、Maestro は、UiPath でネイティブにホストされていないエージェントやシステムとの間でデータの送受信ができるようになります。Integration Service について詳しくは、こちらをご覧ください。

外部エージェントを使用する

Maestro は特定のベンダーに依存しません。UiPath Integration Service のコネクタを使用することにより、プロセスを再構築することなく、好みの外部 AI エージェント間で作業をオーケストレーションできます。

以下のオーケストレーションが可能です。

独自の AI サービス
外部の意思決定エンジン
他のプラットフォームでホストされているマイクロサービスまたはボット

Maestro は REST エンドポイントを呼び出してこれらのエージェントを起動し、構造化データを含むレスポンスペイロードを期待します。

Integration Service 経由で外部エージェントを接続する

設計時に、サービスタスクを追加して [外部エージェントを開始して待機] を選択し、選択したコネクタからエージェントアクティビティを設定します。実行時に、Maestro はプロンプトとコンテキストをエージェントに送信し、応答を待ちます。ユーザーはその応答を変数にマッピングし、ゲートウェイ、割り当て、および後続のアクションを動作させます。

外部エージェントを接続して Maestro プロセスから実行し、その出力をキャプチャしてルーティングと意思決定を行う方法については、以下のリンクをご覧ください。

クイックスタート: API ワークフローとの連携

Integration Service のコネクタが存在する場合は、そのコネクタを優先的に使用します。API レベルの接続 (初期の API、スキーマの進化、応答のストリーミング) が必要な場合は、API ワークフローを使用します。要求と出力を宣言的に定義し、カスタムコードを使用せずに JSON を解析して、結果を Maestro プロセスに渡します。

使い分けの判断

コネクタ: システムがサポートされている、スキーマが安定している、認証が管理されている、長期的に最良の選択肢。
API ワークフロー: API が新しいかサポートされていない、応答の形状が変化する、出力がストリーミングのみである。

ステップバイステップのガイド

Snowflake Cortex - API ワークフロー: Cortex エージェントのストリーミング出力を処理し、出力を組み立てて使用可能な応答にし、ダウンストリームオートメーション用の構造化された JSON を返します。
Databricks Genie - API ワークフロー: 会話を開始して、完了までメッセージのステータスをポーリングし、生成された SQL (attachment_id) を抽出して実行し、回答を返します。