Studio Web でエージェントを構築する

このセクションでは、Studio Web でエージェントを構築する方法について説明します。基本を理解したら、「ベスト プラクティス」をご覧ください。

エージェント ワークスペースを探索する

Studio Web のデザイナー キャンバスを使用してエージェントを設計し、左右のパネルを使用してエージェントの構造とリソースを探索します。

左側のパネルには、エージェントの構造が表示され、以下が含まれます。

• プロジェクト エクスプローラー – エージェントを編成および構築します。プロンプト、ツール、コンテキスト、エスカレーションなどを定義します。
• データ マネージャー – 入力引数と出力引数を定義します。
• エラー パネル – 設計時の問題、破損した設定、または失敗したテスト実行が表示されます。
• [デプロイの設定] パネル – エージェントをパブリッシュおよび実行するための、環境固有の設定を行います。

右側のパネルには以下が含まれます。

• [プロパティ] パネルは以下に分かれています。

  • [プロパティ] タブ – エージェント レベルおよびコンポーネント レベルの設定を行います。
  • [開発] タブ – テスト入力の実行、デバッグ、および設計時トレースの検査を行います。
• エージェントのスコア (プレビュー) – 評価結果とテスト カバレッジに基づくエージェントの準備状況を表示します。
• 実行結果パネル – 最新のテスト実行の結果を確認します。
• Autopilot (プレビュー) – AI を活用した提案を取得して、プロンプト、ツール、エージェントの設定を改良します。

下部のパネルには、履歴、結果、ライブ トレースがすべて 1 か所にまとめられているため、評価が設計エクスペリエンスの中心的要素になります。利用可能なタブは、構築するエージェントの種類によって異なります。

• 自律型エージェントの場合、下部のパネルには以下が含まれます。

  • 実行証跡 – 現在の実行のトレースの詳細が表示されます。エージェントを実行するとこのタブが自動的に開くので、ライブ トレースをリアルタイムに追跡できます。

  • 履歴 – エージェントのすべての実行が、実行のトレースおよび詳細とともに表示されます。ここから、実行を評価セットに直接追加できます。

  • 評価 – すべての評価セットが一覧にされ、最近のスコアが表示されます。セットを展開して、その評価を確認したり、詳細を表示したり、テストを個別にまたはフル セットとして実行したりできます。

• 会話型エージェントの場合、下部のパネルには以下が含まれます。

  • チャット – [実行証跡] タブを置き換えます。エージェントとの会話をテストするための対話型のチャット ウィンドウが提供されると同時に、各やり取りの実行証跡も表示されます。

  • 履歴 – 会話のすべての実行が、実行のトレースおよび詳細とともに表示されます。ここから、実行を評価セットに直接追加できます。

  • 評価 – すべての評価セットが一覧にされ、最近のスコアが表示されます。セットを展開して、その評価を確認したり、詳細を表示したり、テストを個別にまたはフル セットとして実行したりできます。

図 1. エージェント ワークスペース

エージェントを作成する

1. [studio.uipath.com] に移動します。
2. [新規作成] ボタン、[エージェント] の順に選択します。
3. 新しいソリューションが開き、エージェント デザイナー キャンバスが表示されます。

   [プレビュー] [エージェント Autopilot] のメッセージ ボックスが表示され、作成するエージェントを自然言語で説明できます。Autopilot が効率的にエージェントを生成できるよう、できるだけ具体的に説明してください。

エージェントを設定する

1. 左側のプロジェクト エクスプローラー パネルから、エージェントの定義、評価セット、評価器にアクセスします。
   図 2. ソリューション内のエージェント
   

   

   
   
   1. [定義] パネルでは、エージェントの主要な要素を設計および定義します。この定義は、[全般]、[ツール]、[コンテキスト]、[エスカレーション] のセクションで構成されます。
      • [全般] セクションは、エージェントのプロンプトを定義するために使用します。
      • [ツール] セクションは、実行時のツール (Integration Service のコネクタやパブリッシュ済みのプロセスなど) を接続するために使用します。
      • [コンテキスト] セクションは、コンテキスト グラウンディング インデックスを使用して知識ソースをリンクし、関連するデータへのアクセスをエージェントに提供するために使用します。
      • [エスカレーション] セクションは、人間参加型のフォールバックを設定し、エージェント メモリが会話間でデータを保持し、エージェントの今後のエスカレーションを調整できるようにするために使用します。
   2. [評価セット] パネルでは、評価を作成して結果を保存します。評価によってエージェントの出力を客観的に測定し、目的に合致しているかどうかを評価します。詳しくは、「評価」をご覧ください。
   3. [評価器] パネルでは、評価で使用する評価器を作成および管理します。
2. まず、プロジェクト エクスプローラーでエージェントを選択します。右クリックして [名前を変更] を選択し、エージェントに一意の名前を付けます。エージェント名は、プロジェクト間でエージェントを識別するのに役立ちます。
3. 次に、右側のメニューから [プロパティ] パネルにアクセスして、エージェントで使用する大規模言語モデルを選択します。
   1. 表示されているドロップダウン リストからモデルを選択します。モデルは、UiPath AI Trust Layer を通じてプロビジョニングされます。独自のモデルまたは独自のサブスクリプションを使用するには、[カスタム モデルを使用] を選択します。詳しくは、「LLM を設定する」をご覧ください。
   2. [温度] フィールドと [回答あたりの最大トークン数] フィールドを設定します。
   • [温度 ] では、LLM の生成の創造性因子を指定します。0 (正確) から 1 (創造的) の範囲の値を設定できます。
   • [回答あたりの最大トークン数] とは、エージェントの回答で生成するトークンの最大数を指します。
   図 3. モデルの設定の構成
   

   

   
   
4. エージェントの [定義] パネルで、エージェントに対してシステム プロンプトとユーザー プロンプトを指定します。適切に構成されたプロンプトを追加し、エージェントが行うべきことと従うべき制約についての指示を与えます。詳しくは、「プロンプト」をご覧ください。
5. [データ マネージャー] パネルを使用して、プロンプトで使用されるエージェントの入力引数と出力引数を定義します。
   図 4. [データ マネージャー] パネルの入力引数
   

   

   
   
6. [ ツール ] セクションで、[ ツールを追加 ] を選択して、エージェントが実行中に使用できるツールを追加します。自分がアクセス権を持っている一連の Integration Service アクティビティ、既存のエージェント、およびパブリッシュ済みのオートメーションを追加できます。各ツールには、このツールをいつ、どのように使用するかをエージェントに伝えるのに役立つ詳細な説明を付ける必要があります。詳しくは、「 ツール」をご覧ください。
7. (任意) [コンテキスト] セクションで、[コンテキストを追加] を選択して、エージェントにコンテキスト グラウンディングのインデックスへのアクセスを付与します。テナントで利用可能な既存のインデックスを選択するか、[新規作成] を選択して Orchestrator で直接新しいインデックスを作成します。詳しくは、「コンテキスト」をご覧ください。
8. (任意) [エスカレーション] セクションで、[エスカレーションを追加] を選択して、エスカレーション アプリを介して人間の参加 (ヒューマン イン ザ ループ) を追加し、エージェント メモリを有効化します。エスカレーションを追加すると、エージェントは実行時に出力を確認、承認、更新するために人間を関与させることができます。詳しくは、「エスカレーションとエージェント メモリ」をご覧ください。

エージェントをテストする

次に、エージェントをテストして、どのように改善できるかを確認します。

1. Studio Web デザイナーの上にあるツールバーに移動します。
2. デバッグ環境の横にある矢印 を選択します。
3. [デバッグ設定] を選択します。
4. [ デバッグ設定 ] ウィンドウで、ソリューションで使用されているリソースとサンプル入力を確認します。
5. [保存して実行] を選択します。

その後、テストの出力を使用してエージェントの設計を改良できます。

エージェントを評価する

次に、[評価セット] パネルと [評価器] パネルに移動して、エージェントを確認および測定します。

1. [評価セット] パネルで次の手順を実行します。
   • 既定の評価セットの名前を変更し、期待される結果を含むテスト ケースを追加します。
2. [評価器] パネルで、エージェントの出力を検証するための評価器を追加します。

各評価では、既知の入力が、出力に関するアサーションにリンクされています。

詳しくは、「評価」をご覧ください。

エージェントのスコアを計算する [プレビュー]

右側のパネルから [ヘルス スコアを開く] を選択して、エージェントのスコアを計算します。計算方法については、「エージェントのスコア」をご覧ください。

Autopilot を使用してエージェントを改善する [プレビュー]

右側のパネルから [Autopilot を開く] を選択すると、プロンプト、ツールなどのコンポーネントの改善に関する提案が表示されます。該当する改善を実施することにより、エージェントのスコアを向上させ、エージェントをデプロイできるようにします。

エージェントをパブリッシュしてデプロイする

エージェントをテストおよび評価して改良したら、パブリッシュします。この手順は、エージェントを [ジョブを実行] アクティビティで利用できるようにするために必要です。

1. [パブリッシュ] を選択して、エージェントをプロセスとして Orchestrator にパブリッシュします。パブリッシュする場所を選択します。
   1. Orchestrator 個人用ワークスペース フィード - プロセスは個人用ワークスペースにパブリッシュされ、自分だけが使用できます。このオプションは既定で選択されています。
   2. Orchestrator テナント プロセス フィード - プロセスはグローバル テナント フィードにパブリッシュされ、対象となるフォルダーのすべてのユーザーが使用できます。
2. バージョンを選択します。バージョンは、初めてパブリッシュするときに 1.0.0 から自動的に生成され、再パブリッシュするたびに自動的に増分されます。
3. 必要に応じて、[テンプレートとして送信] を選択し、このエージェントを組織内でテンプレートとして使用できるようにしたり、[共有] を選択して組織内のユーザーと共有したりできます。

エージェントを実行する

エージェントをアクティビティとして使用すると、エージェントをワークフローに組み込んで、より大きな確定的なプロセスの要素を処理したり、複数のエージェントを順番に動作させたり、トリガーに基づいてエージェントの実行を開始したりすることができます。

エージェントをワークフローに組み込むには、次の手順を実行します。

1. エージェントを Orchestrator にパブリッシュします。
2. Studio で、[ジョブを実行] アクティビティを使用してエージェントをワークフローに統合します。

3. エージェントに変更を加えた場合は必ず、更新したエージェントを Orchestrator に再パブリッシュし、Orchestrator で対応するプロセスをアップグレードします。

   [ジョブを実行] アクティビティは常に、Orchestrator で現在設定されているエージェントのバージョンを実行します。これにより、ワークフローで常に最新バージョンのエージェントが使用されます。

Studio のワークフローで [ジョブを実行] アクティビティを設定して使用する方法については、システム アクティビティのガイドをご覧ください。

注: UiPath.System.Activities バージョン 25.4.2 より、エージェントとその他の Orchestrator のジョブの実行は、[ジョブを実行] アクティビティに統合されて改良されました。[エージェントを実行] アクティビティを使用する既存のワークフローは、引き続き変更なしに機能するので、スムーズに移行できます。新しいエージェント実行機能をワークフローに追加すると、[エージェントを実行] を検索しても、自動的に [ジョブを実行] アクティビティが提案されて実装されます。

エージェント テンプレートを使用する

Automation Cloud^TM の Agents ページや UiPath® Marketplace で入手できる一連のエージェント テンプレートを使用して、エージェンティック ジャーニーを開始できます。

エージェント テンプレートは、特定のタスク用に事前設定されています。最小限の設定を行うだけで、Studio で実行できるようになります。また、特定のニーズに合わせてエージェントを変更したり調整したりすることができます。エージェント テンプレートは、以下で構成されます。

• 定義済みのコンポーネント – システム プロンプト、アクティビティ ツールと説明、スターター評価セット
  • コンポーネントは汎用であり、企業や組織に固有のものではありません。
  • コンポーネントは、すぐにエージェント定義で利用できます。一部のコンポーネント (ツールとしてのアクティビティなど) では、必要なコネクションを Integration Service で作成するなど、追加の設定が必要になる場合があります。
• 追加の設定が必要なコンポーネント – コンテキスト グラウンディングのインデックス、ツールとしてのオートメーションとプロセス、カスタム エスカレーション、および関連するすべての説明 (エージェントに対する指示)
  • これらのコンポーネントは、組織とテナントに固有です。

UiPath Marketplace のエージェント テンプレートの使用を開始するには、以下の手順を実行します。

1. Automation Cloud の Agents ページから [テンプレート] タブに移動し、任意のテンプレートを選択します。

   Marketplace からテンプレートにリダイレクトされます。

2. [Download] を選択します。
3. [エージェント テンプレートをダウンロードする] ウィンドウで [ソリューションをダウンロード] を選択します。
   エージェント定義を収めた .uis ファイルがマシンにダウンロードされます。
4. エージェント テンプレートには、エージェント向けアセットを収めた個別のパッケージである Extras も付属しています (オートメーション、カスタム エスカレーション)。[Extras をダウンロード] を選択します。
   .zip ファイルがお使いのマシンにダウンロードされます。
5. 「Studio Web からダウンロードしたプロジェクトをインポートする」の説明に従って、Studio Web からエージェント定義の .uis ファイルをインポートします。
6. [ソリューション] に移動します。詳細については、「ソリューションの UI にアクセスする」をご覧ください。
7. 「ソリューション パッケージを移送する」の説明に従い、.zip ファイルをアップロードして、ソリューションをデプロイします。詳しくは、「ソリューションをデプロイする」をご覧ください。
8. これで、Studio Web からエージェント テンプレートにアクセスして、テナントにデプロイされているツールを追加できます。