OpenAI Agents SDK: el framework oficial de agentes de OpenAI

Un SDK minimalista a propósito

OpenAI publica el Agents SDK desde marzo de 2025, primero en Python y después en TypeScript, con licencia MIT. La documentación lo describe como la evolución madura de Swarm, un antiguo proyecto experimental. La idea es ofrecer las piezas justas para construir un agente de IA serio sin imponer una arquitectura pesada.

El SDK gira en torno a tres nociones:

• El agente: un gran modelo de lenguaje con instrucciones y herramientas, es decir, funciones que puede activar mediante la llamada a herramientas.
• El traspaso (handoff): un agente cede el control a otro más especializado, lo que permite montar un sistema multiagente.
• Las barreras de seguridad (guardrails): controles sobre lo que entra y lo que sale, para frenar una petición fuera de tema o una respuesta no conforme.

Además, el SDK incluye sesiones (memoria de la conversación), aprobación humana antes de acciones delicadas, trazabilidad para revisar cada paso, conexión con servidores MCP, agentes de voz y «sandbox agents» que trabajan dentro de un contenedor en tareas largas.

¿Para qué sirve en la práctica?

Algunos ejemplos: una atención al cliente en la que un agente de recepción deriva a un agente de «facturación» o de «soporte técnico»; un asistente interno que consulta una base de datos y redacta un resumen; un agente de voz que atiende llamadas. El SDK gestiona el ciclo del agente (llamar al modelo, ejecutar la herramienta, volver a llamar) y usted escribe la lógica de negocio.

Cómo empezar

Necesita Python 3.10 o superior. Se instala el paquete openai-agents con pip, se guarda la clave de API en una variable de entorno, se define un agente en pocas líneas y se ejecuta con el «Runner» del SDK. La documentación oficial ofrece ejemplos listos para adaptar, también para la versión TypeScript.

Puntos fuertes y límites

Puntos fuertes: pocos conceptos, documentación clara, trazabilidad incluida, licencia permisiva y compatibilidad con otros proveedores de modelos.

Límites: el SDK sigue pensado en primer lugar para el ecosistema de OpenAI, y algunas funciones (tiempo real, herramientas alojadas) solo existen con sus modelos. No ofrece un grafo de estados tan detallado como otros frameworks ni alojamiento llave en mano: el despliegue corre de su cuenta. Además, cada llamada al modelo tiene un coste; la calculadora de coste de un agente le ayuda a estimarlo.

Alternativas

Para controlar al detalle cada paso, LangGraph encaja mejor. Google ADK cubre más lenguajes, Pydantic AI apuesta por el tipado estricto y el Claude Agent SDK ofrece un agente que ya trae herramientas. La lista de frameworks de agentes le permite compararlos.