エージェントに接続する

モンスターセレクターエージェントにAPIワークフローをツールとして登録し、エージェントの入力スキーマを更新します。

ワークフローがパブリッシュされると、Agent Builder で接続可能なツールとして利用できるようになります。

ステップ 2 - モンスター セレクター エージェントを開く

Studio Web で MonsterSelector ソリューションに移動し、Agent Builder で開きます。

変更を加える前に、少し時間を取って現在の状態を確認してください。

• 入力: questDescription (文字列) と monsters (呼び出し元によって渡された候補の配列)
• 出力: monsterIndex (文字列): 選択したモンスターのナメクジ
• システム プロンプト: 提供されたリストから最適な一致を選択するようエージェントに指示します

このラボでは、 monsters 入力と、候補を事前に設定する必要性を削除します。エージェントは、作成したツールを使用して自動的にデータを取得します。

---

手順 3 - API ワークフローをツールとして接続する

ツールを追加する

キャンバス ビューが表示されていることを確認します。Agent Builder の上部にある [キャンバス]/[フォーム] トグルを使用します。[ツール] の下の [+ ] ボタンは、キャンバス ビューにのみ表示されます。

1. エージェント キャンバスの [ツール] で [+] を選択します。
2. ツール ボックス パネルから [ API ワークフロー] を選択します。
3. [ 利用可能なリソース ] パネルから、手順 1 で作成したワークフローを選択します。

注:

利用可能なリソースが空ですか?ワークフローは、ここに表示する前にパブリッシュする必要があります。手順 1 に戻って [フィードにパブリッシュ ] サブステップを完了してから、戻ってもう一度やり直してください。

ツールの説明を設定します

ツールに名前と説明を付けます。説明は、ツールをいつ、どのように呼び出すかを決定するためにエージェントが実行時に読み取る内容です。これは、人間用のラベルではなく、エージェントへの指示として記述します。

• Name (名前): Monster Query
• 説明: Searches the D&D 5e SRD for monsters matching a name or creature type. Returns up to 10 candidates with name, type, CR, size, alignment, and description. Call this tool when you need to find monster candidates for a quest.

注:

ツールの選択は、説明によって決定されます。エージェントは、ツール名ではなくこの説明を読み取って、ツールをいつ、どのように呼び出すかを決定します。曖昧な説明は、ツールの使用法を曖昧にします。ツールが返す内容と、それをいつ使用するかを具体的に指定します。

---

手順 4 - エージェントの契約を更新する

ツールを接続した状態で、新しいコントラクトを反映するようにエージェント定義を更新します。エージェントは、事前に入力されたモンスターリストを不要にし、独自の推論を含む構造化されたモンスターデータを返すようになりました。

このステップの 3 つの変更は連携して機能します。削除 monsters 、エージェントのデータに対する呼び出し元への依存関係が終了します。出力スキーマでは、エージェントが返すことを約束する内容を宣言します。更新されたプロンプトは、新機能の使用方法をエージェントに指示します。この 3 つはどれも、他のものなしでは機能しません。

エージェント定義を編集するには、キャンバスでエージェント ノードを選択し、右側に定義パネルを開きます。

入力からモンスターを除外する

エージェント定義の入力スキーマから monsters プロパティを削除します。更新される入力には questDescriptionのみが必要です。

monstersプロパティを削除するには、以下の手順を実行します。

1. エージェント内で、左側のナビゲーションバーにある [データ マネージャーを開く] アイコン (クリップボードのように見えます) を選択して、データ マネージャーを開きます。
2. [データ マネージャー] パネルには、[入力]、[出力]、[変数] の 3 つのグループがあります。monstersは [入力] リストにあるはずです。
3. monstersをポイントすると、ラベルの右側に編集アイコンと削除アイコン (鉛筆アイコン (編集) とゴミ箱アイコン (削除) が表示されます。
4. 削除アイコンを選択する monstersを削除します。

これで、入力は 1 つだけになります questDescription:

フィールド	入力	Required	説明
questDescription	string	はい	クエストの説明

出力スキーマを追加します

「 構築しているもの」のデザイン テーブルの 5 つのフィールドを含む出力スキーマを追加します。

同じ [データ マネージャー ] パネル内で、以下の操作を行います。

1. [ 出力] ヘッダーをポイントして、[ プロパティを追加 ] アイコン (+) を表示します。
2. [ プロパティを追加 ] を選択して、以下の各フィールドを追加します。

フィールド	入力
monsterIndex	string
monsterName	string
monsterType	string
monsterCr	string
monsterReasoning	string

注:

monsterReasoning API からではなく、エージェントによって生成されます。エージェントはこのフィールド自体を書きます:これは、選択したモンスターがクエストに適合する理由についてのエージェントの説明です。ツールの結果から取得される他の 4 つのフィールドとは異なり、 monsterReasoning はエージェント自身の判断を反映します。

システム プロンプトを更新します

[プロパティ] パネルを開くには、キャンバスでエージェントを選択するか、右上隅にあるレンチ アイコンを選択します。システム メッセージを次のように置き換えます。

You are a quest classifier for an adventurer's guild. Given a quest description, your job is to find the most thematically appropriate monster from the D&D 5e SRD and to return information about that monster.

When given a quest description:
1. Analyze the quest to determine what kind of creature fits the context - consider creature type, challenge rating, environment, and theme.
2. Call the Monster Query tool with a search term that targets that creature type.
3. Review the returned candidates and select the best fit for the quest.
4. Return the selected monster's key fields and a monsterReasoning that explains why this monster fits the quest.

Always call the Monster Query tool before selecting a monster. Do not guess monster details from memory.

重要:

コーディング エージェントは非決定論的です。プロンプトで生成される結果は、上の例とは異なります。それは予想通りです。重要なのは、エージェントがツールを呼び出し、候補を推論し、5 つの必須出力フィールドすべてを返すことです。

---

ツールを接続し、エージェント コントラクトを更新したら、次のセクションでフル パイプラインをテストする準備が整います。