Un agente que necesita tres archivos no tiene por qué pedirlos de uno en uno, con un viaje de ida y vuelta por cada uno. Con las llamadas a herramientas en paralelo, el modelo pide los tres a la vez.
Cómo funciona
En una respuesta con llamadas a herramientas, message.tool_calls es una lista. Con llamadas en paralelo tiene más de una entrada, cada una con su propio id, nombre de función y argumentos JSON.
"tool_calls": [
{"id": "call_1", "type": "function", "function": {"name": "read_file", "arguments": "{\"path\": \"a.py\"}"}},
{"id": "call_2", "type": "function", "function": {"name": "read_file", "arguments": "{\"path\": \"b.py\"}"}}
]
Su código ejecuta las llamadas y añade un mensaje tool por llamada, cada uno con el tool_call_id correspondiente, y luego vuelve a llamar al modelo.
- OpenAI:
parallel_tool_callsvaletruepor defecto. Ponerlo enfalse“ensures exactly zero or one tool is called.” (traducción: garantiza que se llame exactamente a cero o una herramienta.) La guía advierte que una versión concreta de un modelo a veces repetía llamadas a la misma herramienta y recomienda desactivar la función en ese caso. - Anthropic: el uso en paralelo está activado por defecto. Se desactiva con
disable_parallel_tool_use: truedentro del objeto tool_choice. Anthropic dice que la API “doesn’t prescribe an execution order” (traducción: no prescribe un orden de ejecución), y que todos los resultados de herramientas deben volver en un único mensaje de usuario para que el paralelismo siga funcionando.
Por qué importa
- Latencia. Menos viajes de ida y vuelta al modelo. Las herramientas independientes y de solo lectura pueden ejecutarse a la vez de su lado.
- Orden. Las llamadas con efectos secundarios, como escribir y luego leer, pueden depender unas de otras. Anthropic sugiere ejecutarlas en secuencia. O desactive la función.
- Control. Cada llamada necesita un resultado con el ID correcto. Un resultado que falta es una causa habitual de que falle la siguiente solicitud.
En BroadNet Inference
La referencia de la API de BroadNet documenta las llamadas a herramientas para GLM 5.3 y Qwen3.8 27B y no documenta parallel_tool_calls. Pruebe si su prompt recibe varias llamadas y si se respeta false. Las llamadas en paralelo llegan en una sola respuesta, así que no suman a su número de solicitudes. Ejecutar las herramientas corre de su cuenta. Tenga en cuenta que una sesión de un plan ilimitado de BroadNet permite una solicitud a la vez y es solo para DeepSeek V4.1 Flash; en las claves de pago por uso, el límite de concurrencia es de 4 solicitudes en curso. El artículo sobre llamadas a herramientas con modelos abiertos tiene un bucle funcional.
Errores comunes
- Devolver los resultados con un formato de mensaje distinto para cada llamada, u omitir uno.
- Ejecutar de forma concurrente herramientas que dependen entre sí solo porque el modelo las listó juntas.