Construye tus primeros agentes · Capítulo 5 de 8
Herramientas y llamadas a herramientas
Definir herramientas con zod, vincularlas a un modelo y manejar las llamadas a herramientas que hace el modelo.
Objetivos
- Agrega un campo descrito al esquema de una herramienta y mira cómo cambia su JSON Schema.Pendiente
- Envía argumentos inválidos y mira cómo la validación los rechaza.Pendiente
- Supera la comprobación.Pendiente
Paso 1 de 4: La lectura
Una herramienta es una función con un esquema
tool(fn, { name, description, schema }) de @langchain/core/tools convierte una función async en una herramienta. El esquema es un objeto de zod: z.object({ order_id: z.string().describe("The order number") }). Dice qué argumentos recibe la herramienta, sus tipos y cuáles son opcionales.
El esquema sirve dos veces. LangChain lo convierte a JSON Schema, que es lo que lee el modelo. Y tu código lo usa para revisar los argumentos que envía el modelo antes de que se ejecute tu función.
Lo que ve el modelo
model.bindTools(tools) devuelve un modelo que envía el nombre, la descripción y el JSON Schema de cada herramienta en cada llamada. La función en sí nunca sale de tu código. El modelo solo sabe lo que le dicen esos tres, así que las descripciones son prompts: escríbelas para el modelo y describe cada campo con .describe().
Una llamada a herramienta y su respuesta
Cuando el modelo quiere una herramienta, su respuesta es un AIMessage con tool_calls: cada llamada tiene un name, unos args y un id. Tu código ejecuta la herramienta y responde con un ToolMessage que lleva el mismo tool_call_id. Un modelo puede pedir varias llamadas a la vez, así que el id es lo que empareja cada resultado con su llamada.
Pasa la llamada a herramienta entera a tool.invoke(). La herramienta valida los args contra su esquema, ejecuta tu función y te devuelve el ToolMessage. Si los args no coinciden, lanza ToolInputParsingException y tu función nunca se ejecuta. Un ciclo de agente atrapa el error y lo devuelve como un ToolMessage con status "error", para que el modelo pueda corregir su llamada. En el capítulo 6, ToolNode hace esto por ti.
Paso 2 de 4: Pruébalo: De zod a la llamada a herramienta
De zod a la llamada a herramienta
Agrega un campo al esquema de una herramienta y mira lo que lee el modelo. Luego pasa la llamada del modelo por la validación real, una vez con argumentos válidos y otra con argumentos que tú eliges.
Modo:RealSimuladoReal: zod, el tool() de LangChain, la conversión a JSON Schema y la validación se ejecutan en esta página. Simulado: el modelo sigue un guion y no lee el esquema. Sus llamadas a herramientas están fijadas de antemano, y en el último paso tú eliges sus argumentos. Los datos del pedido son ficticios.
Paso 3 de 4: Comprobación
Comprobación
Siguiente: Pregunta 2 de 3
Paso 4 de 4: Lo que ya puedes hacer
Lo que ya puedes hacer
- Definir una herramienta con tool() y un esquema de zod, con descripciones útiles.
- Vincular herramientas a un modelo y leer sus tool_calls.
- Responder una llamada a herramienta con un ToolMessage, y manejar argumentos inválidos.