El OpenAI Agents SDK es un framework de Python para agentes con herramientas, handoffs y guardrails. Su documentación explica cómo conectar proveedores distintos de OpenAI. Con una API compatible con OpenAI, como BroadNet Inference, usted le entrega al SDK su propio cliente AsyncOpenAI y usa la clase de modelo de Chat Completions. El SDK usa por defecto la Responses API, que muchos proveedores no ofrecen.
Configuración
- Instale el SDK. Requiere Python 3.10 o posterior.
pip install openai-agents
export BROADNET_API_KEY='your-broadnet-key'
- Cree el cliente, el modelo y el agente.
import asyncio
import os
from agents import (
Agent,
AsyncOpenAI,
OpenAIChatCompletionsModel,
Runner,
function_tool,
set_tracing_disabled,
)
set_tracing_disabled(disabled=True) # tracing needs a platform.openai.com key
client = AsyncOpenAI(
base_url="https://inference.broadnet.ai/v1",
api_key=os.environ["BROADNET_API_KEY"],
)
model = OpenAIChatCompletionsModel(model="broadnet/glm-5.3", openai_client=client)
@function_tool
def get_order_status(order_id: str) -> str:
"""Look up an order."""
return f"Order {order_id}: shipped"
agent = Agent(
name="Support agent",
instructions="Answer briefly. Use tools when you need order data.",
model=model,
tools=[get_order_status],
)
async def main():
result = await Runner.run(agent, "Where is order 4471?")
print(result.final_output)
asyncio.run(main())
- Ejecútelo. El agente debería llamar a
get_order_statusy responder a partir de su resultado.
Tres formas de conectar el proveedor
La documentación del SDK enumera estas opciones integradas:
- Por agente: pase
OpenAIChatCompletionsModelcomoAgent.model, como arriba. Úselo cuando distintos agentes usen proveedores distintos. - Valor global por defecto:
set_default_openai_client(client)convierte su cliente en el predeterminado. Combínelo conset_default_openai_api("chat_completions"). - Por ejecución: pase un
ModelProviderpersonalizado enRunConfig(model_provider=...).
El valor global por defecto se ve así:
import os
from agents import (
Agent,
AsyncOpenAI,
set_default_openai_api,
set_default_openai_client,
set_tracing_disabled,
)
client = AsyncOpenAI(base_url="https://inference.broadnet.ai/v1", api_key=os.environ["BROADNET_API_KEY"])
set_default_openai_client(client, use_for_tracing=False)
set_default_openai_api("chat_completions")
set_tracing_disabled(True)
agent = Agent(name="Assistant", instructions="Be brief.", model="broadnet/glm-5.3")
Solo con variables de entorno, defina OPENAI_BASE_URL=https://inference.broadnet.ai/v1 y OPENAI_API_KEY con su clave de BroadNet, y haga las mismas llamadas a set_default_openai_api y set_tracing_disabled.
Cuando enruta por Chat Completions, la documentación del SDK indica que descarta sin avisar los campos exclusivos de Responses, como previous_response_id, conversation_id y prompt. Para recibir un error en su lugar, defina strict_feature_validation=True en OpenAIProvider. Guarde el estado de la conversación en su propio código; por ejemplo, pase la lista de entrada del resultado anterior a la siguiente ejecución. Las herramientas alojadas de OpenAI, como la búsqueda web y la búsqueda de archivos, no existen en otros proveedores. Use function_tool para todo lo que el agente deba llamar.
Tracing
El tracing está activado por defecto y envía las trazas a OpenAI. La documentación del SDK dice que, sin una clave de API de platform.openai.com, debe desactivarlo con set_tracing_disabled() o configurar otro procesador de tracing. Si tiene una clave de OpenAI, puede mantener el tracing activo y pasar esa clave con set_tracing_export_api_key(...). El SDK la usa solo para subir trazas. Su clave de BroadNet no sirve para eso.
Qué modelo elegir
| Tipo de agente | Modelo | Notas |
|---|---|---|
| Agentes con herramientas | GLM 5.3 | Herramientas y salida estructurada indicadas; contexto de 1M |
| Entrada de imágenes con herramientas | Qwen3.8 27B | Contexto de 262K; probado en árabe |
| Agentes de larga duración con tarifa plana | DeepSeek V4.1 Flash | Planes ilimitados; BroadNet no indica herramientas |
La documentación del SDK advierte que algunos proveedores no admiten salidas estructuradas con JSON schema. Si define output_type en un agente, use GLM 5.3 o Qwen3.8 27B. Compare precios en la página de precios.
Solución de problemas
- 401. La clave de BroadNet es incorrecta, caducó o se quedó sin saldo de pago por uso. Los errores de tracing en los registros son otra cosa: indican que el tracing sigue activo sin una clave de OpenAI.
- 404 o “not found”. Probablemente está usando la Responses API. Use
OpenAIChatCompletionsModeloset_default_openai_api("chat_completions"). Si ya lo tiene, compruebe que el ID del modelo coincida exactamente con el de BroadNet. Los modelos de pago requieren una recarga; el crédito de $5 cubre Gemma 4 VL 26B y los dos modelos Transcribe. final_outputvacío. El razonamiento cuenta paramax_tokens. Si definióModelSettings(max_tokens=...), auméntelo. Por qué las respuestas llegan vacías.- 429. Una clave de pago por uso permite 30 solicitudes por minuto y 4 a la vez. Cada ida y vuelta de una herramienta es una solicitud nueva. Consulte errores y reintentos.
- Agentes en paralelo con un plan. Una sesión de plan ilimitado ejecuta una solicitud a la vez. Los agentes lanzados juntos con
asyncio.gathernecesitan una sesión cada uno o quedan en cola. Consulte ejecutar agentes en paralelo con tarifa plana.
