本文へスキップ
はじめてのエージェントを作るに戻る

はじめてのエージェントを作る · 第5章(全8章)

ツールとツール呼び出し

zodでツールを定義し、モデルにバインドし、モデルが行うツール呼び出しを処理します。

20分3個中0個の目標を達成

目標

  • ツールのスキーマに説明付きのフィールドを追加し、JSON Schemaが変わる様子を見ます。未完了
  • 無効な引数を送り、検証で拒否されるのを確認します。未完了
  • 確認問題に合格します。未完了

ステップ1/4: 本文

ツールはスキーマ付きの関数

@langchain/core/toolsのtool(fn, { name, description, schema })は、非同期関数をツールに変えます。スキーマはzodのオブジェクトです:z.object({ order_id: z.string().describe("The order number") })。ツールがどの引数を受け取るか、その型、どれが省略可能かを表します。

スキーマは2回役に立ちます。LangChainはそれをJSON Schemaに変換し、モデルはそれを読みます。そしてあなたのコードはそれを使い、関数が動く前にモデルが送った引数をチェックします。

モデルに見えるもの

model.bindTools(tools)は、呼び出しのたびに各ツールの名前、説明、JSON Schemaを送るモデルを返します。関数そのものはあなたのコードの外に出ません。モデルが知っているのはこの3つが伝えることだけなので、説明はプロンプトです。モデルに向けて書き、各フィールドを.describe()で説明してください。

ツール呼び出しとその答え

モデルがツールを使いたいとき、その応答はtool_callsを持つAIMessageです。各呼び出しにはname、args、idがあります。あなたのコードはツールを実行し、同じtool_call_idを持つToolMessageで答えます。モデルは一度に複数の呼び出しを求めることがあるので、各結果をその呼び出しと組にするのがidです。

ツール呼び出し全体をtool.invoke()に渡します。ツールはargsをスキーマで検証し、関数を実行し、ToolMessageを返してくれます。argsが合わなければToolInputParsingExceptionを投げ、関数は実行されません。エージェントのループはこのエラーを捕まえ、status "error"のToolMessageとして返すので、モデルは呼び出しを直せます。第6章では、ToolNodeがこれをやってくれます。

ステップ2/4: 試す:zodからツール呼び出しまで

zodからツール呼び出しまで

ツールのスキーマにフィールドを追加し、モデルが読むものを見ます。次に、有効な引数で1回、あなたが選ぶ引数で1回、モデルの呼び出しを本物の検証に通します。

モード:本物シミュレーション本物:zod、LangChainのtool()、JSON Schemaへの変換、検証がこのページで動きます。シミュレーション:モデルは台本どおりで、スキーマを読みません。ツール呼び出しはあらかじめ決まっていて、最後のステップではその引数をあなたが選びます。注文データは架空のものです。

ステップ3/4: 確認問題

確認問題

質問1/3バインドされたツールについて、モデルは何を受け取りますか?

次:質問2/3

質問2/3ToolMessageを、それが答える呼び出しと結びつけるものは何ですか?
質問3/3モデルがorder_idを数値で送りましたが、スキーマはz.string()です。どうなりますか?

ステップ4/4: これでできること

これでできること

  • tool()とzodスキーマで、役に立つ説明付きのツールを定義する。
  • ツールをモデルにバインドし、そのtool_callsを読む。
  • ツール呼び出しにToolMessageで答え、無効な引数を処理する。