OpenAI Agents SDK
Qué cubre este artículo
- Qué es el OpenAI Agents SDK y para qué sirve.
- Cómo instalarlo.
- Cómo construir tu primer agente con una herramienta.
- Cómo trabajar en local o con la API de OpenAI.
- Para qué es especialmente útil y dónde están sus límites.
Introducción
El OpenAI Agents SDK es el framework oficial de Python de OpenAI para construir agentes. Proporciona herramientas para invocación de funciones, gestión de estado y flujos de trabajo. La instalación es sencilla y la curva de aprendizaje muy amable. Si quieres empezar directamente con modelos potentes, es una opción sólida. También puedes ejecutarlo en local a través de endpoints compatibles con OpenAI como Ollama, aunque el foco principal está en las APIs de OpenAI.
El OpenAI Agents SDK en breve
El SDK trabaja con agentes, herramientas y ejecutores. Un agente recibe una instrucción y puede utilizar herramientas. Un ejecutor procesa la solicitud y controla el flujo de ejecución. Las herramientas son funciones Python que el agente puede invocar. De esta forma puedes construir un agente que investigue, realice cálculos o consuma APIs externas.
Instalación
pip install openai-agentsPara trabajar con OpenAI necesitas una clave API:
export OPENAI_API_KEY="tu-clave"Si usas un modelo local compatible con OpenAI como Ollama, configura también la URL base:
export OPENAI_BASE_URL="http://localhost:11434/v1"Primeros pasos: Un agente con herramienta
from agents import Agent, Runner
def aktuelles_jahr() -> str:
return "2026"
agent = Agent(
name="hilfsassistent",
instructions="Du hilfst bei einfachen Fragen.",
tools=[aktuelles_jahr]
)
result = Runner.run_sync(agent, "Welches Jahr haben wir?")
print(result.final_output)En este ejemplo registras una función Python como herramienta. El agente decide por sí solo si necesita invocarla.
¿Para qué es útil este SDK?
| Caso de uso | Ventaja |
|---|---|
| Prototipos rápidos | Invocación de funciones sencilla y API de ejecutor |
| Agentes en la nube | Integración directa con modelos de OpenAI |
| Flujos de trabajo con APIs | Agentes acceden a tus propias funciones |
| Aprendizaje | Poco boilerplate, resultados rápidos |
Obstáculos comunes
- Costos de API - Los modelos de OpenAI no son gratuitos. Para pruebas locales integra Ollama.
- Sin coordinación nativa de múltiples agentes - Para equipos de múltiples agentes complejos, CrewAI o AutoGen suelen ser más flexibles.
- Prestar atención a la URL base - Con Ollama la URL debe terminar en
/v1y se requiere una clave API arbitraria.
Enlaces de interés
Preguntas frecuentes
¿Es gratuito el OpenAI Agents SDK?
El SDK en sí es gratuito. Los costos surgen solo al usar la API de OpenAI. Los modelos locales vía Ollama son gratuitos.
¿Puedo ejecutarlo en local?
Sí, a través de endpoints compatibles con OpenAI como Ollama. Para ello establece OPENAI_BASE_URL en http://localhost:11434/v1.
¿Qué necesito para empezar?
Python, pip install openai-agents y una clave API de OpenAI o un modelo Ollama local.