Agent Builder でエージェントを構築する

このセクションでは、Agent Builder でエージェントを設計する方法について説明します。

大事な： Agent Builder エクスペリエンスは、2025 年 6 月 14 日に非推奨となる予定です。それまでは、既存のエージェントの設計または評価のみを行うことができます。既存のエージェントを移行し、Studio Web でエージェントの使用を開始することをお勧めします。詳しくは、「 エージェントを Studio Web に移行する」をご覧ください。

新しいエージェントの作成については、「 Studio Web でのエージェントの構築」をご覧ください。

1. UiPath® Automation Cloud^TM で、左側のナビゲーション バーから [Agents] を選択します。
   エージェント ワークスペースが表示されます。
2. 「プレビュー・エージェント」のリストから、エージェントを選択してエージェント・ビルダーを開きます。
3. エージェント ワークスペースには、[デザイン]、[評価]、[トレース] の 3 つのタブがあります。

   [デザイン] タブを使用して、エージェントの主要な要素を設計および定義します。入力/出力引数を定義したら、このスペースを使用してエージェントの実行をプレビューできます。

   [評価] タブは、評価を作成して結果を保存する場合に使用します。評価によってエージェントのアウトプットを客観的に測定し、目的に合致しているかどうかを評価します。

   [トレース] タブは、このエージェントの設計時および評価時のすべてのトレースをログに記録および表示する場合に使用します。このタブで、エージェントのすべての実行と実行の詳細を確認できます。

4. エージェントで使用する大規模言語モデルを選択します。モデルは、UiPath AI Trust Layer を使用してプロビジョニングされます。
   1. モデルの設定を構成するには、[モデル] フィールドの横にある設定アイコンを選択します。ここで、[温度] フィールドと [回答あたりの最大トークン数] フィールドを設定できます。
      • [温度] では、LLM の生成の創造性因子を指定します。0 (正確) から 2 (創造的) の範囲の値を設定できます。
      • [回答あたりの最大トークン数] とは、エージェントの回答で生成するトークンの最大数を指します。
5. [ 全般 ] タブで、エージェントの名前と説明を編集します。

   エージェントの名前と説明には、エージェントの目的に関する詳細を簡単な言葉で指定する必要があります。この説明を使用して、Studio でエージェントを特定します。

6. [プロンプト] タブで、適切に構成されたシステム プロンプトと、エージェントが行うべきことと従うべき制約についての指示を与えるユーザー プロンプトを追加します。
7. [引数] を選択して [引数] ウィンドウにアクセスします。ここで、プロンプトで使用する入力引数と出力引数を設定できます。
8. [ Tools ] タブで、エージェントが実行中に使用できるツールを追加します。Integration Service の一連のアクティビティ、ユーザーがアクセス権を持つパブリッシュ済みのプロセス、またはその他のエージェントを使用できます。

   各ツールには、このツールをいつ、どのように使用するかをエージェントに伝えるのに役立つ詳細な説明を付ける必要があります。

9. [コンテキスト] タブを使用して、必要なコンテキストを追加します。

   コンテキスト グラウンディングのインデックスにより、エージェントは権限を持つナレッジ ベースにアクセスできるようになります。これは、エージェントのアクションや回答をビジネス データにグラウンディングするのに役立ちます。

10. [エスカレーション] タブを使用して、人間の参加 (ヒューマン イン ザ ループ) を追加し、エージェント メモリを有効化します。

    エスカレーションを追加すると、エージェントは実行時に出力を確認、承認、更新するために人間を関与させることができます。

11. [プレイグラウンド] ウィンドウで、テスト実行の入力を指定し、[実行] を選択します。

    エージェントをテストして、期待どおりに動作していることを確認する必要があります。

12. 次に、[評価] タブに移動して、エージェントを確認および測定します。

    評価は、入力と、出力に対して行われたアサーションのペアであり、エンドツーエンドの実行中にエージェントの能力を判定するために使用できます。

13. 評価を実行した後、[トレース] タブを使用して、エージェントのすべてのトレース ログを確認します。
14. エージェントをテストおよび評価して改良したら、[パブリッシュ] を選択してエージェントをプロセスとして Orchestrator にパブリッシュします。
    • パブリッシュする場所を選択します。
      • Orchestrator 個人用ワークスペース フィード - プロセスは個人用ワークスペースにパブリッシュされ、自分だけが使用できます。このオプションは既定で選択されています。
      • Orchestrator テナント プロセス フィード - プロセスはグローバル テナント フィードにパブリッシュされ、そのテナント フィードを使用するフォルダーに割り当てられているすべてのユーザーが使用できます。
    • バージョンを選択します。バージョンは、初めてパブリッシュするときに 1.0.0 から自動的に生成され、再パブリッシュするたびに自動的に増分されます。

    重要: この手順は、エージェントを [ジョブを実行] アクティビティで利用できるようにするために必要です。

    [エクスポート] を選択して、エージェントの定義を表示し JSON としてパッケージ化します。その後、この JSON の抽出を使用して、別の組織にエージェントをインポートできます。

15. 最後に、Studio で [ジョブを実行] アクティビティを使用して、エージェントをオートメーションに挿入します。詳しくは、「エージェントを実行する」をご覧ください。

エージェントを実行する

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

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

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

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

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

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

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