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

The Agents page in Automation Suite serves as your centralized registry and observability hub for all UiPath agents. Use it to monitor performance, manage shared resources, and maintain visibility across your deployed ecosystem.

1 か所から次のことが可能です。

• デプロイ済みのエージェントを監視し、パフォーマンス メトリックをリアルタイムで確認します。
• エージェントのインシデントや健全性の低下を調査して解決します。
• UiPath Marketplace からエージェント テンプレートにアクセスし、デプロイします。
• コンテキスト グラウンディングのインデックスを管理します。

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

用語

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

概要

[概要] タブには、エージェント エコシステムの概要が表示され、運用上のインサイト、パフォーマンス インジケーター、消費分析が 1 つの一元的なビューに集約されています。これは、組織全体でのエージェントのパフォーマンスと、リソースの消費効率を把握するためのコマンド センターとして機能します。

パフォーマンスに関するインサイト

このタブには、デプロイ済みのすべてのエージェントの実行時データが集約され、パフォーマンスの傾向を監視して最適化の機会を特定するのに役立ちます。主なメトリックは次のとおりです。

• ジョブの合計数: 完了したエージェント実行の総数を追跡し、アクティビティや導入の状況を示す指標を提供します。
• 成功率: エージェントの実行の成功率を測定し、信頼性の評価や、エージェントの設定で繰り返し発生するエラーや不安定性の検出に役立ちます。
• 平均応答時間: エージェントがタスクをいかに素早く完了できるかを示し、遅延と効率を大規模に監視できます。
• エージェント ユニットの消費: すべてのエージェントの合計ユニット使用量を数値化して、予測、予算編成、リソース割り当てを改善します。

監視とフィードバック分析

このタブには、環境全体の消費とフィードバックの傾向も表示されます。

• エージェント ユニット消費レポートでは、最もアクティブなエージェントやコストのかかるエージェントを特定し、チューニングやリソース割り当ての優先順位付けに役立ちます。
• フィードバックの要約は、どのエージェントが最も多くのユーザーの操作またはパフォーマンス評価を受けているかを強調し、チームがユーザー エクスペリエンスと影響の向上に集中するのに役立ちます。

フィルターと時間ベースの分析

管理者は、エージェントの種類、デプロイの状態、時間範囲など、さまざまなディメンションのデータを分析して、異常を特定し、定義された運用期間 (日次ビュー、週次ビュー、月次ビューなど) の傾向を評価できます。これらのフィルターにより、ターゲットを絞った分析が可能になり、レポートが合理化されます。

• デプロイ済みのエージェントを管理し、パフォーマンスを監視します。
• アーリー アダプターのエージェントを管理および監視します。

デプロイ済みのエージェント

[デプロイ済みのエージェント] タブには、運用環境でアクティブなすべてのエージェントをまとめたビューが、パフォーマンス、健全性、フィードバックのリアルタイムのメトリックとともに表示されます。これは、運用効率を監視し、問題を診断して、デプロイされたエージェントから一貫した高品質の結果が提供されるようにするためのプライマリ ワークスペースとして機能します。

エージェントの可視性の統合

このビューには、テナント全体にわたる運用環境で使用できるすべてのエージェントが集約され、管理者や開発者は運用ステータスや最近のアクティビティを素早く評価できます。各エージェント カードには、次のような主要な運用メトリックがまとめられています。

• 成功率 – 成功した実行の割合です。機能低下しているエージェントやパフォーマンスの低いエージェントを特定するのに役立ちます。
• 平均応答時間 – 最近のジョブの実行速度と効率の指標。
• フィードバックの量 – エージェントに対して収集されたユーザーまたはシステムの評価の数。
• 健全性インジケーター – 全体的なパフォーマンスの傾向と実行時の安定性を示す視覚的な手掛かり (正常性、機能低下など)。

エージェントは、ステート、種類、フォルダー、または時間範囲で絞り込みができるため、ビジネス領域やデプロイ環境全体にわたって正確に監視できます。

運用上の洞察とパフォーマンスの追跡

このタブでは、単純なランタイム ステータスを超えたコンテキスト分析を行うことができます。以下を探索できます。

• アクティブなジョブと完了したジョブ – 別々のタイムラインでライブ実行と完了した実行を追跡し、ワークロードのピークとボトルネックを特定するのに役立ちます。
• エラーと遅延のパターン – パフォーマンスのグラフには、実行エラー、初回応答までの時間、遅延のパーセンタイルが表示され、これによってチームは応答性を微調整できます。
• フィードバックの傾向 – 集約された感情分析 (肯定的および否定的) により、エージェントの品質が時間とともにどのように変化しているか、およびどの更新がユーザーの満足度に影響を与えているのかが示されます。

これらのインサイトは、体系的な問題の診断、新しいデプロイの検証、および最適化作業の優先順位付けに役立ちます。

使用状況と消費の分析

このダッシュボードでは、エージェントが環境とどのように対話し、リソースがどのように消費されているかが強調表示されます。

• エージェント ユニットの使用状況 – 合計消費量を追跡し、コストまたはリソース使用率の外れ値を特定します。
• 呼び出された機能の上位 – エージェントの実行全体で最も頻繁に使用されるアクション (ツール、アクティビティ、またはインデックス) をリストし、チームが動作パターンと一般的な依存関係を把握するのに役立ちます。

詳細なエージェントのランタイム ビュー

個々のエージェントを選択すると、以下の情報を組み合わせた詳細な分析ワークスペースが開きます。

• エージェントのロジック、ツール、およびメモリ ソースをマップする実行時のダイアグラム。
• プロンプトの設計、ツールの統合、評価のカバレッジを評価するヘルス スコアの表示。
• 各実行についてきめ細かく (入力、出力、エラー、タイミングの詳細) 示した実行トレース。これにより開発者はエージェントの推論プロセスを再構築してデバッグできます。

エージェント インスタンスのビューでは、エージェントの個々の実行を完全に監視でき、意思決定、アクション、およびパフォーマンス メトリックを 1 回の実行で完全にトレースできます。

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

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

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

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

エージェントの下書き

[エージェントの下書き] タブには、パブリッシュされていないエージェントまたは開発中のエージェントが表示されます。

各下書きは、以下を含むカードとして表示されます。

• エージェント名 (名前がまだ変更されていない場合は「Untitled」)。
• 最後に更新されたタイムスタンプ。
• 下書きを Studio Web で再度開いて編集するためのクイック リンク。

エージェントの下書きは、終了後に再開、編集、またはパブリッシュできます。

コンテキスト グラウンディングのインデックス

[コンテキスト グラウンディングのインデックス] タブでは、インデックスのステータスと稼働状態を監視し、テナント レベルでインデックスの取り込みの進行状況を追跡できます。

[インデックスの監視] セクションでは、以下のメトリックに関するインサイトがグラフィカルに表示されます。

• クエリ: 選択した期間にインデックスに対して実行されたクエリの件数を追跡します。
• インデックス ジョブ: 完了した取り込みジョブの数を表示します。選択した期間にジョブが実行されていない場合は、プレースホルダーのグラフィックが表示されます。

[インデックス] テーブルには、テナントで利用可能なすべてのインデックスが一覧表示されます。インデックスに関するより詳細な情報を得るには、この一覧からインデックスを選択します。個々のビューには以下の情報が表示されます。

• インデックス名、フォルダー、データ ソース
• ヘルス ステータス。インデックスが正常であるか、機能低下であるかを示します。
• ストレージのサイズ、取り込みステータス、前回の同期、前回のクエリのタイムスタンプ。

表からインデックスを選択して詳細ページを開きます。[インデックスの詳細] ビューには以下の情報が表示されます。

• 選択した期間で発生したクエリの件数です。
• 総合的なヘルス スコアと、要素の 2 つの基準を示すヘルス グラフ。
• 取り込み履歴。完了、失敗、スキップ済み、削除済みの同期実行が一覧表示されます。

このビューを使用して、機能低下したインデックスの調査、取り込みの信頼性の確認、またはインデックスの前回のクエリ日時のチェックを行います。

インデックスのヘルス スコア

インデックスのヘルスは、コンテキスト グラウンディングのインデックスの状態を監視し、メンテナンスやクリーンアップが必要なインデックスを特定するのに役立ちます。各インデックスのパフォーマンスと使用頻度を示す客観的なスコアが自動的に提供されます。

各インデックスは、次の 2 つの基準に基づいてヘルス スコアを受け取ります。

• 取り込みの信頼性 – 最新の取り込みの実行時にドキュメントがどの程度正常に処理されたかを示します。
• 使用状況 – インデックスがどのくらい前にクエリされたかを示します。

合算されたスコアは、インデックスが正常で価値を提供しているか (総合スコアが 75% 超)、機能低下しているか (総合スコアが 75% 以下) を判断するのに役立ちます。スコアは、取り込みまたはクエリが成功するたびに自動的に更新されます。

インデックスのヘルスは、すべてのテナントを対象として 15 分ごとに再計算され、完了した取り込みジョブがあるインデックスにのみ適用されます。新しいインデックスは、作成後 24 時間の猶予期間を経てからヘルス スコアリングが開始されます。

次の表では、インデックスの総合的なヘルス スコアを決定するために、ヘルスの各基準がどのように計算され、重み付けされるかについて説明します。

基準	メトリック	数式	備考
取り込みの信頼性	前回の取り込みの成功率	100 × (1 - 失敗したドキュメント数 / 合計ドキュメント数)	スキップ済みおよび削除済みのドキュメントは除外されます。24 時間以内に完了した取り込みがない場合、スコア = 0 になります。
使用状況	前回のクエリからの日数 (最大 90 日)	100 × (1 - 前回のクエリからの日数 / 90)	クエリなしで 24 時間が経過すると、スコア = 0 になります。
総合的なヘルス	両方のメトリックの平均値	(取り込みの信頼性 + 使用状況)	両方の要素のスコアが存在する場合にのみ計算されます。

ヘルス ステータスは、次の 2 つの場所で確認できます。

• [コンテキスト グラウンディングのインデックス] リスト – [ヘルス] 列に、色付きのインジケーターが表示されます (正常の場合は緑、機能低下の場合は赤)。インジケーターにカーソルを合わせると、各ディメンションの詳細 (取り込みの信頼性、使用状況) が表示されます。
• [インデックスの詳細] ビュー – 専用のヘルス グラフに、総合スコアとコンポーネントのメトリックが表示されます。信頼性が低い場合は、取り込み履歴を追跡して問題を調査することもできます。

フィードバック

The Feedback tab provides a centralized view for reviewing agent traces and capturing feedback that helps improve agent reliability over time.

Feedback helps with runtime analysis and diagnostics: Review completed agent runs to understand behavior, identify issues, and annotate specific decisions or outputs.

フィードバックの概要

ページの上部には、集約されたインサイトが表示されます。

• [フィードバックが最も多いエージェント] には、ポジティブなフィードバックとネガティブなフィードバックを最も多く受け取っているエージェントが表示されます。
• [経時的なフィードバック] には、フィードバックの傾向が視覚化され、動作の変化を改善または退行と相関させるのに役立ちます。
• [期間] フィルターを使用すると、分析を最近の実行や過去の実行に絞り込むことができます。

図 3. Agents のインスタンスの管理の [フィードバック] タブ

エージェントの実行にフィードバックを追加する

フィードバックを追加するには、以下の手順を実行します。

1. [フィードバック] ページから [フィードバックを追加] を選択します。
2. 実行されたジョブのリストからエージェントの実行時のジョブを選択します。
3. トレースを確認し、関連する範囲にフィードバックを関連付けます。

ガードレール

[ガードレール] タブでは、デプロイ済みのエージェント全体にわたってガードレールのアクティビティを一元的に確認することができます。このため、エージェントが確実かつ安全に組織のポリシーに沿って動作することをオペレーターが確認するのに役立ちます。このタブには、設定のカバレッジから適用結果まで、実行時のガードレールのデータが 1 か所に表示されます。

このタブは、以下の 3 つのステージを中心に構成されています。

• Configure guardrails — add tool-level guardrails to your agents.
• 監視 — 実行時のガードレールのアクティビティを確認し、ガードレールがトリガーされる頻度と、ガードレールによって適用されるアクションを追跡します。
• ガードレールの微調整 — 評価データを使用してガードレールの動作を経時的にテスト、改良、最適化します。

エージェント ガードレールの使用状況

この円グラフには、ガードレールが設定されているテナント内のエージェントと設定されていないエージェントの割合が、実行データに基づいて表示されます。このグラフには、少なくとも 1 回実行されたエージェントのみが反映されます。このビューを使用して、デプロイ済みのエージェントのエコシステム全体にわたるガバナンスのカバレッジを評価し、ガードレールの設定が必要と思われるエージェントを特定します。

上位の呼び出されたアクション

この積み上げ棒グラフには、エージェント全体に適用されたガードレールのアクションの量と内訳が表示されます。それぞれの棒は 1 つのデプロイ済みのエージェントを表し、アクションの種類 (ブロック、エスカレーション、フィルター) 別に分割されています。フィルターを使用して、ガードレールの合計呼び出し回数のトップ 5 またはトップ 10 のエージェントを表示できます。これは、Agents のページの他の監視グラフと一貫性があります。

ガードレールの詳細

この表には、デプロイ済みのすべてのエージェントとそのガードレールのアクティビティのリストが表示されます。表をフィルター処理して、ガードレールがあるエージェント、ガードレールがないエージェント、またはすべてのエージェントを表示できます。時間範囲フィルターを使用すると、選択した期間にデータの範囲を絞り込むことができます。

列	説明
ガードレールの数	エージェントに設定されているガードレールの数です。
最も新しいガードレール	エージェントの実行中に最後にトリガーされたガードレールの名前です。
ガードレールの種類	ガードレールの種類の分類です。
スコープ	ガードレールが適用されるレベルです (エージェント、LLM、またはツール)。
実行ステージ	ガードレールがエージェント、ツール、または LLM の実行の前または後のどちらに実行されるかを示します (実行前または実行後)。
最も新しいアクション	最後にトリガーされたガードレールによって適用されたアクションです (エスカレーション、ログ、フィルター、またはブロック)。
アクションの結果	最後に適用されたアクションの結果です (続行、却下、ログ、フィルター、またはブロック)。