Estos cuatro nombres se encuentran en diferentes capas, y una pregunta los separa: ¿quién ejecuta el bucle del agente? La API de Responses es la llamada al modelo, y tu código ejecuta el bucle a su alrededor. El SDK de Agents es una biblioteca de TypeScript y Python cuyo ejecutor ejecuta el bucle dentro de tu aplicación. La API de Agents, en beta pública desde el 10 de septiembre de 2026, ejecuta el arnés de Codex de OpenAI por ti y mantiene la sesión y, opcionalmente, el entorno aislado (sandbox). AgentKit es el paquete de octubre de 2025 que incluye Agent Builder, ChatKit, Connector Registry y Evals, y Agent Builder está programado para cerrarse el 30 de noviembre de 2026.
DevDay, el 29 de septiembre, añadió el uso de computación a la API de Agents (consulta el resumen de DevDay 2026), lo que hizo que la cuestión del nombre fuera más difícil de ignorar. A continuación: una comparación lado a lado sobre bucle, cómputo, estado, precio y madurez, una tabla de decisión y una ruta de migración desde un bucle de Responses hecho a mano. Para un recorrido práctico por las sesiones y aprobaciones, lee la guía de la API de Agents de OpenAI. Elijas lo que elijas, la superficie HTTP es testeable en Apidog.
Opciones de agente de OpenAI una al lado de la otra
| API de Agents | API de Responses | SDK de Agents | AgentKit | |
|---|---|---|---|---|
| Qué es | Runtime de agente gestionado en el arnés de Codex | Endpoint del modelo, POST /v1/responses |
Biblioteca para TypeScript y Python | Paquete: Agent Builder, ChatKit, Connector Registry, Evals |
| Quién ejecuta el bucle | OpenAI | Tu código | El ejecutor del SDK, en tu aplicación | Flujos de trabajo de Agent Builder, exportados a código SDK o incrustados con ChatKit |
| Dónde se ejecuta el cómputo | Sandbox alojado por OpenAI, tu propio sandbox, o ninguno | Tu entorno, más herramientas alojadas | Tu runtime y proveedores de sandbox | No aplica |
| Dónde reside el estado | Sesión de OpenAI: configuración, turnos, elementos | Tu historial, previous_response_id, o la API de Conversations |
Tu almacenamiento, sesiones del SDK o estado de Responses | Flujos de trabajo publicados y versionados |
| Lo que pagas | Tokens, herramientas y contenedores alojados; sin tarifa extra | Tokens y herramientas | Tokens y herramientas, más tu alojamiento | Uso de API subyacente; sin suscripción separada |
| Esfuerzo de integración (según OpenAI) | Bajo | Alto | Medio | No calificado |
| Estado | Beta pública (OpenAI-Beta: agents=v1) |
Recomendado para todos los proyectos nuevos | Actual | Agent Builder y Evals cerrarán el 30 de noviembre de 2026; ChatKit permanece |
| Controles de datos | Solo residencia de datos en EE. UU.; no elegible para ZDR; estado guardado hasta su eliminación | Elegible para ZDR (con limitaciones); endpoints regionales | Depende de las APIs que llama | No aplica |
Fuentes: comparación del runtime de agentes de OpenAI, la descripción general de la API de Agents y la página de deprecaciones.
Quién ejecuta el bucle
Este es el eje que decide la mayoría de las otras filas.
API de Responses: tú la ejecutas. Las herramientas alojadas como la búsqueda web, la búsqueda de archivos, el intérprete de código y el MCP remoto pueden ejecutar varias llamadas dentro de una solicitud, pero tus propias funciones vuelven a ti. Cuando el modelo llama a una, obtienes un elemento function_call, lo ejecutas y envías un function_call_output con el mismo call_id en la siguiente solicitud. Tú decides cuándo detenerte, cómo almacenar el historial (las respuestas se almacenan por defecto; store: false lo desactiva) y cuándo compactar contextos largos con context_management y compact_threshold. La guía de la API de Responses y la guía de llamada a funciones cubren ese bucle.
SDK de Agents: tu proceso lo ejecuta. La documentación de OpenAI dice que el ejecutor del SDK "maneja el bucle del agente y las transferencias", mientras que tu servidor es dueño del despliegue, las implementaciones de herramientas, el almacenamiento de estado y las decisiones de aprobación. Con los Sandbox Agents, el arnés puede permanecer en tu infraestructura mientras los comandos se ejecutan en un espacio de trabajo Unix-local, Docker o de proveedor alojado, de modo que la autenticación, los registros de auditoría y la revisión humana permanezcan fuera del contenedor.
API de Agents: OpenAI la ejecuta. El arnés gestionado maneja las sesiones, la orquestación, la compactación de contexto y la recuperación, y añade subagentes, búsqueda de herramientas y llamadas programáticas a herramientas. Los servidores MCP remotos son llamados directamente por OpenAI. Tu código aún maneja las herramientas de función: cuando la sesión reporta un function_call en required_actions, devuelves un evento agent.session.input.tool_result con el turn_id y call_id.
La misma tarea, de ambas maneras:
# API de Responses: una llamada al modelo; tu código es dueño del bucle
curl https://api.openai.com/v1/responses \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6.1-sol",
"reasoning": {"effort": "low"},
"tools": [{"type": "web_search"}],
"input": "Summarize the breaking changes in the latest Node.js release."
}'
# API de Agents: una sesión duradera; OpenAI es dueño del bucle
curl https://api.openai.com/v1/agents/sessions \
-H "OpenAI-Beta: agents=v1" \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"agent": {"model": "gpt-6-astra", "tools": [{"type": "web_search"}]},
"environment": {"type": "none"},
"input": "Summarize the breaking changes in the latest Node.js release."
}'
Los ejemplos de la documentación de la API de Agents utilizan gpt-6-astra; no especifican si se aceptan otros modelos, así que verifica antes de cambiar a gpt-6.1-sol.
Cómputo, estado y costo
Cómputo. La API de Agents puede aprovisionar y gestionar un sandbox para toda la sesión: establece environment.type en openai_hosted, self_hosted o none. Con el SDK, tú eliges y pagas al proveedor del sandbox. Con Responses, el código se ejecuta donde tú lo ejecutes, aparte de las herramientas alojadas.
Estado. Una sesión de la API de Agents guarda la configuración, los turnos y los elementos en el lado de OpenAI, por lo que un seguimiento es un evento en el mismo ID de sesión. Con Responses, encadenas previous_response_id o utilizas Conversations. Con el SDK, el estado reside en tu almacenamiento o en las sesiones del SDK.
Costo. Los precios de los tokens son idénticos en todas partes, ya que cada opción llama a los mismos modelos. La API de Agents no cobra "tarifas adicionales", pero los contenedores alojados cuestan de $0.03 (1 GB) a $0.48 (16 GB) por sesión de 20 minutos. El costo adicional del SDK es tu propio alojamiento. AgentKit no tiene suscripción separada, según nuestro explicador de AgentKit.
Datos. La API de Agents solo admite la residencia de datos en EE. UU. y no es compatible con la Retención de Datos Cero (ZDR), incluso con un sandbox autoalojado. La página de controles de datos de OpenAI enumera /v1/agents como no elegible para ZDR, con el estado retenido hasta su eliminación, mientras que /v1/responses es elegible para ZDR con limitaciones y está disponible en endpoints regionales como eu.api.openai.com. Si la ZDR o la residencia en la UE son un requisito, eso descarta la API de Agents hoy.
AgentKit a finales de 2026: qué queda
AgentKit se lanzó el 6 de octubre de 2025 como cuatro componentes. Así es como se encuentra cada uno:
- Agent Builder: deprecación anunciada el 3 de junio de 2026; cierre programado el 30 de noviembre de 2026. La guía de migración de OpenAI exporta un flujo de trabajo como código del SDK de Agents, o lo recrea como un Agente de Espacio de Trabajo de ChatGPT en Business, Enterprise o Edu.
- Evals: las evaluaciones existentes pasarán a ser de solo lectura el 31 de octubre de 2026, y el panel y la API están programados para cerrarse el 30 de noviembre.
- ChatKit: permanece disponible para chat incrustado.
- Connector Registry: el panel de administración para conectores y servidores MCP en todos los productos de OpenAI.
Como indica nuestra guía de AgentKit, la ruta duradera y "code-first" a través de AgentKit es el SDK de Agents.
En cuál construir
| Elegir | Cuándo |
|---|---|
| API de Agents | Las tareas se ejecutan durante minutos, necesitan archivos, comandos o un navegador, y no quieres operar el bucle, los sandboxes o el almacenamiento de sesión. La residencia en EE. UU. y un encabezado beta son aceptables. |
| API de Responses | Haces llamadas individuales, quieres tener cada turno bajo tu control, necesitas ZDR o residencia de datos fuera de EE. UU., o ya tienes un bucle en funcionamiento. |
| SDK de Agents | El código de aplicación tipado debe poseer las herramientas, el almacenamiento, las aprobaciones y las transferencias, y el bucle debe ejecutarse en tu infraestructura. |
| ChatKit | Necesitas una interfaz de usuario de chat incrustada en tu producto. |
| Agent Builder | No empieces aquí. Exporta los flujos de trabajo existentes antes del 30 de noviembre de 2026. |
En AWS, Bedrock Managed Agents, impulsado por OpenAI, ofrece las capacidades centrales de la API de Agents para ejecutarse de forma nativa en AWS. Para el cableado de MCP en cualquiera de las rutas "code-first", consulta servidores MCP con agentes de OpenAI.
Migrando de tu propio bucle de Responses a la API de Agents
Si has construido un bucle sobre Responses y quieres que OpenAI lo ejecute:
- Mapea las piezas. Las instrucciones, el modelo y las herramientas se mueven a
agent; tu contenedor se convierte enenvironment; tu almacén de conversación se convierte en un ID de sesión. - Mueve los servidores MCP remotos a
agent.tools. Coloca sus tokens en una bóveda adjunta convault_ids, no en las indicaciones. - Reescribe el manejo de funciones. Reemplaza tu bucle
function_call_outputcon un manejador paraagent.session.requires_action(stream) oagent.session.action_required(webhook) que devuelvaagent.session.input.tool_result. Los subagentes no pueden llamar a herramientas de función, así que mantenlos en el agente principal. - Elimina tu código de compactación. El arnés compacta el contexto automáticamente.
- Cambia a eventos. Transmite los resultados de los turnos (
agent.session.turn.completed,agent.session.turn.failed,agent.session.turn.cancelled) o usa webhooks. Una sesión inactiva no significa éxito. - Verifica las restricciones. Solo residencia en EE. UU., sin ZDR y un encabezado beta.
Mantén ambos en un proyecto de Apidog
Antes de cambiar, ejecuta lo antiguo y lo nuevo lado a lado. En un proyecto de Apidog, crea una carpeta Responses y una carpeta Agents API que compartan un entorno con {{OPENAI_API_KEY}} y una variable de modelo. Envía las mismas indicaciones a través de ambos, afirma sobre los códigos de estado y los campos de salida requeridos, y abre el stream de la API de Agents como una solicitud SSE para observar los eventos de turno. Guarda las ejecuciones como un escenario de prueba y ejecútalo en CI con la CLI de Apidog, para que un cambio beta aparezca como una verificación fallida. La guía de fiabilidad de agentes de IA en producción cubre qué afirmar. Descarga Apidog para configurarlo.
Preguntas frecuentes
¿La API de Agents está reemplazando a la API de Responses? No se ha anunciado ninguna deprecación. La descripción general de agentes de OpenAI enumera la API de Agents, el SDK de Agents y la API de Responses como opciones actuales para diferentes necesidades.
¿Está deprecado OpenAI AgentKit? Parcialmente. Agent Builder y Evals están programados para cerrarse el 30 de noviembre de 2026; ChatKit permanece disponible.
¿El SDK de Agents usa la API de Agents? No. El SDK se ejecuta en tu aplicación; la API de Agents ejecuta un arnés gestionado en el servicio de OpenAI.
¿Qué pasó con la API de Assistants? La página de deprecaciones de OpenAI fijó su eliminación para el 26 de agosto de 2026 y dirige a los desarrolladores a las APIs de Responses y Conversations.
¿Qué opción es la más barata? Los precios de los tokens coinciden en todas ellas. La diferencia radica en los contenedores alojados en la API de Agents frente a tu propio alojamiento con el SDK o Responses.
Elige un camino esta semana
Elige según quién debe ejecutar el bucle y luego pruébalo con solicitudes antes de escribir una aplicación. Si empiezas de nuevo, prueba una sesión de la API de Agents y compara su salida con tu configuración actual de Responses en Apidog.