Agents ガイド

最終更新日時 2025年10月9日

UiPath エージェントを管理する

Automation Cloud^TM の Agents のページでは、以下の機能が提供されており、エージェントを包括的に管理できます。

アーリーアダプターのエージェントをソリューションパッケージに移行する
デプロイ済みのエージェントのパフォーマンスを監視する
エージェントのインシデントを特定して対処する
Marketplace のエージェントテンプレートにアクセスする

この一元化されたハブにより、エージェントのすべてのランタイムをリアルタイムに監視し、エラー、ヘルススコアの悪化、および実行時の評価スコアの低下が発生した場合、アラートを表示できます。

用語

エージェントインスタンスは、実行中のビジネスプロセスにデプロイした 1 つのエージェントであり、BPMN ではタスクとして表されます。特定のトリガー、キュー、その他のワークフロー条件に応答するエージェントランタイムのライブ実行です。
エージェントインスタンスの管理とは、エージェントとそのジョブの監視、保守、改善、終了に関連する一連のタスクを指します。

主な機能

Automation Cloud^TM の、デザインを変更した [エージェント] ページの主な機能は次のとおりです。

BPMN のワークフローを使用してエージェントをリアルタイムで監視する。
BPMN で定義したイベントを通じてエラーを処理し、エラーから回復する。
エージェントと人間のオペレーターとの間でランタイムエージェントを調整する。
意思決定ゲートウェイを介して結合と合意を処理する。
複数のメトリックに基づいてパフォーマンスを分析し、最適化する。
ガバナンスとコンプライアンスを確認して、社内ルールの確実な遵守を図る。

[ホーム] タブ

[ホーム] タブには、エージェントのランタイムと監視の概略が表示されます。ここでは、以下の作業を行えます。

デプロイ済みのエージェントを管理し、パフォーマンスを監視します。
アーリーアダプターのエージェントを管理および監視します。
エージェントのインシデントやエラーを管理・監視します。
インデックスのステータスとその取り込みの進行状況を監視します。
Marketplace で入手できるエージェントテンプレートを確認する

エージェントのインスタンスタブ

すべてのエージェントのインスタンスを管理するタブでは、運用環境にデプロイされたエージェントが可視化され、以下が含まれます。

[稼働中のインスタンスのタイムライン] と [完了したインスタンスのタイムライン] の監視ダッシュボード。

[稼働中のエージェント] のリスト: 選択した期間中に実行されたエージェントが表示されます。主要な実行メタデータがエージェントごとに表示されます。エージェントを選択すると、個々のインスタンスのビューが開きます。このビューには以下が含まれます。
- エージェントの簡単な説明 (構成、設定、保持ポリシーなど)。
- 選択した期間におけるすべてのジョブ実行の時系列リスト。ジョブを選択すると、その実行の詳細なトレースビューが開きます。
  トレースビューでは、エージェントの各実行についてさまざまなインサイトが得られます。具体的には、結果 (成功、失敗、リトライ) を色分けして表示する実行フローや、開始と終了のタイムスタンプ、実行ステータス、入力スニペットと出力スニペットのプレビューのほか、JSON ペイロード、ログとエラー、実行時のメトリック (トークンの使用状況、レイテンシ) の詳細です。詳しくは、以下のセクションをご覧ください。

時間フィルターを使用して、表示される期間 (過去 1 時間、過去 1 日、過去 1 週間、過去 1 か月間) を調整します。

トレースビューを理解する

トレースビューでは、エージェントのロジックのグラフィカル表現と、時間が一致している実行データを組み合わせて、各ステップのフローと結果を検証できます。キャンバスには、モデルやツールなどのエージェントの主要なコンポーネントを表すノードが、順次連結された状態で表示されます。

エージェントの実行のトレースビューでは、以下の手順に従ってトレースデータを操作および調査します。

ノードの情報をプレビューします。キャンバスで任意のノードにマウスをホバーすると、ツールチップが表示されます。このツールチップには以下が含まれます。
- 実行ステータス (成功、リトライ、または失敗)
- 開始タイムスタンプと終了タイムスタンプ
- 入力データと出力データのプレビュー
詳細をすべて開かなくても、各ステップの処理状況を素早く把握できて便利です。
ノードの詳細を表示します。ノードを選択すると、詳細パネルが開きます。このパネルには以下が含まれます。
- 完全な入出力ペイロード (JSON)
- 実行ログまたはエラーメッセージ (該当する場合)
- レイテンシやトークンの使用状況など、実行時のメトリック
- 構成パラメーター (該当する場合)
関連するステップ間を移動して、エージェントの中で情報がどのように流れたかを調べます。
- 連結されたノードを選択して、上流または下流に移動します。
- こうすると、あるステップの決定、入力、出力が、次のステップにどのように影響を与えたかを追跡するのに役立ちます。
[実行トレース] パネルを使用します。このパネルには、エージェントの実行中に記録されたすべてのアクションが時系列で表示されます。
- トレースログの行を選択して、対応するノードをキャンバスで強調表示します。
- 同様に、キャンバスでノードを選択すると、トレースログ内の関連する行が自動的に強調表示されます。

アーリーアダプタータブ

[アーリーアダプターのエージェント] タブには、2025 年 5 月 13 日以前に Agent Builder で作成したすべてのエージェントが表示されます。

各エージェントの [移行] ボタンを選択すると、エージェントを Studio に移行できます。詳しくは、「移行手順」をご覧ください。

図 1. アーリーアダプターのエージェントのインスタンスを管理するタブ

[エラー] タブ

[エラー] タブでは、エラーが最も多いエージェントを監視できます。このタブには次の情報が表示されます。

[エラーが最も多いエージェント]。グラフとして表示されます。選択した時間範囲のトップ 5 またはトップ 10 の項目を表示するには、[表示] ドロップダウンメニューを使用します。

[インシデント] の表。エージェント実行のインシデントのリストと [説明] 列が含まれます。この列から、各インシデントの原因について素早く洞察が得られます。インシデントの [初回発生日] 列または [最終発生日] 列のエントリを選択すると、対応するジョブの [ジョブの詳細] パネルを表示できます。

インシデントをエージェントまたは親プロセスでグループ化するには、対応するチェックボックスをオンにします。