はじめに

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

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

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

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

次の操作を行います。

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

推定時間: 30 分から 45 分

構築する内容

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

---

前提条件

• Studio Web - ブラウザーで実行されます。デスクトップでのインストールは不要です。開始する前に、Chrome、Edge、または Firefox で Studio Web を開きます。
• UiPath アカウント - 開始する前に UiPath Automation Cloud に登録またはログインしてください。
• Node.js 18+ - UiPath CLI をインストールするために必要です。必要に応じて nodejs.org からインストールします。
• UiPath CLI v1.1+ - スターターのデプロイに必要です。uip --versionで確認します。
• 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 が表示されることを確認します。