Llamada programática a herramientas: herramientas orquestadas por el modelo
En esta página
Estado a 5 de noviembre de 2026. La familia GPT-6 hereda las capacidades de API de GPT-5.6, incluida la llamada programática a herramientas. La API de Agents lo habilita de forma predeterminada (lección 10). OpenAI recomienda consultar la ficha del modelo antes de activarla.
Para entender qué aporta la llamada programática a herramientas, primero debes examinar el coste de la llamada a funciones clásica. El modelo solicita la ejecución de una herramienta, tu código la ejecuta y el resultado vuelve al modelo, que lo lee y decide el siguiente paso. Una ida y vuelta no es gran cosa. Diez idas y vueltas para una única tarea es otra historia: cada paso añade latencia y cada resultado intermedio, aunque sea voluminoso o irrelevante para la respuesta final, pasa de nuevo por el contexto del modelo y se factura en tokens. En tareas con muchas herramientas, estas idas y vueltas dominan tanto la latencia como el coste.
Qué cambia
La llamada programática a herramientas llegó con GPT-5.6 el 9 de julio de 2026 en la API de Responses. En lugar de solicitar herramientas una a una, el modelo escribe un pequeño programa en JavaScript para coordinarlas. Puede lanzar llamadas en paralelo, usar bucles y condiciones, y mantener los resultados intermedios dentro del entorno de ejecución. Solo el resultado reducido, el que importa para el siguiente paso, vuelve al contexto.
Piensa en una API con paginación. En la llamada a funciones clásica, cada página de resultados atraviesa el contexto para que el modelo decida si solicita la siguiente. Con la llamada programática a herramientas, el modelo escribe un bucle que itera por las páginas, suma lo que haya que sumar y devuelve únicamente los totales: menos tokens, menos latencia y menos código de orquestación que mantener.
OpenAI ejecuta cada programa en un entorno V8 nuevo y aislado. No hay Node.js, ni instalación de paquetes, ni acceso directo a la red, ni sistema de archivos general, ni estado conservado entre programas. El programa interactúa con el mundo solo a través de las herramientas que le expongas. Para la API de Responses, este comportamiento es compatible con la Retención Cero de Datos (ZDR), siempre que ZDR esté activado para la organización o el proyecto.
Cómo activarlo en la API de Responses
Bastan dos ajustes. Añades la herramienta alojada programmatic_tool_calling a la solicitud y luego especificas quién puede llamar a cada herramienta elegible mediante allowed_callers: ["direct"] (el comportamiento predeterminado, donde el modelo llama a la herramienta directamente), ["programmatic"] (solo un programa puede llamarla) o ambos. La documentación también recomienda describir la salida de cada función con output_schema para que el código generado pueda confiar en sus campos.
from openai import OpenAI
client = OpenAI()
tools = [
{
"type": "function",
"name": "read_stock",
"description": "Devuelve un objeto con sku (texto) y units (número).",
"parameters": {
"type": "object",
"properties": {"sku": {"type": "string"}},
"required": ["sku"],
"additionalProperties": False,
},
"output_schema": {
"type": "object",
"properties": {"sku": {"type": "string"}, "units": {"type": "number"}},
"required": ["sku", "units"],
"additionalProperties": False,
},
"allowed_callers": ["programmatic"],
},
{"type": "programmatic_tool_calling"},
]
response = client.responses.create(
model="gpt-5.6-terra",
input="Comprueba el stock de los SKU A12, B07 y C33 y marca aquellos con menos de 10 unidades.",
tools=tools,
)
Los tipos de herramienta que un programa puede llamar incluyen funciones y herramientas personalizadas, herramientas MCP, apply_patch, shell local o alojado, y el intérprete de código. Para una herramienta MCP sujeta a aprobación, el programa se pausa hasta que concedas el consentimiento.
Qué recibe tu aplicación
La respuesta sigue siendo un objeto Responses estándar con tres tipos de elementos que debes reconocer. Un elemento program contiene el JavaScript generado. Los elementos function_call corresponden a las llamadas a funciones realizadas por ese programa; su campo caller identifica el programa que las invocó. Por último, un elemento program_output entrega el resultado final del programa, con un estado completed o incomplete.
Tu aplicación nunca ejecuta el JavaScript; eso lo hace OpenAI. Tú solo ejecutas tus propias funciones y devuelves cada resultado en un function_call_output copiando el campo caller sin cambios para que el programa correcto pueda reanudarse. Repites este bucle hasta que la respuesta no contenga más llamadas por ejecutar.
Cómo identificar tareas que se benefician
No todas las integraciones de herramientas ganan al migrar. La guía de OpenAI ofrece una regla clara: la llamada programática a herramientas conviene en pasos donde el flujo es predecible y el código puede devolver un resultado más pequeño y estructurado. Está diseñada para filtrar, unir, ordenar, eliminar duplicados, agregar o validar múltiples resultados, o para encadenar llamadas dependientes donde el flujo de datos es predecible. La llamada directa sigue siendo preferible para una única búsqueda o acción, para búsquedas adaptativas donde cada resultado debe guiar la siguiente decisión y para la validación final de citas. También sigue siendo la opción predeterminada para escrituras y acciones que requieren aprobación, a fin de mantener un límite de autorización claro.
El criterio de decisión se reduce a una pregunta: ¿dónde pasa el tiempo tu agente? Si la respuesta es «esperando idas y vueltas de herramientas», la llamada programática a herramientas es la primera área que debes evaluar. Si tus llamadas a herramientas son escasas y sus resultados breves, mantén tu arquitectura actual y centra tus esfuerzos en otro lugar.
Pruébalo tú mismo
Identifica un candidato. Toma un flujo de tu agente que llame a varias herramientas. Para cada paso, anota el número de llamadas, el tamaño de los resultados intermedios y si es una lectura o una escritura. Clasifica cada paso usando la regla anterior. Para el paso más prometedor, escribe un prompt que especifique las herramientas permitidas, el formato de resultado esperado, la condición de parada, el número máximo de reintentos y qué permanece como llamada directa.
Fuentes oficiales: Llamada programática a herramientas · Uso de GPT-6 (documentación de la API de OpenAI) · Anuncio de GPT-5.6 (OpenAI, 9 de julio de 2026)
Puntos clave
- El modelo escribe y ejecuta JavaScript para coordinar sus herramientas en un entorno aislado gestionado por OpenAI
- Actívalo con la herramienta
programmatic_tool_callingy el campoallowed_callersen cada herramienta - Tu aplicación solo ejecuta sus funciones y devuelve el campo
callerintacto - Úsalo preferentemente para filtrar, agregar o encadenar llamadas predecibles; la llamada directa sigue siendo la norma para escrituras y aprobaciones