maestro

latest

false

重要 :

このコンテンツの一部は機械翻訳によって処理されており、完全な翻訳を保証するものではありません。新しいコンテンツの翻訳は、およそ 1 ～ 2 週間で公開されます。

Maestro ユーザーガイド

最終更新日時 2025年12月12日

システムとデータを連携する

Data Fabric でファイルを管理する

UiPath Maestro™ では、Data Fabric (以前の Data Service) でファイルが管理されます。電子メールの添付ファイルやクラウドストレージプロバイダーなどのソースからファイルをダウンロードするたびに、そのファイルは、ファイルの保存に対応した Data Fabric のエンティティにアップロードされます。

そのファイルは、 Data Fabric 参照 (以下で構成するトリプレット) を使用して参照されます。

エンティティ名
レコード ID
フィールド名

この参照により、そのファイルをエージェンティックプロセスで使用できます。

前提条件

Maestro でファイルを使用する前に以下を確認します。

組織またはテナントで Data Fabric が有効になっている。
ファイルをサポートするフィールドを持つエンティティが設定されている。

レコードの作成時に Data Fabric によって自動的にデータが入力されるフィールドを除き、入力が必須のフィールドはありません。

ユースケースの例

この例では、Box からファイルをダウンロードし、メールの添付ファイルとして送信する方法を示します。

ファイルをダウンロード
- Box のコネクタから [ファイルをダウンロード] アクティビティを実行する送信タスクを設定します。
- ダウンロードするファイルを選択します。
- Data Fabric エディターを使用してファイルリソースの出力を設定します。ファイルをサポートするエンティティとフィールドをそれぞれ [エンティティ] と [フィールド] で選択します。
このアクティビティを実行すると、Data Fabric の新しいファイルレコードを指すData Fabric 参照 (EntityName、RecordId、FieldName) が返されます。
ファイルをメールで送信する
- Outlook コネクタの [メールを送信] アクティビティを使用して別の送信タスクを設定します。
- 前の手順で得られたレコード ID を参照して、Data Fabric エディターでファイルを添付します。

テスト後、ワークフローの変数にレコード ID が得られます。

レコード ID ビュー変数

また、レコード ID を検索して、データが Data Fabric アプリケーションに存在することも確認できます。

警告:

Maestro では、ファイルは Data Fabric を通じて排他的にサポートされます。
同じファイルが Data Fabric にすでに存在する場合は、その Data Fabric 参照を追加することでそのファイルを再利用できます。

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 ワークフロー: API が新しいかサポートされていないか、応答の形態が変化するか、出力がストリーミングのみである場合に使用します。

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

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

エージェントのプロパティ設定

Maestro では、エージェントはビジネスプロセスの参加者として扱われます。BPMN ワークフロー内では、エージェントはサービスタスクを使用して表され、UiPath がホストするエージェントと外部エージェントの両方を呼び出すことができます。各エージェントタスクは、特定の入力パラメーターと出力パラメーターを使用して設定できます。これにより、Maestro はコンテキスト対応のデータをエージェントに渡し、構造化された結果を受け取ることができます。

Maestro のサービスタスクの概要については「BPMN モデリングのタスク」をご覧ください。

エージェント実行モード

エージェントの動作は、サービスタスクの [プロパティ] パネルで定義されます。ビジネスニーズに応じて、UiPath エージェントまたは外部エージェントを呼び出すようにタスクを設定できます。

エージェントを開始して待機

このオプションは、UiPath テナントにデプロイされたエージェントを呼び出す場合に使用します。以下が含まれます。

Agent Builder などのツールを使用して作成されたローコードエージェント。
Python またはその他の言語で開発され、Orchestrator にデプロイされたコード化されたエージェント。

実行時に、Maestro は入力パラメーターを JSON 形式でエージェントに送信します。エージェントが実行を完了すると、プロセスが期待する出力値を含む応答が返されます。

[エージェントを開始して待機] のプロパティ

外部エージェントを開始して待機

このオプションは、サードパーティシステムや外部システムに接続する場合に使用します。以下を指定する必要があります。

コネクタ: 連携ターゲット (例: CrewAI、Salesforce、他のサービス)
コネクション: コネクタの構成済みインスタンスです。特定のエージェント、またはコンテキスト固有の資格情報セットを表します。

注:
複数のコネクションを定義することで、同じエージェントを異なる権限や動作で使用することができます。

入力と出力

エージェントの入力と出力は、他の種類の Maestro タスクと同じ方法で設定されます。

入力: 実行時にエージェントに渡される変数または式。
出力: エージェントの JSON 応答から入力された変数。

Maestro は、入力パラメーターを次の形式の JSON ペイロードとして送信します。

{
  "key1": "value1",
  "key2": "value2"
}
{
  "key1": "value1",
  "key2": "value2"
}

エージェントは、Maestro で期待されるパラメーター名と同じパラメーター名を使用して JSON 応答を返す必要があります。これらの値は、タスクの [プロパティ] パネルの [出力] > [応答] セクションを使用してプロセス変数にマッピングされます。

入力と出力

入力および出力の例

入力例 (Maestro からエージェントへ)

パラメーター	説明
`role`	タスクのロールまたはコンテキスト (例: 検証と要約)
`prompt`	エージェントに提供される指示 (多くの場合、プロセス固有のデータを含む)
`tools`	エージェントがタスクを完了するために使用できるツールのリスト
`user_id`	プロセスとエージェントコンテキスト間で共有される一意の識別子

プロンプトの例: "Complete loan validation for {loan_application_number}. Respond in JSON format using the parameter 'loan_application_status'."

出力例 (エージェントから Maestro へ)

パラメーター	説明
`conversation_id`	会話または対話セッションへの参照
`loan_application_status`	エージェントによって返されるステータスの結果
`tokens_used`	リソース使用状況に関するメタデータ

警告:

ワークフローでエージェントの出力を使用するには、タスクの [出力] > [応答] 設定で、各出力パラメーターをプロセス変数に割り当てる必要があります。

ビジネスルール (プレビュー)

ビジネスルールにより、RPA 開発者は DMN (Decision Model and Notation) ファイルをワークフローダイアグラムまたはプロセスダイアグラムの一部として保存および管理できます。

Orchestrator のビジネスルール

Orchestrator のビジネスルールでは、Decision Model and Notation (DMN) ベースのルールを保存し、管理できます。専用のアクティビティを使用して、このようなルールを任意のエージェンティックプロセスで評価できます。また、ルールを変更しても、そのルールを使用しているプロセスを再度デプロイする必要はありません。これにより、ビジネスロジックの動的な更新と維持が容易になります。

Orchestrator では、ストレージと管理に次の一連の機能を使用します。

ユーザーと Robot の両方で使用するロールベースのアクセス権を記述した DMN ファイルを保存する
バージョン管理
複数のフォルダーにわたってビジネスルールをリンクする
タグを割り当てる

ビジネスルールの実行を目的として、Maestro は DMN v1.3 をサポートする新しいビジネスルールタスクを備えています。

ビジネスルールの各バージョンにアクセスする

ビジネスルールを追跡するには、[バージョン] フィールドを使用します。アップロードされた DMN ファイルと共にビジネスルールを保存すると、そのバージョンは変更できなくなります。

ビジネスルールのバージョンは、[ビジネスルール] ページで表示できます。バージョンを確認するには、ビジネスルールを選択してそれを編集するか、直接 [その他のアクション] に移動して [バージョンを表示] を選択します。

必要に応じて、以下のいずれかの方法でビジネスルールのバージョンをダウンロードすることもできます。

ビジネスルールの作成時に DMN ファイルをアップロードした後、そのファイルの横にある [ダウンロード] アイコンを選択します。
[ビジネスルール] ページから、目的のビジネスルールで [その他のアクション] を選択し、[このバージョンをダウンロード] を選択します。または、[その他のアクション] で [バージョンを表示] を選択します。サイドパネルが開き、ダウンロードするバージョンの横にある [ダウンロード] アイコンを選択できます。

ビジネスルールのリンク

他のフォルダーのビジネスルールをリンクするには:

[ビジネスルール] ページで、[ビジネスルールを追加] を選択して [他のフォルダーからリンク] を選択します。
次に、[ビジネスルールをインポート] ページに、他のフォルダーのすべてのビジネスルールのリストが表示されます。
現在のフォルダーに追加するビジネスルールを 1 つ以上選択し、[続行]、[リンク] の順に選択します。

ビジネスルールのリンクを管理するには:

[ビジネスルール] ページでビジネスルールを選択し、[その他のアクション] に移動して [リンクを管理] を選択します。
次のウィンドウで、ビジネスルールを追加するフォルダーを 1 つ以上選択するか、フォルダーの選択を解除してビジネスルールを削除します。
[更新] を選択します。

ビジネスルールを実行する

注:

ビジネスルールを実行する前に、以下を確認してください。

DMN 準拠のエディターを使用して DMN ファイルをモデル化済みである。
DMN ファイルをアップロードすることで Orchestrator に新しいビジネスルールを作成済みである。

ビジネスルールを実行するには Maestro プロセスを開きます。
そのプロセスにビジネスルールタスクを追加します。
Orchestrator に格納されている DMN ファイルをビジネスルールとして選択します。
DMN ファイルのモデル化方法に従って、入力引数と出力引数をマッピングします。

ビジネスルールを編集する

ビジネスルールを編集するには、ビジネスルールに対する編集権限が必要です。

[ビジネスルール] ページでビジネスルールを選択し、[その他のアクション] に移動して [編集] を選択します。
次に、[名前]、[説明]、[ラベル]、[プロパティ]、[ファイル] の各フィールドを編集できます。

注:
アップロードされた DMN ファイルと共にビジネスルールを保存すると、そのバージョンは変更できなくなります。

注:
引数名は、文字、数字、アンダースコアのみで構成してください。名前は、文字またはアンダースコアで始める必要があります。
[更新] を選択します。

ビジネスルールを削除する

ビジネスルールを削除するには、ビジネスルールに対する削除権限が必要です。

[ビジネスルール] ページで、ビジネスルールを選択します。
次に、[その他のアクション] に移動します。
[削除] を選択します。

プロセスアプリ (プレビュー)

概要

プロセスアプリは、ビジネスユーザーに日常業務を管理するためのロールベースのダッシュボード、フォーム、トリアージハブを提供します。プロセスの健全性をリアルタイムに可視化することができ、遅延、非効率な箇所、エスカレーションを特定するのに役立ちます。これはすべて、エージェント、ロボット、人間のユーザーにまたがる 1 つの統合されたワークスペースから実行できます。

チームは、プロセスアプリを使用して以下を行うことができます。

リアルタイムのコンテキストとガイド付きの意思決定によって遅延や SLA 違反を解決する
よりスマートにリソースを選択し、運用効率を向上させる
組織全体で問題をより迅速に解決し、ビジネスの成果を向上させる

プロセスアプリは、Maestro のプロセスオーケストレーションと UiPath® のローコードアプリ開発を組み合せたものであるので、運用チームはシステムを切り替えることなくアクショナブルインサイト (次のアクションにつながる分析情報) を獲得できます。

前提条件

プロセスアプリを使用するには、Automation Cloud テナントで以下のサービスが利用可能であることを確認します。

UiPath Automation Cloud™
UiPath Maestro™

はじめに

UiPath TypeScript SDK とサンプルアプリリソースを使用して、プロセスアプリの活用を開始できます。

表 1.

リソース	説明
SDK GitHub	UiPath TypeScript SDK のドキュメント
サンプルの React アプリ	プロセスアプリのサンプル
NPM パッケージ	UiPath TypeScript SDK