OpenAI Agents API vs Responses API vs Agents SDK vs AgentKit: cuál elegir para tu desarrollo

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.

Prueba Apidog hoy

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.

En este artículo verás una comparación por 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, puedes probar la superficie HTTP 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 y 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 criterio que determina la mayoría de las demás decisiones.

API de Responses: tú ejecutas el bucle

Las herramientas alojadas, como búsqueda web, búsqueda de archivos, intérprete de código y MCP remoto, pueden realizar varias llamadas dentro de una solicitud. Sin embargo, tus propias funciones regresan a tu aplicación.

Cuando el modelo invoca una función:

1. Recibes un elemento function_call.
2. Ejecutas la función en tu infraestructura.
3. Envías un function_call_output con el mismo call_id en la siguiente solicitud.
4. Repites el proceso hasta que decidas finalizar.

También controlas:

• Cuándo detener el flujo.
• Cómo guardar el historial.
• Si almacenar respuestas: se almacenan por defecto; store: false lo desactiva.
• Cuándo compactar contexto con context_management y compact_threshold.

Consulta la guía de la API de Responses y la guía de llamada a funciones para implementar ese bucle.

SDK de Agents: tu proceso ejecuta el bucle

Según la documentación de OpenAI, el ejecutor del SDK “maneja el bucle del agente y las transferencias”. Aun así, tu servidor sigue siendo responsable de:

• El despliegue.
• Las implementaciones de herramientas.
• El almacenamiento de estado.
• Las decisiones de aprobación.

Con Sandbox Agents, el arnés puede permanecer en tu infraestructura mientras los comandos se ejecutan en un espacio de trabajo Unix local, Docker o un proveedor alojado. Esto permite mantener la autenticación, los registros de auditoría y la revisión humana fuera del contenedor.

API de Agents: OpenAI ejecuta el bucle

El arnés gestionado administra:

• Sesiones.
• Orquestación.
• Compactación de contexto.
• Recuperación.
• Subagentes.
• Búsqueda de herramientas.
• Llamadas programáticas a herramientas.

Los servidores MCP remotos son invocados directamente por OpenAI. Tus herramientas de función siguen requiriendo código propio: cuando la sesión informa un function_call en required_actions, debes devolver un evento agent.session.input.tool_result con el turn_id y el call_id.

La misma tarea implementada de ambas formas:

# 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 la compatibilidad 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 durante toda la sesión. Define environment.type con uno de estos valores:

{
  "environment": {
    "type": "openai_hosted"
  }
}

Opciones disponibles:

• openai_hosted: sandbox alojado y administrado por OpenAI.
• self_hosted: tu propio sandbox.
• none: sin entorno de cómputo.

Con el SDK de Agents, eliges y pagas el proveedor de sandbox. Con Responses, el código se ejecuta donde lo ejecutes tú, aparte de las herramientas alojadas.

Estado

Una sesión de la API de Agents guarda la configuración, los turnos y los elementos en OpenAI. Para continuar una conversación, envías un nuevo evento al mismo ID de sesión.

Con Responses, puedes encadenar solicitudes mediante previous_response_id o usar Conversations. Con el SDK, el estado reside en tu almacenamiento o en las sesiones del SDK.

Costo

Los precios de tokens son idénticos en todas las opciones porque llaman a los mismos modelos.

La API de Agents no cobra “tarifas adicionales”, pero los contenedores alojados cuestan entre $0.03, para 1 GB, y $0.48, para 16 GB, por sesión de 20 minutos.

El costo adicional del SDK es tu propio alojamiento. AgentKit no tiene una suscripción separada, según nuestro explicador de AgentKit.

Datos

La API de Agents solo admite residencia de datos en EE. UU. y no es compatible con Retención de Datos Cero (ZDR), incluso si utilizas un sandbox autoalojado.

La página de controles de datos de OpenAI indica que /v1/agents no es elegible para ZDR y conserva el estado hasta que se elimine. En cambio, /v1/responses es elegible para ZDR con limitaciones y está disponible en endpoints regionales como eu.api.openai.com.

Si ZDR o residencia de datos en la UE son requisitos, la API de Agents queda descartada actualmente.

AgentKit a finales de 2026: qué queda

AgentKit se lanzó el 6 de octubre de 2025 con cuatro componentes. Este es su estado:

• Agent Builder: deprecación anunciada el 3 de junio de 2026; cierre programado para el 30 de noviembre de 2026. La guía de migración de OpenAI permite exportar un flujo de trabajo como código del SDK de Agents o recrearlo como un Agente de Espacio de Trabajo de ChatGPT en Business, Enterprise o Edu.
• Evals: las evaluaciones existentes pasarán a modo de solo lectura el 31 de octubre de 2026. El panel y la API cerrarán el 30 de noviembre.
• ChatKit: permanece disponible para chat incrustado.
• Connector Registry: panel de administración para conectores y servidores MCP en los productos de OpenAI.

Como indica nuestra guía de AgentKit, la ruta duradera y orientada al código dentro de AgentKit es el SDK de Agents.

En cuál construir

Elegir	Cuándo
API de Agents	Las tareas duran minutos, necesitan archivos, comandos o navegador, y no quieres operar el bucle, los sandboxes ni el almacenamiento de sesión. La residencia en EE. UU. y un encabezado beta son aceptables.
API de Responses	Haces llamadas individuales, quieres controlar cada turno, necesitas ZDR o residencia de datos fuera de EE. UU., o ya tienes un bucle funcionando.
SDK de Agents	El código tipado de tu aplicación debe ser dueño de herramientas, almacenamiento, aprobaciones y transferencias, y el bucle debe ejecutarse en tu infraestructura.
ChatKit	Necesitas una interfaz 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 configurar MCP en cualquiera de las rutas orientadas al código, consulta servidores MCP con agentes de OpenAI.

Migrando de tu propio bucle de Responses a la API de Agents

Si ya construiste un bucle sobre Responses y quieres delegar su ejecución a OpenAI, sigue estos pasos.

1. Mapea las piezas

Haz corresponder la arquitectura actual con la nueva API:

En Responses	En la API de Agents
Instrucciones, modelo y herramientas	agent
Contenedor o sandbox	environment
Almacén de conversación	ID de sesión

2. Mueve los servidores MCP remotos a agent.tools

Incluye los servidores MCP remotos dentro de agent.tools. Guarda sus tokens en una bóveda adjunta usando vault_ids, no dentro de las indicaciones.

3. Reescribe el manejo de funciones

Reemplaza el bucle basado en function_call_output por un manejador de eventos:

• En streaming: agent.session.requires_action
• En webhook: agent.session.action_required

El manejador debe responder con agent.session.input.tool_result.

Los subagentes no pueden llamar herramientas de función, así que mantén esas herramientas en el agente principal.

4. Elimina tu código de compactación

El arnés de la API de Agents compacta el contexto automáticamente. Elimina la lógica propia que gestiona esa tarea.

5. Cambia a eventos de turno

No trates una sesión inactiva como una ejecución correcta. Consume eventos de resultado:

agent.session.turn.completed
agent.session.turn.failed
agent.session.turn.cancelled

Puedes recibirlos mediante streaming o webhooks.

6. Verifica las restricciones antes de migrar

Confirma que tu caso de uso acepta:

• Residencia de datos solo en EE. UU.
• Falta de compatibilidad con ZDR.
• El encabezado beta OpenAI-Beta: agents=v1.

Mantén ambos en un proyecto de Apidog

Antes de cambiar por completo, ejecuta la implementación antigua y la nueva en paralelo.

En un proyecto de Apidog:

1. Crea una carpeta Responses.
2. Crea una carpeta Agents API.
3. Comparte un entorno con {{OPENAI_API_KEY}} y una variable de modelo.
4. Envía las mismas indicaciones a ambas APIs.
5. Verifica códigos de estado y campos obligatorios de salida.
6. Abre el stream de Agents API como una solicitud SSE para observar los eventos de turno.
7. Guarda las ejecuciones como escenario de prueba.
8. Ejecútalo en CI mediante la CLI de Apidog.

Así, un cambio en la beta puede aparecer como una verificación fallida antes de llegar a producción. La guía de fiabilidad de agentes de IA en producción explica qué validar.

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 necesidades distintas.

¿Está deprecado OpenAI AgentKit?

Parcialmente. Agent Builder y Evals cerrarán 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 tokens coinciden en todas las opciones. La diferencia está en los contenedores alojados de la API de Agents frente a tu propio alojamiento con SDK o Responses.

Elige un camino esta semana

Elige según quién debe ejecutar el bucle y pruébalo con solicitudes antes de escribir la aplicación completa.

Si empiezas desde cero, prueba una sesión de la API de Agents y compara su salida con tu configuración actual de Responses en Apidog.