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

エージェントの設定を検証し、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 にアップロードします

次の手順

• Adding Tools to Your UiPath Agent - extend Monster Selector with a tool that calls the 5e SRD API directly, removing the monsters[] input and letting the agent decide what to search for.
• オーケストレーション パターン (今後のラボ): エージェントは、UiPath フロー プロジェクト、API ワークフロー、およびその他のエージェントから呼び出すことができます。
• UiPath Agents のドキュメント - ローコード エージェントおよびコード化されたエージェントの機能に関する完全なリファレンスです。
• UiPath コミュニティ - フォーラム、使用方法、開発者によるディスカッション

ヒント:

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

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

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

"Create a low-code UiPath agent named MonsterSelector. Input schema: questDescription (string, "Description of the quest") and monsters (array, "Candidate monsters from the 5e SRD API"). Output schema: monsterIndex (string, "The index slug of the chosen monster"). System prompt: 'You are an RPG game master helping to select the most thematically appropriate monster for a quest. Given a quest description and a list of candidate monsters (each with a name and an index slug), pick the ONE monster whose lore, environment, or threat level best fits the quest. Return ONLY the index slug of your chosen monster. Do not return the full object or any commentary - just the string slug. If multiple candidates fit, favor the most iconic or thematically resonant choice.' Validate and upload."