Temario Lección 249 de 250 · Trabajar con las respuestas del modelo
Trabajar con las respuestas del modelo

Llamadas a herramientas en paralelo: un solo viaje de ida y vuelta

Por qué importa Pregunta "what's the weather in Paris, Tokyo and Lima?" y un modelo actual pide las tres herramientas en una sola respuesta. Si respondes mal, el modelo o pierde el hilo o deja de llamar a herramientas en paralelo.

Las reglas de la respuesta que devuelves:

  • Un solo mensaje de usuario cuyo contenido es una lista de bloques tool_result, uno por cada bloque tool_use, en el mismo orden. Repartirlos en varios mensajes le enseña al modelo a dejar de pedir en paralelo.
  • Cada resultado repite el id de su llamada como tool_use_id.
  • Una herramienta que falla sigue recibiendo un resultado: is_error: true y un mensaje breve, para que el modelo pueda explicarlo o intentarlo de otra forma. Nunca lo descartes, y nunca dejes que una herramienta que falla tumbe todo el turno.
  • Una herramienta que el modelo se ha inventado (no está en tu registro) también es un resultado de error, nunca algo que intentes ejecutar.

(Antes de devolver este mensaje, la propia respuesta del modelo, con todos sus bloques incluido el de razonamiento, se añade sin cambios a la conversación.)

Sobre estas respuestas: son simuladas. Cada una se escribió para este curso exactamente con la forma que devuelve la API Messages de Claude (bloques de contenido, stop_reason, usage), y cada una copia algo que hacen los modelos reales. No son grabaciones de un modelo en vivo, así que la redacción exacta es nuestra; las formas y los problemas son los reales con los que se encontrará tu código.

Tu turno

Escribe tool_results(reply, tools), donde tools asigna a cada nombre una función. Devuelve {"role": "user", "content": [...]} con un bloque por cada bloque tool_use, en orden: {"type": "tool_result", "tool_use_id": ..., "content": str(result), "is_error": False} cuando la herramienta se ejecutó, e is_error: True con el contenido "unknown tool: NAME" o "error: MESSAGE" (el mensaje de la excepción) cuando no. Deja REPLIES y TOOLS del código inicial como están: la comprobación los lee.

¿Has visto un problema en esta lección? Avísanos · Preguntar sobre esta lección

Este ejercicio se abre pronto

Termina la lección anterior y esta se desbloquea. Todo el curso es gratis, no hace falta cuenta, y puedes leer esta lección ahora mismo.