BroadRouter

OpenAI Agents SDK con BroadNet Inference

Actualizado

Cree un cliente AsyncOpenAI con base_url https://inference.broadnet.ai/v1 y su clave de BroadNet, envuélvalo en OpenAIChatCompletionsModel con un ID de modelo como broadnet/glm-5.3 y pase ese modelo a su Agent. Llame a set_tracing_disabled(True), salvo que tenga una clave de OpenAI aparte para el tracing.

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

  1. Instale el SDK. Requiere Python 3.10 o posterior.
pip install openai-agents
export BROADNET_API_KEY='your-broadnet-key'
  1. 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())
  1. Ejecútelo. El agente debería llamar a get_order_status y responder a partir de su resultado.

Tres formas de conectar el proveedor

La documentación del SDK enumera estas opciones integradas:

  • Por agente: pase OpenAIChatCompletionsModel como Agent.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 con set_default_openai_api("chat_completions").
  • Por ejecución: pase un ModelProvider personalizado en RunConfig(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 OpenAIChatCompletionsModel o set_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_output vacío. El razonamiento cuenta para max_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.gather necesitan una sesión cada uno o quedan en cola. Consulte ejecutar agentes en paralelo con tarifa plana.

Preguntas frecuentes

¿Por qué el Agents SDK devuelve errores 404 con una base URL personalizada?

El SDK usa por defecto la Responses API, y BroadNet ofrece chat completions. Use OpenAIChatCompletionsModel, o llame a set_default_openai_api("chat_completions") si configura el cliente con variables de entorno.

¿Por qué el Agents SDK muestra errores de tracing?

El tracing sube los datos a OpenAI y requiere una clave de platform.openai.com. La documentación del SDK recomienda set_tracing_disabled() si no tiene una, o bien otro procesador de tracing.

¿Puedo configurar el Agents SDK solo con variables de entorno?

Sí. Defina OPENAI_BASE_URL como https://inference.broadnet.ai/v1 y OPENAI_API_KEY con su clave de BroadNet; luego llame a set_default_openai_api("chat_completions") y set_tracing_disabled(True). OPENAI_DEFAULT_MODEL fija el modelo de los agentes que no indican uno.

¿Cuántas sesiones de plan necesita una ejecución con varios agentes?

Una por cada solicitud que se ejecute al mismo tiempo. Los handoffs ejecutan un agente tras otro, así que basta con una sesión. Los agentes que corren en paralelo con asyncio.gather necesitan una sesión cada uno.

Leer en MarkdownPreguntar a ChatGPTPreguntar a ClaudePreguntar a Perplexity