Los agentes pueden usar herramientas para planificar y completar tareas, colaborar con otros agentes y mantener el contexto de un paso a otro. Elige un entorno de ejecución según dónde quieras ejecutar la orquestación y quién deba gestionar el estado entre tareas.
Elige por dónde empezar
| Si quieres | Empieza aquí |
|---|---|
| Ejecutar un agente con el arnés de ejecución de Codex que gestiona OpenAI | Agents API |
| Controlar el ciclo del agente en tu aplicación con agentes reutilizables, herramientas y transferencias de control | Agents SDK |
| Trabajar directamente con las respuestas del modelo y controlar tu integración | Responses API |
| Integrar un chat en tu aplicación | ChatKit |
Compara las opciones para ejecutar agentes
| Agents API | Agents SDK | Responses API | |
|---|---|---|---|
| Cuándo usar cada opción | Para tareas de larga duración en las que OpenAI gestiona el agente y guarda su progreso | Para crear agentes con herramientas y flujos de trabajo personalizados en tu aplicación | Para llamar a modelos directamente o crear un agente desde cero |
| Dónde se ejecuta el agente | OpenAI ejecuta y gestiona el arnés de ejecución de Codex | El SDK se ejecuta en tu aplicación | En tu aplicación, con la opción de usar un servicio de orquestación alojado |
| Esfuerzo de integración del agente | Bajo | Medio | Alto |
| Estado entre tareas | Se guardan la configuración de la sesión, los turnos y los elementos | Tu almacenamiento y las sesiones del SDK, o el estado de la conversación en Responses | Gestión manual del historial, encadenamiento de respuestas o Conversations |
| Ejecución de herramientas | Herramientas conectadas a servicios, controladores de funciones de la aplicación y un sandbox opcional | Herramientas e integraciones configuradas en tu aplicación | Herramientas alojadas y herramientas que ejecuta tu aplicación |
| Entorno de ejecución | Sandbox alojado por OpenAI, sandbox autoalojado o ejecución sin sandbox | Tu entorno de ejecución y tus integraciones con proveedores de sandbox | Tu propio entorno de ejecución |
| Empieza aquí | Descripción general de la Agents API | Descripción general del Agents SDK | Guía de Responses |
La Agents API ejecuta el arnés de ejecución de Codex y gestiona la infraestructura de los agentes para que puedas centrarte en lo que hacen. Incluye compactación automática del contexto, orquestación de múltiples agentes, llamadas programáticas a herramientas y compatibilidad con servidores MCP. Consulta Arquitectura.
Con el Agents SDK, tu aplicación controla el despliegue, el almacenamiento, las aprobaciones y la integración con el entorno de ejecución. El ejecutor del SDK gestiona el ciclo del agente y las transferencias de control. Consulta Ejecución de agentes.
Agrega herramientas, habilidades y almacenamiento en caché de prompts
El diseño de herramientas, las habilidades reutilizables y el almacenamiento en caché de prompts se aplican a distintos flujos de trabajo con agentes. La configuración y el ciclo de vida de estos recursos pueden variar según la API.
- Empieza con Uso de herramientas para conocer la llamada a funciones, MCP y las funcionalidades alojadas.
- Consulta Llamadas programáticas a herramientas para saber cómo orquestar herramientas con JavaScript y cómo configurar cada API.
- Consulta Habilidades para conocer las instrucciones reutilizables y los mecanismos de carga compatibles.
- Consulta Almacenamiento en caché de prompts para conocer el funcionamiento de la caché común a las distintas API y luego Observabilidad y uso de la Agents API para saber cómo se contabiliza el uso por sesión.
Una sesión de la Agents API, una sesión del SDK, una conversación de Responses y un sandbox son recursos distintos. Sigue las instrucciones de gestión del estado y limpieza de recursos correspondientes al entorno de ejecución que elijas.