Los agentes pueden planificar y completar tareas con herramientas, colaborar con otros agentes y conservar el contexto de un paso a otro.
Pon en marcha tu primer agente
Empieza con la guía de inicio rápido del SDK de agentes para instalar el SDK, definir un agente y ejecutarlo. Cuando lo tengas en marcha, vuelve aquí para elegir la siguiente capacidad que necesita tu aplicación.
Obtén el SDK de agentes
Consulta los repositorios de GitHub para ver más ejemplos, incidencias y documentación de referencia específica de cada lenguaje.
Abre el repositorio del SDK para TypeScript en GitHub.
Abre el repositorio del SDK para Python en GitHub.
Elige por dónde empezar
| Si quieres | Empieza aquí | Por qué |
|---|---|---|
| Crear una aplicación de agentes directamente en código | Inicio rápido | Es la vía más corta para integrar el SDK y ponerlo en marcha. |
| Definir con claridad un agente especializado | Definición de agentes | Empieza aquí si aún estás definiendo el contrato de un solo agente. |
| Elegir modelos, valores predeterminados y mecanismos de transporte | Modelos y proveedores | Consulta esta guía cuando la elección del modelo, la configuración del proveedor o la estrategia de transporte afecten al flujo de trabajo. |
| Entender el ciclo de ejecución y el estado | Ejecución de agentes | Aquí se explican el ciclo del agente, la transmisión de datos en tiempo real y las estrategias para continuar la ejecución. |
| Ejecutar tareas en un entorno basado en contenedores | Agentes en sandbox | Consulta esta guía si el agente necesita archivos, comandos, paquetes, instantáneas, montajes o enlaces a proveedores. |
| Asignar responsabilidades a los agentes especializados | Orquestación y transferencias de control | Consulta esta guía si necesitas más de un agente y debes decidir cuál se encarga de responder. |
| Incorporar validaciones o revisión humana | Medidas de protección y revisión humana | Consulta esta guía si el flujo de trabajo debe bloquear o pausar la ejecución antes de continuar con una tarea riesgosa. |
| Entender qué devuelve una ejecución | Resultados y estado | Esta página explica la salida final, el estado que permite reanudar la ejecución y las interfaces para el siguiente turno. |
| Incorporar herramientas alojadas, herramientas basadas en funciones o MCP | Uso de herramientas e Integraciones y observabilidad | La documentación de herramientas de la plataforma explica cómo se comportan las herramientas. La guía de integraciones explica cómo usar MCP y el seguimiento de ejecuciones en el SDK. |
| Inspeccionar y mejorar las ejecuciones | Integraciones y observabilidad y evaluación de flujos de trabajo de agentes | Primero usa las trazas para depurar y luego pasa a los ciclos de evaluación. |
| Crear un flujo de trabajo centrado en la voz | Agentes de voz | Usa el flujo de procesamiento de voz del SDK y los patrones de agentes en tiempo real. |
Desarrolla con el SDK
Usa el SDK cuando tu servidor se encargue del despliegue, la implementación de las herramientas, el almacenamiento del estado y las decisiones de aprobación, y el SDK ejecute el ciclo del agente e invoque esas herramientas. Esta opción es la más adecuada si buscas lo siguiente:
- código de aplicación tipado en TypeScript o Python
- control directo sobre las herramientas, los servidores MCP y el comportamiento en tiempo de ejecución
- almacenamiento personalizado o estrategias para gestionar las conversaciones desde el servidor
- integración estrecha con la lógica o la infraestructura existente de tu producto
Puedes leer la documentación del SDK en este orden:
- Empieza con Inicio rápido para ejecutar un agente por primera vez y ver el resultado en pantalla.
- Consulta Definición de agentes y Modelos y proveedores para definir con claridad un agente especializado.
- A medida que el flujo de trabajo se vuelva más complejo, continúa con Ejecución de agentes, Orquestación y transferencias de control y Medidas de protección y revisión humana.
- Consulta Resultados y estado e Integraciones y observabilidad cuando la lógica de tu aplicación dependa del objeto de ejecución o necesites observar el comportamiento del agente con más detalle.
Compara las opciones de ejecución de agentes
Consulta la descripción general de los agentes para comparar el SDK de agentes, la API de agentes y la API de Responses. El SDK de agentes se ejecuta en tu aplicación. La API de agentes ejecuta un arnés de ejecución administrado en el servicio de OpenAI.