はじめに

実行時に 5e SRD に対してクエリを実行する API ワークフロー ツールを使用して、ローコードの UiPath エージェントを拡張します。

このラボでは、UiPath 上に架空の冒険者ギルド向けに構築された RPG アドベンチャー システムである UiPathfinder の一部を構築します。これは、「 UiPath Agents 入門 」ラボで構築したエージェントを拡張したものです。5e SRD (システムリファレンスドキュメント) を検索するライブ API コネクタを構築し、そのコネクタをモンスターセレクターエージェントにツールとして提供します。エージェントは実行時に自律的にログを使用し、検索する対象を決定し、API を呼び出して、結果から最適な一致を選択します。

最後には、クエストの説明のみを受け取り、何を検索するかを決定し、モンスター クエリ ツールを呼び出し、選択したモンスターのキー フィールドを返すエージェントが UiPathfinder.QuestParser、事前に入力されたリストを必要としません。

ツールを使用しない場合、エージェントは呼び出し元に依存して候補をプリフェッチし、データとして渡します。ツールを追加すると、エージェントが実行時に検索対象を決定し、API を呼び出し、ライブ結果に基づいて推論を行うという変更が行われます。これは、ほとんどの運用エージェントのワークフローの背後にあるパターンです。エージェントの価値は、単に手渡されたものを分類するだけでなく、取得して推論する能力から生まれます。

次の操作を行います。

1. 5e SRD を呼び出す Monster Query API ワークフローを構築します。
2. モンスターセレクターエージェントにツールとして接続します。
3. エージェント コントラクトを更新して、新機能を反映させます。
4. ツールを使用しているエージェント全体をエンドツーエンドでテストします。

推定時間: 30 分から 45 分

構築する内容

コンポーネント	詳細
API ワークフロー	searchName (文字列) を受け入れ、Open5e 5e SRD API を呼び出して、配列monsterResults返します。
エージェントの入力: questDescription	string;クエストの説明。エージェントは、ツールを使用して独自の候補を取得します
エージェントの出力: monsterIndex	string;選択したモンスターの API の key 識別子 (例: srd_goblin
エージェントの出力: monsterName	string;選択したモンスターの表示名
エージェントの出力: monsterType	string;クリーチャー・タイプ(例えば、獣、アンデッド、ドラゴン)。API はこれを オブジェクトとして返すため、エージェントは以下を読み取ります type.name
エージェントの出力: monsterCr	string;チャレンジの評価。この API は、 などの数値 ( 0.25を返します。エージェントはこれをテキストとしてレンダリングします)
エージェントの出力: monsterReasoning	string;なぜこのモンスターをクエストに選んだのかというエージェントの説明

---

前提条件

• Studio Web - ブラウザーで実行されます。デスクトップでのインストールは不要です。開始する前に、Chrome、Edge、または Firefox で Studio Web を開きます。
• UiPath アカウント - 開始する前に UiPath Automation Cloud に登録またはログインしてください。
• Node.js 18+ - UiPath CLI をインストールするために必要です。必要に応じて nodejs.org からインストールします。
• UiPath CLI v1.198.0+ - スターターのデプロイに必要です。uip --versionに確認してください。npm install -g @uipath/cliを使用してインストールまたはアップグレードします。
• Studio Web のモンスター セレクター エージェント - このラボは、「 UiPath Agents の利用を開始する」に記載されているエージェントをベースにしています。そのラボを完了すると、エージェントはすでにそこにいます。そうでない場合は、スターターをデプロイします。

git clone https://github.com/cliff-simpkins/UiPath-Workshops.git
cd UiPath-Workshops/starters/monster-selector
uip login
uip solution upload .

手順 1 を開始する前に、 Studio Web を開き、ワークスペースに MonsterSelector が表示されることを確認します。