---
title: "OpenAI Agents SDK con un proveedor compatible con OpenAI"
description: "Use el OpenAI Agents SDK para Python con BroadNet Inference mediante AsyncOpenAI y OpenAIChatCompletionsModel, y desactive el tracing que exige una clave de OpenAI."
url: https://broadrouter.com/es/guides/openai-agents-sdk-custom-provider/
lang: es
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Traducido del inglés con ayuda de IA. [Lea el original en inglés](https://broadrouter.com/guides/openai-agents-sdk-custom-provider/) (actualizado el 2026-11-16).

# OpenAI Agents SDK con BroadNet Inference

Actualizado 2026-11-16

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.

```bash
pip install openai-agents
export BROADNET_API_KEY='your-broadnet-key'
```

2.  **Cree el cliente, el modelo y el agente.**

```python
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())
```

3.  **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í:

```python
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](https://broadrouter.com/es/models/glm-5.3/) | Herramientas y salida estructurada indicadas; contexto de 1M |
| Entrada de imágenes con herramientas | [Qwen3.8 27B](https://broadrouter.com/es/models/qwen3.8-27b/) | Contexto de 262K; probado en árabe |
| Agentes de larga duración con tarifa plana | [DeepSeek V4.1 Flash](https://broadrouter.com/es/models/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](https://broadrouter.com/es/pricing/).

## 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](https://broadrouter.com/es/guides/reasoning-tokens-empty-response/).
-   **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](https://broadrouter.com/es/guides/errors-and-retries/).
-   **Agentes en paralelo con un plan.** Una [sesión de plan ilimitado](https://broadrouter.com/es/guides/unlimited-llm-api-sessions/) 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](https://broadrouter.com/es/blog/run-parallel-coding-agents-flat-rate/).

## Términos de esta guía

[Llamadas a herramientas (tool calling)](https://broadrouter.com/es/glossary/tool-calling/)

Las llamadas a herramientas (tool calling), también llamadas function calling, son una función de las APIs de LLM en la que el modelo devuelve una solicitud estructurada para ejecutar una función definida por el desarrollador, con argumentos JSON. La aplicación ejecuta la función y devuelve el resultado; el modelo nunca ejecuta código.

[Pago por uso (pay-as-you-go)](https://broadrouter.com/es/glossary/pay-as-you-go/)

El pago por uso es un modelo de precios en el que usted paga solo lo que usa, medido por unidades como tokens, solicitudes o minutos de audio, sin suscripción ni compromiso mínimo. La mayoría de las APIs de LLM cobran así, desde un saldo prepagado o con una factura periódica.

[Salida estructurada (structured output)](https://broadrouter.com/es/glossary/structured-output/)

La salida estructurada es una función de las APIs de LLM que restringe la respuesta del modelo a un formato que define el desarrollador, normalmente un JSON Schema, para que el código pueda procesarla de forma fiable. Es más estricta que JSON mode, que garantiza JSON válido pero no una forma concreta.

[API de Chat Completions](https://broadrouter.com/es/glossary/chat-completions-api/)

La API de Chat Completions es el endpoint HTTP de OpenAI, POST /v1/chat/completions, que recibe un nombre de modelo y una lista de mensajes etiquetados con su rol y devuelve el siguiente mensaje del modelo. Su forma de solicitud y respuesta se convirtió en el formato común que reutilizan los proveedores y SDKs compatibles con OpenAI.

[Concurrencia (concurrency)](https://broadrouter.com/es/glossary/concurrency/)

La concurrencia es el número de solicitudes que un cliente tiene en curso al mismo tiempo. Las APIs de LLM suelen limitarla por clave o por plan, aparte de las solicitudes por minuto, porque cada solicitud abierta ocupa capacidad de GPU hasta que su respuesta termina.

[Guardrails (barreras de protección)](https://broadrouter.com/es/glossary/guardrails/)

Los guardrails son controles que una aplicación ejecuta alrededor de una llamada a un modelo de lenguaje para mantenerla dentro de límites definidos. Los de entrada filtran lo que entra al modelo, los de salida revisan lo que sale y los de herramientas validan las acciones antes de ejecutarlas. Un control fallido bloquea, reescribe o marca la solicitud.

[Límite de frecuencia (rate limit)](https://broadrouter.com/es/glossary/rate-limit/)

Un límite de frecuencia (rate limit) es un tope que una API impone a cuánto puede usarla un cliente en un periodo, como solicitudes por minuto o tokens por minuto. Las solicitudes que lo superan se rechazan, normalmente con HTTP 429 Too Many Requests, hasta que el uso vuelve a quedar por debajo.

[Plan de LLM con tarifa plana (flat-rate LLM plan)](https://broadrouter.com/es/glossary/flat-rate-llm-plan/)

Un plan de LLM con tarifa plana cobra un precio fijo por un periodo, como un mes, por acceder a la API de un modelo de lenguaje, en lugar de facturar por token. Estos planes suelen limitar otra cosa, como la concurrencia, la velocidad, los modelos o las ventanas de uso, así que los topes importan tanto como el precio.

## 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.

## Guías relacionadas

-   [Usar el SDK de OpenAI para Python con BroadNet Inference](https://broadrouter.com/es/guides/openai-python-sdk/)
-   [Cómo funcionan los planes de API de LLM ilimitada para agentes](https://broadrouter.com/es/guides/unlimited-llm-api-sessions/)
-   [¿Por qué un modelo de razonamiento devuelve una respuesta vacía?](https://broadrouter.com/es/guides/reasoning-tokens-empty-response/)
-   [Cómo enrutar LiteLLM a BroadNet Inference (SDK y proxy)](https://broadrouter.com/es/guides/litellm-proxy-custom-provider/)
-   [Todas las herramientas que funcionan con BroadNet Inference (en inglés)](https://broadrouter.com/integrations/): SDK, agentes de programación, interfaces de chat y herramientas de automatización, con la configuración exacta de cada una

Pruébelo con su carga de trabajo real. Las cuentas nuevas empiezan con USD 5 de crédito para Gemma y transcripción. DeepSeek, GLM y Qwen3.8 requieren una recarga.

[Comenzar](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=es-guides-openai-agents-sdk-custom-provider&utm_content=page-cta) ·

**Fuentes**

-   [Documentación del OpenAI Agents SDK, Models (proveedores distintos de OpenAI) (consultada el 2026-11-14)](https://openai.github.io/openai-agents-python/models/)
-   [PyPI, paquete openai-agents (0.24, Python 3.10+, consultado el 2026-11-14)](https://pypi.org/project/openai-agents/)
-   [Referencia de la API de BroadNet Inference (en inglés)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=es-guides-openai-agents-sdk-custom-provider&utm_content=sources)
