はじめてのエージェントを作る · 第5章(全8章)
ツールとツール呼び出し
zodでツールを定義し、モデルにバインドし、モデルが行うツール呼び出しを処理します。
目標
- ツールのスキーマに説明付きのフィールドを追加し、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: 確認問題
確認問題
次:質問2/3
ステップ4/4: これでできること
これでできること
- tool()とzodスキーマで、役に立つ説明付きのツールを定義する。
- ツールをモデルにバインドし、そのtool_callsを読む。
- ツール呼び出しにToolMessageで答え、無効な引数を処理する。