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

エージェントの設定を検証し、Studio Web にデプロイして、デバッグ パネルでエンドツーエンドのテストを実行します。

エージェントをローカルで検証したら、Studio Web にアップロードしてライブ テストを実行する準備が整いました。

手順 7 - Studio Web にアップロードする

ソリューション ディレクトリから Studio Web にソリューションをアップロードします。

uip solution upload .

アップロードに成功すると、 "Status": "Uploaded successfully" が返され、 SolutionId と DesignerUrl が返され、ブラウザーで直接開くことができます。これで、エージェントが編集可能なプロジェクトとして Studio Web に存在するようになりました。

注:

アップロードとデプロイ。uip solution upload は、ソリューションを編集可能なソース プロジェクトとして Studio Web に送信します。これは開発とテストに適したターゲットです。運用環境でエージェントを実行する準備ができたら、代わりに uip solution pack + uip solution publish を使用してバージョン管理されたパッケージを構築し、Orchestrator にデプロイします。このラボでは upload を使用します。

---

手順 8 - Studio Web でエージェントをテストする

1. UiPath Automation Cloud にログインし、サイド ナビゲーションから Studio Web を開きます。

2. プロジェクトリストで MonsterSelector プロジェクトを見つけ、選択して開きます。

3. Studio Web によってエージェントが Agent Builder で開きます。確認すると以下が表示されます。

   • 右側のパネルのシステム プロンプト
   • 入力としてリストquestDescriptionおよびmonsters
   • 出力としてリストmonsterIndex

4. 上部のツールバーで [ デバッグ ] を選択します。入力パネルに、次の JSON を貼り付けます。

   {
     "questDescription": "A wealthy merchant's caravan has been attacked near the harbor. Eyewitnesses report tentacles, hypnotic powers, and strange psychic disturbances for miles around.",
     "monsters": [
       {"index": "aboleth", "name": "Aboleth"},
       {"index": "kraken", "name": "Kraken"},
       {"index": "giant-octopus", "name": "Giant Octopus"},
       {"index": "sea-hag", "name": "Sea Hag"},
       {"index": "dryad", "name": "Dryad"}
     ]
   }
   

5. [ 保存してデバッグ ] を選択してエージェントを実行します。

   

6. [ 出力] パネルで結果を確認します。monsterIndexに"aboleth"または"kraken"が含まれていることを確認してください — どちらも触手があり、マインドコントロールの水中ホラーとして防御可能な選択です。「 "giant-octopus"」と表示されている場合は、プロンプトを強化する必要がある可能性があります。

   

重要:

エージェントは非決定論的です。temperature: 0であっても、モデルは実行間で異なる出力を生成する可能性があります。目標は守備可能なピックであり、特定の文字列ではありません。次の 2 つの例を使用して、エージェントがどのように推論を行うかを把握します。一貫した間違った答えは、プロンプトを改良するためのシグナルです。

次の追加の入力を試してください。

• 候補"sea-hag"、"night-hag"、"green-hag"、"dryad""questDescription": "Clear out the moon-worshipping coven abducting village children under the full moon"。HAG バリアントを返す必要があります
• 候補"ancient-red-dragon"、"young-red-dragon"、"hell-hound"、"salamander""questDescription": "Slay the beast terrorizing the northern kingdoms with fire and ancient cruelty"。を返す必要があります"ancient-red-dragon"

---

構築したもの

UiPath CLI を使用してローコード エージェントを構築し、パブリッシュした

• ターミナルからソリューションとエージェント プロジェクトをスキャフォールディングした
• システム プロンプト、入力スキーマ、出力スキーマを、 agent.json と entry-points.json を直接編集して設定した。
• アップロードする前にプロジェクトをローカルで検証しました。
• Studio Web にアップロードして、ライブ テストを実行しました。

このラボの主なコマンド

コマンド	機能
uip solution init <name>	新しいソリューション (デプロイ可能なコンテナー) を作成します
uip agent init <path>	新しいローコード エージェント プロジェクトをスキャフォールディングし、ソリューションに登録する
uip agent validate <path>	アップロードする前にエージェント スキーマをローカルで検証します
uip solution upload .	ソリューションを編集可能なプロジェクトとして Studio Web にアップロードします

次の手順

• UiPath エージェントにツールを追加する - D&D 5e API を直接呼び出すツールでモンスター セレクターを拡張します。これにより、 monsters[] 入力を削除して、エージェントに検索対象を決定させます。
• オーケストレーション パターン (今後のラボ): エージェントは、UiPath フロー プロジェクト、API ワークフロー、およびその他のエージェントから呼び出すことができます。
• UiPath Agents のドキュメント - ローコード エージェントおよびコード化されたエージェントの機能に関する完全なリファレンスです。
• UiPath コミュニティ - フォーラム、使用方法、開発者によるディスカッション

ヒント:

次回は最後までスキップしてください。各コマンドの機能を理解したところで、コーディング エージェントは 1 つのプロンプトからシーケンス全体を実行できます。UiPath スキルをインストールすると (手順 2)、スキルには CLI の知識が伝わってきます。プロンプトは、エージェント名、入力、出力、システム プロンプトなど、エージェントが認識できない情報のみを指定するだけで済みます。

「[エージェント名] という名前のローコード UiPath エージェントを作成してください。入力スキーマ: [各フィールドを名前、種類、説明とともにリストする]。出力スキーマ: [各フィールドのリストを取得]。システム プロンプト: '[your prompt]'。検証してアップロードしてください。」

たとえば、このラボで構築したモンスター セレクター エージェントを再作成するには、次のようにします。

「MonsterSelector という名前のローコードの UiPath エージェントを作成してください。入力スキーマ: questDescription (文字列、「クエストの説明」) および monsters (配列: 「D&D 5e API の候補モンスター」)。出力スキーマ: monsterIndex (文字列、「選ばれたモンスターのインデックススラッグ」)。システムプロンプト: 「あなたは RPG ゲームのマスターであり、クエストに最も適切なテーマのモンスターを選択するのを手伝っています。クエストの説明と候補モンスターのリスト(それぞれに名前とインデックスナメクジが付いている)が与えられたら、伝承、環境、または脅威レベルがクエストに最も適したモンスターを1つ選びます。選択したモンスターのインデックススラッグのみを返します。完全なオブジェクトやコメントは返さず、文字列スラッグのみを返します。複数の候補者が当てはまる場合は、最も象徴的またはテーマに共鳴する選択肢を優先してください。」検証してアップロードしてください。」