Temario Lección 118 de 250 · Llamar a un LLM de verdad
Llamar a un LLM de verdad

Llamadas a herramientas en paralelo e is_error

La lección anterior trataba una sola llamada a herramienta. Pero los modelos modernos piden varias a la vez: el uso de herramientas en paralelo está activado por defecto, así que un solo turno del asistente puede contener tres o cuatro bloques tool_use ("mira el tiempo Y busca el pedido Y comprueba el inventario"). Si tu código solo ejecuta la primera, el modelo espera unos resultados que nunca llegan y el turno se queda atascado.

Aquí "en paralelo" describe la PETICIÓN del modelo, no cómo la ejecutas tú: el modelo pidió varias herramientas en un mismo turno. Puedes ejecutarlas simplemente una tras otra y devolver todos los resultados juntos, sin hilos ni async.

El contrato es preciso: ejecuta todos los bloques tool_use y luego devuelve un solo mensaje del usuario cuyo content sea una lista de bloques tool_result, uno por llamada, cada uno con su propio tool_use_id.

{"content": [
  {"type": "tool_use", "id": "t1", "name": "get_weather", "input": {"city": "Paris"}},
  {"type": "tool_use", "id": "t2", "name": "add",         "input": {"a": 2, "b": 5}}],
 "stop_reason": "tool_use"}

La segunda idea nueva es el aislamiento de fallos. Si una herramienta lanza un error, NO hundes todo el turno ni pierdes los demás resultados. Devuelves el tool_result de ese bloque con "is_error": True y el texto del error como contenido, para que el modelo pueda ver qué salió mal y recuperarse. Un nombre de herramienta inventado (que no está en tu registro) no es más que otro error: indícalo como is_error, y nunca ejecutes algo que no hayas registrado.

Construye run_tool_calls(resp, tools), que devuelve el único mensaje de seguimiento del usuario. Si todo va bien, un tool_result tiene exactamente type, tool_use_id y content (el resultado con str(...)); si falla, ADEMÁS lleva "is_error": True. Pulsa Ejecutar para responder a un turno con dos llamadas.

Tu turno

Escribe run_tool_calls(resp, tools), que ejecuta TODOS los bloques tool_use de resp["content"] (ignora los demás tipos de bloque) y devuelve un mensaje del usuario {"role": "user", "content": [ ...tool_result blocks... ]}, con un resultado por llamada, en orden. Cada resultado correcto es {"type": "tool_result", "tool_use_id": <id>, "content": str(result)}. Si una herramienta lanza un error O su nombre no está en tools, ese resultado lleva en su lugar "is_error": True con el texto del error como content, y las demás herramientas se siguen ejecutando.

¿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.