Saltar al contenido
Volver a Construye tus primeros agentes

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.

20 minutos0 de 3 objetivos hechos

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

Pregunta 1 de 3¿Qué recibe el modelo sobre una herramienta vinculada?

Siguiente: Pregunta 2 de 3

Pregunta 2 de 3¿Qué vincula un ToolMessage con la llamada a la que responde?
Pregunta 3 de 3El modelo envía order_id como number, pero el esquema dice z.string(). ¿Qué pasa?

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.