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

このセクションでは、Studio Web でエージェントを構築する方法について説明します。信頼性の高い運用グレードのエージェントを作成するには、「ベスト プラクティス」を確認することを強くお勧めします。

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

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

エージェントを作成する

1. studio.uipath.com に移動します。

2. [新規作成] ボタン、[エージェント] の順に選択します。

3. 以下のエージェントの種類を選択します。

   • 自律型: 特定のタスクを完了するために独立して動作するエージェントを作成します。
   • 会話型: リアルタイムの対話を通じてユーザーと対話するアシスタントを作成します。

4. エージェントを最初から作成する場合は、[新規作成] を選択します。

5. Autopilot (プレビュー) を使用してエージェントを生成する場合は、利用可能なメッセージ ボックスに、作成するエージェントの説明を入力し、[エージェントを生成] を選択します。Autopilot が効率的にエージェントを生成できるよう、できるだけ具体的に説明してください。

6. 新しいソリューションが開き、エージェント デザイナー キャンバスが表示されます。

7. エージェントを設定する際に、従来のフォーム ビューとキャンバス ビューの 2 つのデザイン モードから選択できます。

   どちらのモードも、基になるエージェント定義として同じものを共有しており、完全に同期された状態が維持されるため、データの損失なくいつでもモードを切り替えることができます。

   構造化されたステップバイステップの設定エクスペリエンスには フォーム ビュー を使用します。また、 キャンバス ビュー に切り替えて、エージェントのコンポーネントがどのように接続および対話するかを確認できる、ノードベースの視覚的なレイアウトにします。

エージェントを設定する

エージェントを設定する際に、従来のフォーム ビューとキャンバス ビューの 2 つのデザイン モードから選択できます。どちらのモードも、基になるエージェント定義として同じものを共有しており、完全に同期された状態が維持されるため、データの損失なくいつでもモードを切り替えることができます。

構造化されたステップバイステップの設定エクスペリエンスには フォーム ビュー を使用します。また、 キャンバス ビュー に切り替えて、エージェントのコンポーネントがどのように接続および対話するかを確認できる、ノードベースの視覚的なレイアウトにします。

フォーム ビューを使用してエージェントを構築する (既定)

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

   図 3. ソリューション内のエージェント

   

   1. [定義] パネルでは、エージェントの主要な要素を設計および定義します。この定義は、[全般]、[ツール]、[コンテキスト]、[エスカレーション] のセクションで構成されます。
      • [全般] セクションは、エージェントのプロンプトを定義するために使用します。
      • [ツール] セクションは、実行時のツール (Integration Service のコネクタやパブリッシュ済みのプロセスなど) を接続するために使用します。
      • [コンテキスト] セクションは、コンテキスト グラウンディング インデックスを使用して知識ソースをリンクし、関連するデータへのアクセスをエージェントに提供するために使用します。
      • [エスカレーション] セクションは、人間参加型のフォールバックを設定し、エージェント メモリが会話間でデータを保持し、エージェントの今後のエスカレーションを調整できるようにするために使用します。
   2. [評価セット] パネルでは、評価を作成して結果を保存します。評価によってエージェントの出力を客観的に測定し、目的に合致しているかどうかを評価します。詳しくは、「評価」をご覧ください。
   3. [評価器] パネルでは、評価で使用する評価器を作成および管理します。

2. まず、プロジェクト エクスプローラーでエージェントを選択します。右クリックして [名前を変更] を選択し、エージェントに一意の名前を付けます。エージェント名は、プロジェクト間でエージェントを識別するのに役立ちます。

3. 次に、右側のメニューから [プロパティ] パネルにアクセスして、エージェントで使用する大規模言語モデルを選択します。

   1. 表示されているドロップダウン リストからモデルを選択します。モデルは、UiPath AI Trust Layer を通じてプロビジョニングされます。AI Trust Layer の管理については「LLM を設定する」を参照してください。
   2. [温度] フィールドと [回答あたりの最大トークン数] フィールドを設定します。これらの設定は、Automation Ops のガバナンス ポリシーで制御できます。詳しくは、「Studio Web のポリシーの設定」をご覧ください。
      • [温度] では、LLM の生成の創造性因子を指定します。0 (正確) から 1 (創造的) の範囲の値を設定できます。
      • [回答あたりの最大トークン数] とは、エージェントの回答で生成するトークンの最大数を指します。
   3. [繰り返しの最大回数] の設定 – エージェントがタスクを完了するか、停止するまでに実行できる推論ループの最大数。

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

5. [データ マネージャー] パネルを使用して、プロンプトで使用されるエージェントの入力引数と出力引数を定義します。

   図 5. [データ マネージャー] パネルの入力引数

   

6. [ツール] セクションで、[ツールを追加] を選択して、エージェントが実行中に使用できるツールを追加します。自分がアクセス権を持っている一連の Integration Service アクティビティ、既存のエージェント、およびパブリッシュ済みオートメーションを追加できます。各ツールには、このツールをいつ、どのように使用するかをエージェントに伝えるのに役立つ詳細な説明を付ける必要があります。詳しくは、「ツール」をご覧ください。

7. (任意) [コンテキスト] セクションで、[コンテキストを追加] を選択して、エージェントにコンテキスト グラウンディングのインデックスへのアクセスを付与します。テナントで利用可能な既存のインデックスを選択するか、[新規作成] を選択して Orchestrator で直接新しいインデックスを作成します。詳しくは、「コンテキスト」をご覧ください。

8. (任意) [エスカレーション] セクションで、[エスカレーションを追加] を選択して、エスカレーション アプリを介して人間の参加 (ヒューマン イン ザ ループ) を追加し、エージェント メモリを有効化します。エスカレーションを追加すると、エージェントは実行時に出力を確認、承認、更新するために人間を関与させることができます。詳しくは、「エスカレーションとエージェント メモリ」をご覧ください。

キャンバス ビューを使用してエージェントを構築する

1. Studio Web でエージェント プロジェクトを開きます。

2. 設計時のキャンバスの右上隅にある作成モードのトグルから [キャンバス] オプションを選択します。

   • キャンバスが開き、エージェントの構造がノードとして表示されます。
   • フォーム ビューはいつでも戻ることができます。すべての変更は保存され、2つのモード間で自動的に変換されます。

3. LLM ノードから開始します。

   • そのノードを選択して右側にプロパティ パネルを開き、モデルを選択して設定します。
     • 表示されているドロップダウン リストからモデルを選択します。モデルは、UiPath AI Trust Layer を通じてプロビジョニングされます。カスタム モデルの使用方法については、「LLM を設定する」を参照してください。
     • [温度] フィールドと [回答あたりの最大トークン数] フィールドを設定します。これらの設定は、Automation Ops のガバナンス ポリシーで制御できます。詳しくは、「Studio Web のポリシーの設定」をご覧ください。
       • [温度] では、LLM の生成の創造性因子を指定します。0 (正確) から 1 (創造的) の範囲の値を設定できます。
       • [回答あたりの最大トークン数] とは、エージェントの回答で生成するトークンの最大数を指します。
     • [繰り返しの最大回数] の設定 – エージェントがタスクを完了するか、停止するまでに実行できる推論ループの最大数。
   • モデルを選択すると、ノードは対応するモデル ファミリ アイコンで更新され、ハイライト表示は消えます。

4. エージェント ノードを設定します。

   • 既定では、エージェント ノードは LLM ノードと並んで作成されます。
   • 右側のプロンプト セクションを開いて、システム プロンプトとユーザー プロンプトを定義します。会話型エージェントの場合、このセクションは簡略化されていて、システム プロンプトのみが表示されます。
   • 左側のスキーマ セクションを開き、[データ マネージャー] パネルで入力引数と出力引数を定義します。

5. コンテキスト、ツール、エスカレーションを追加する。LLM ノードとエージェント ノードが完了すると、新たに 3 種類のノードが利用可能になります。

   • コンテキスト: コンテキスト グラウンディングのインデックスを選択し、その検索パラメーターを調整します。
   • ツール: コマンド パレットを開き、デプロイ済みのツールを検索して、キャンバスに追加します。各ツールは、追加後にさらに設定できます。
   • エスカレーション: 既存のエスカレーションの設定エクスペリエンスに接続する人間参加型のノードを追加します。

6. ツールノードで⋮(その他のアクション)メニューを選択して、追加のオプションにアクセスします。以下の操作を利用可能です。

   • ブレークポイントを追加 – ツール ノードにブレークポイントを挿入します。エージェントをデバッグすると、このツールが実行される直前に実行が一時停止するため、入力、出力、およびトレース データを検査できます。ブレークポイントは、設計時のテスト中にツールのロジックを検証したり、エラーをデバッグしたりするのに役立ちます。

   • ガードレールを追加 – ガードレールの設定ウィンドウが開き、実行時にツールがどのように使用されるかを制限または監視するルールを定義できます。

   • 無効化 – 選択したツール ノードを一時的に無効化してエージェントの実行から除外します。無効化されたツールはキャンバス上に残りますが、実行時やデバッグ時にはスキップされるため、ツールを完全に削除することなくエージェントの動作をテストまたは調整できます。

     

7. エージェントをデバッグします。

   • [デバッグ] を選択して、設計時にエージェントを実行します。
   • エージェントを実行すると、ノードが順番に点灯して実行フローを示します。
   • シミュレーションを実行すると、ノードはモックされたデータまたはツール呼び出しを示すために異なる色で表示されます。
   • 会話型エージェントの場合、常設チャット ウィンドウでやり取りをテストできます。メッセージごとにデバッグ実行がトリガーされ、接続されているノード全体が強調表示されます。
   • また、特定のノードにブレークポイントを設定して実行を一時停止し、入力、出力、トレース データを検査することもできます。

8. 変更を保存してパブリッシュします。

   • キャンバス ビューで行った更新はすべて自動的に保存され、フォーム ビューと同期された状態が維持されます。
   • 準備ができたら、エージェントをパブリッシュして、テストとデプロイに使用できるようにします。

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

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

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

エージェントを評価する

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

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 のジョブの実行は、[ジョブを実行] アクティビティに統合されて改良されました。[エージェントを実行] アクティビティを使用する既存のワークフローは、引き続き変更なしに機能するので、スムーズに移行できます。新しいエージェント実行機能をワークフローに追加すると、[エージェントを実行] を検索しても、自動的に [ジョブを実行] アクティビティが提案されて実装されます。