Volver a herramientas
DisponibleAgentes·

OpenAI Agents SDK

SDK open-source de OpenAI para construir sistemas multi-agente en Python y TypeScript. Sucesor de Swarm, incluye primitivas para handoffs, guardrails, trazabilidad y orquestación de agentes.

Compatible con

PythonTypeScript
agents-sdkmulti-agentehandoffsopenaiopen-source

OpenAI Agents SDK: orquestación multi-agente open-source

El Agents SDK es la evolución de Swarm, el experimento educativo de OpenAI sobre sistemas multi-agente. Ahora es un SDK de producción con soporte oficial.

Instalación

pip install openai-agents
# o
npm install @openai/agents

Concepto: Agents, Tools y Handoffs

from agents import Agent, Runner, tool

@tool
def buscar_producto(nombre: str) -> str:
    """Busca información de un producto en el catálogo."""
    return f"Producto {nombre}: precio 29.99€, stock: 15 unidades"

agente_ventas = Agent(
    name="Agente de Ventas",
    instructions="Ayudas a los clientes a encontrar productos.",
    tools=[buscar_producto]
)

resultado = Runner.run_sync(agente_ventas, "¿Tienes zapatillas rojas talla 42?")
print(resultado.final_output)

Handoffs: traspaso entre agentes

agente_soporte = Agent(name="Soporte Técnico", instructions="Resuelves problemas técnicos.")
agente_ventas = Agent(
    name="Ventas",
    instructions="Vendes productos. Si hay un problema técnico, traspasa a soporte.",
    handoffs=[agente_soporte]
)

Guardrails

from agents import InputGuardrail, GuardrailFunctionOutput

@InputGuardrail
async def no_datos_personales(ctx, agent, input):
    if "dni" in input.lower() or "tarjeta" in input.lower():
        return GuardrailFunctionOutput(
            output_info="Datos personales detectados",
            tripwire_triggered=True
        )

Trazabilidad

El SDK incluye integración nativa con OpenAI Tracing para visualizar el flujo de ejecución de agentes en el dashboard de OpenAI.