agents

latest

false

重要 :

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

Agents ガイド

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

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

Automation Cloud^TM の [エージェント] ページは、すべての UiPath エージェントの一元化されたレジストリおよび監視ハブとして機能します。これは、パフォーマンスの監視、会話動作のテスト、共有リソースの管理、デプロイされたエコシステム全体の可視性の維持に使用されます。

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

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

用語

エージェントインスタンスは、デプロイ済みの UiPath エージェントの単一のアクティブな実行です。これは、エージェントが、定義されたロジックとコンテキストに従って入力を処理し、推論を行い、ツールを実行し、出力を生成する 1 回の実行を意味します。
エージェントインスタンスの管理とは、エージェントとそのジョブの監視、保守、改善、終了に関連する一連のタスクを指します。

主な機能

Automation Cloud^TM の [エージェント] ページの主な機能は次のとおりです。

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

概要

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

使用状況と消費の分析

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

エージェントユニットの使用状況 – 合計消費量を追跡し、コストまたはリソース使用率の外れ値を特定します。
呼び出された機能の上位 – エージェントの実行全体で最も頻繁に使用されるアクション (ツール、アクティビティ、またはインデックス) をリストし、チームが動作パターンと一般的な依存関係を把握するのに役立ちます。
最もアクティブなユーザーとワークロード – 使用の集中度を明らかにし、誰が、またはどのプロセスが最も高い需要を生み出しているかを明確に示します。

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

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

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

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

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

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

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

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

会話型エージェント

[会話型エージェント] タブは、自然言語による対話を通じてユーザーとやり取りするエージェントを管理、テスト、分析するための完全な環境を提供します。設計時のテスト、ライブチャットの評価、実行時のインサイト、フィードバック分析が統合されており、チームは会話のパフォーマンスと信頼性を継続的に向上できます。

会話型エージェントは、チャットインターフェイス内で直接テストできます。この埋め込みプレイグラウンドを使用すると、実際のやり取りをシミュレートし、エージェントがインテント認識、ターンの切り替え、コンテキストの継続性をどのように処理するかを評価できます。以下が可能です。

エージェントとリアルタイムで対話し、自然言語でプロンプトを送信し、ライブ応答を確認できます。
プロンプトをテストするか、カスタムメッセージを作成して、さまざまなシナリオでのカバレッジを評価できます。
エージェントが会話ループ中にツール、メモリ、モデルをどのように適用するかを評価できます。

このテスト環境は、デプロイ前に会話ロジックを検証し、精度とトーンが意図したユースケースに沿っていることを確認するのに役立ちます。

ランタイム ビューでは、ライブセッション、完了率、ユーザーの操作をキャプチャして、会話型エージェントの稼働状況をエンドツーエンドで可視化します。応答時間、期間、エージェントユニットの消費などの主要な運用メトリックを追跡し、ワークロード全体にわたってパフォーマンス、スケーラビリティ、信頼性を確保します。

トレース ビューでは、エージェントの推論と実行フロー全体をマップすることで、デバッグと最適化が可能です。意思決定、ツールの呼び出し、ガバナンスチェックポイント、パフォーマンスヒートマップを検査して、動作を把握し、ロジックを検証し、会話の全体的な品質を向上させることができます。

フィードバック ビューでは、ユーザーとシステムの評価が中央のダッシュボードに集約されます。感情の傾向を視覚化し、繰り返し発生する問題を強調表示し、フィードバックを個々の実行にリンクしてより詳細なコンテキストを提供します。これにより、微調整を繰り返して継続的に品質を向上させることができます。

エージェントの下書き

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

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

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

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

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

The Context grounding indexes tab enables you to monitor the status and health of your indexes and track their ingestion progress at the tenant level.

The Index Monitoring section provides graphical insights into the following metrics:

Queries: Tracks the number of queries performed on your indexes over a selected time interval.
Index jobs: Displays the number of completed ingestion jobs. If no jobs have run in the selected period, a placeholder graphic is shown.

The Indexes table lists all available indexes in your tenant, showing key details such as:

Index name, Folder, and Data source
Health status, indicating whether an index is Healthy or Degraded
Storage size, Ingestion status, Last sync, and Last queried timestamps

Select an index from the table to open its details page. The Index details view provides:

Queries during the selected interval.
A Health chart showing the overall health score and the two component criteria.
Ingestion history, listing completed, failed, skipped, or deleted sync runs.

Use this view to investigate degraded indexes, review ingestion reliability, or check when an index was last queried.

Index health score

The Index health helps you monitor the condition of your Context Grounding indexes and identify those that may need maintenance or cleanup. It provides an automated, objective score showing how well each index performs and how frequently it’s used.

Each index receives a health score based on two criteria:

Ingestion reliability – How successfully documents were processed during the latest ingestion run.
Utilization – How recently the index has been queried.

The combined score helps you determine whether an index is healthy and delivering value (overall score above 75%), or degraded (overall score 75% or below). The score updates automatically after each successful ingestion or query.

Figure 1. Index health score

Index health is recalculated every 15 minutes for all tenants and only applies to indexes with completed ingestion jobs. New indexes have a 24-hour grace period after creation before health scoring begins.

The following table describes how each health criterion is calculated and weighted to determine the overall index health score.

Table 1. Index health scoring criteria
基準	メトリック	数式	備考
Ingestion reliability	Success rate from last ingestion	100 × (1 - failed_docs / total_docs)	Skipped and deleted documents are excluded. If no ingestion is completed within 24h, score = 0.
Utilization	Days since last query (max 90 days)	100 × (1 - days_since_last_query / 90)	After 24h without any query, score = 0.
Overall health	Average of both metrics	(Ingestion Reliability + Utilization) / 2	Calculated only if both component scores exist.

You can review the health status in two places:

The Context Grounding Indexes list – The Health column shows a colored indicator (green for Healthy, red for Degraded). Hovering over it displays details for each dimension (Ingestion reliability and Utilization).
The Index details view – The dedicated Health chart displays the overall score and component metrics. You can also track ingestion history and investigate issues when reliability is low.