---
title: "OpenAI Agents SDK avec un fournisseur compatible OpenAI"
description: "Utilisez l’OpenAI Agents SDK pour Python avec BroadNet Inference via AsyncOpenAI et OpenAIChatCompletionsModel, et coupez le tracing qui exige une clé OpenAI."
url: https://broadrouter.com/fr/guides/openai-agents-sdk-custom-provider/
lang: fr
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Traduit de l’anglais avec l’aide de l’IA. [Lire l’original en anglais](https://broadrouter.com/guides/openai-agents-sdk-custom-provider/) (mis à jour le 2026-11-16).

# Faire tourner l’OpenAI Agents SDK sur BroadNet Inference

Mis à jour 2026-11-16

Créez un client AsyncOpenAI avec base\_url https://inference.broadnet.ai/v1 et votre clé BroadNet, encapsulez-le dans OpenAIChatCompletionsModel avec un ID de modèle comme broadnet/glm-5.3, puis passez ce modèle à votre Agent. Appelez set\_tracing\_disabled(True), sauf si vous disposez d’une clé OpenAI distincte pour le tracing.

L’OpenAI Agents SDK est un framework Python pour créer des agents avec outils, handoffs et guardrails. Sa documentation explique comment brancher des fournisseurs autres qu’OpenAI. Pour une API compatible OpenAI comme BroadNet Inference, vous donnez au SDK votre propre client `AsyncOpenAI` et utilisez la classe de modèle Chat Completions. Par défaut, le SDK passe par la Responses API, que beaucoup de fournisseurs ne servent pas.

## Mise en place

1.  **Installez le SDK.** Il nécessite Python 3.10 ou plus récent.

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

2.  **Créez le client, le modèle et l’agent.**

```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.  **Lancez-le.** L’agent doit appeler `get_order_status` et répondre à partir de son résultat.

## Trois façons de brancher le fournisseur

La documentation du SDK cite ces options intégrées :

-   **Par agent :** passez `OpenAIChatCompletionsModel` comme `Agent.model`, comme ci-dessus. À utiliser quand des agents différents passent par des fournisseurs différents.
-   **Par défaut, globalement :** `set_default_openai_client(client)` fait de votre client le client par défaut. Associez-le à `set_default_openai_api("chat_completions")`.
-   **Par run :** passez un `ModelProvider` personnalisé dans `RunConfig(model_provider=...)`.

La variante globale ressemble à ceci :

```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")
```

Avec les seules variables d’environnement, définissez `OPENAI_BASE_URL=https://inference.broadnet.ai/v1` et `OPENAI_API_KEY` sur votre clé BroadNet, puis faites les mêmes appels à `set_default_openai_api` et `set_tracing_disabled`.

Quand vous passez par Chat Completions, la documentation du SDK indique qu’il ignore silencieusement les champs propres à la Responses API, comme `previous_response_id`, `conversation_id` et `prompt`. Pour obtenir une erreur à la place, définissez `strict_feature_validation=True` sur `OpenAIProvider`. Gérez l’état de la conversation dans votre propre code, par exemple en passant la liste d’entrées du résultat précédent au run suivant. Les outils hébergés d’OpenAI, comme la recherche web et la recherche de fichiers, n’existent pas chez les autres fournisseurs. Utilisez `function_tool` pour tout ce que l’agent doit appeler.

## Tracing

Le tracing est activé par défaut et envoie les traces à OpenAI. La documentation du SDK indique que, sans clé d’API de platform.openai.com, il faut le désactiver avec `set_tracing_disabled()` ou configurer un autre processeur de tracing. Si vous avez une clé OpenAI, vous pouvez laisser le tracing actif et passer cette clé avec `set_tracing_export_api_key(...)`. Le SDK ne l’utilise que pour envoyer les traces. Votre clé BroadNet ne fonctionne pas pour cela.

## Quel modèle choisir ?

| Type d’agent | Modèle | Remarques |
| --- | --- | --- |
| Agents avec outils | [GLM 5.3](https://broadrouter.com/fr/models/glm-5.3/) | Outils et sortie structurée indiqués ; contexte de 1M |
| Entrée image avec outils | [Qwen3.8 27B](https://broadrouter.com/fr/models/qwen3.8-27b/) | Contexte de 262K ; testé en arabe |
| Agents de longue durée à prix forfaitaire | [DeepSeek V4.1 Flash](https://broadrouter.com/fr/models/deepseek-v4.1-flash/) | Forfaits illimités ; outils non indiqués par BroadNet |

La documentation du SDK prévient que certains fournisseurs ne prennent pas en charge les sorties structurées par schéma JSON. Si vous définissez `output_type` sur un agent, utilisez GLM 5.3 ou Qwen3.8 27B. Comparez les prix sur la [page des tarifs](https://broadrouter.com/fr/pricing/).

## Dépannage

-   **401.** La clé BroadNet est erronée, expirée ou son quota de paiement à l’usage est épuisé. Les erreurs de tracing dans les logs sont un autre problème : elles signifient que le tracing est encore actif sans clé OpenAI.
-   **404 ou « not found ».** Vous passez probablement par la Responses API. Utilisez `OpenAIChatCompletionsModel` ou `set_default_openai_api("chat_completions")`. Si c’est déjà fait, vérifiez que l’ID du modèle correspond exactement à celui de BroadNet. Les modèles payants nécessitent une recharge ; le crédit de $5 couvre Gemma 4 VL 26B et les deux modèles Transcribe.
-   **`final_output` vide.** Le raisonnement est décompté de `max_tokens`. Si vous définissez `ModelSettings(max_tokens=...)`, augmentez la valeur. [Pourquoi les réponses reviennent vides](https://broadrouter.com/fr/guides/reasoning-tokens-empty-response/).
-   **429.** Une clé à l’usage autorise 30 requêtes par minute et 4 simultanées. Chaque aller-retour d’outil est une nouvelle requête. Voir [codes d’erreur et nouvelles tentatives](https://broadrouter.com/fr/guides/errors-and-retries/).
-   **Agents parallèles sur un forfait.** Une [session de forfait illimité](https://broadrouter.com/fr/guides/unlimited-llm-api-sessions/) traite une requête à la fois. Des agents lancés ensemble avec `asyncio.gather` nécessitent chacun une session, sinon ils font la queue. Voir [faire tourner des agents en parallèle à prix forfaitaire](https://broadrouter.com/fr/blog/run-parallel-coding-agents-flat-rate/).

## Termes de ce guide

[Appel d’outils (tool calling, function calling)](https://broadrouter.com/fr/glossary/tool-calling/)

L’appel d’outils, aussi appelé function calling, est une fonctionnalité des API LLM dans laquelle le modèle renvoie une demande structurée d’exécution d’une fonction définie par le développeur, avec des arguments JSON. L’application exécute la fonction et renvoie le résultat ; le modèle n’exécute jamais de code lui-même.

[Paiement à l’usage (pay-as-you-go)](https://broadrouter.com/fr/glossary/pay-as-you-go/)

Le paiement à l’usage (pay-as-you-go) est un modèle tarifaire où vous ne payez que ce que vous consommez, mesuré par unité, comme les tokens, les requêtes ou les minutes d’audio, sans abonnement ni engagement minimal. La plupart des API LLM facturent ainsi, à partir d’un solde prépayé ou d’une facture périodique.

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

L’API Chat Completions est l’endpoint HTTP d’OpenAI, POST /v1/chat/completions, qui reçoit un nom de modèle et une liste de messages associés à un rôle, et renvoie le message suivant du modèle. Sa forme de requête et de réponse est devenue le format commun que reprennent les fournisseurs et SDK compatibles OpenAI.

[API compatible OpenAI](https://broadrouter.com/fr/glossary/openai-compatible-api/)

Une API compatible OpenAI est une API HTTP qui accepte les mêmes formats de requête et de réponse que l’API OpenAI, comme POST /v1/chat/completions. Les SDK et outils OpenAI peuvent donc l’utiliser en changeant seulement l’URL de base, la clé d’API et le nom du modèle.

[Concurrence (requêtes simultanées)](https://broadrouter.com/fr/glossary/concurrency/)

La concurrence est le nombre de requêtes qu’un client a en cours au même moment. Les API de LLM la plafonnent souvent par clé ou par forfait, indépendamment des requêtes par minute, car chaque requête ouverte occupe de la capacité GPU jusqu’à la fin de sa réponse.

[Guardrails (garde-fous pour LLM)](https://broadrouter.com/fr/glossary/guardrails/)

Les guardrails sont des contrôles qu’une application exécute autour d’un appel à un modèle de langage pour le maintenir dans des limites définies. Ceux d’entrée filtrent ce qui entre dans le modèle, ceux de sortie vérifient ce qui en sort, et ceux d’outils valident les actions avant leur exécution. Un contrôle échoué bloque, réécrit ou signale la requête.

[Limite de débit (rate limit)](https://broadrouter.com/fr/glossary/rate-limit/)

Une limite de débit (rate limit) est un plafond qu’une API impose à l’usage d’un client sur une période, par exemple en requêtes ou en tokens par minute. Les requêtes au-delà sont refusées, généralement avec HTTP 429 Too Many Requests, jusqu’à ce que l’usage repasse sous la limite.

[Sortie structurée (structured output)](https://broadrouter.com/fr/glossary/structured-output/)

La sortie structurée est une fonction des API LLM qui contraint la réponse d’un modèle à un format défini par le développeur, en général un JSON Schema, pour que le code puisse l’analyser de façon fiable. Elle est plus stricte que le mode JSON, qui garantit un JSON valide mais pas une structure précise.

## Questions fréquentes

### Pourquoi l’Agents SDK renvoie-t-il des erreurs 404 avec une URL de base personnalisée ?

Le SDK utilise la Responses API par défaut. BroadNet sert les chat completions. Utilisez OpenAIChatCompletionsModel, ou appelez set\_default\_openai\_api("chat\_completions") si vous configurez le client par variables d’environnement.

### Pourquoi l’Agents SDK se plaint-il du tracing ?

Le tracing envoie les données à OpenAI et nécessite une clé de platform.openai.com. La documentation du SDK recommande set\_tracing\_disabled() si vous n’en avez pas, ou un autre processeur de tracing.

### Puis-je configurer l’Agents SDK uniquement avec des variables d’environnement ?

Oui. Définissez OPENAI\_BASE\_URL sur https://inference.broadnet.ai/v1 et OPENAI\_API\_KEY sur votre clé BroadNet, puis appelez set\_default\_openai\_api("chat\_completions") et set\_tracing\_disabled(True). OPENAI\_DEFAULT\_MODEL fixe le modèle des agents qui n’en nomment aucun.

### Combien de sessions de forfait faut-il pour un run multi-agents ?

Une par requête exécutée en même temps. Les handoffs exécutent les agents l’un après l’autre, une session suffit donc. Des agents lancés en parallèle avec asyncio.gather nécessitent chacun une session.

## Guides associés

-   [Utiliser le SDK Python d’OpenAI avec BroadNet Inference](https://broadrouter.com/fr/guides/openai-python-sdk/)
-   [Comment fonctionnent les forfaits API LLM illimités pour agents](https://broadrouter.com/fr/guides/unlimited-llm-api-sessions/)
-   [Pourquoi un modèle de raisonnement renvoie une réponse vide](https://broadrouter.com/fr/guides/reasoning-tokens-empty-response/)
-   [Router LiteLLM vers BroadNet Inference (SDK et proxy)](https://broadrouter.com/fr/guides/litellm-proxy-custom-provider/)
-   [Tous les outils compatibles avec BroadNet Inference (en anglais)](https://broadrouter.com/integrations/) : SDK, agents de code, interfaces de chat et outils d’automatisation, avec les réglages exacts pour chacun

Essayez-le sur votre vraie charge de travail. Les nouveaux comptes démarrent avec USD 5 de crédit pour Gemma et transcription. DeepSeek, GLM et Qwen3.8 nécessitent une recharge.

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

**Sources**

-   [Documentation de l’OpenAI Agents SDK, Models (fournisseurs autres qu’OpenAI) (consulté le 2026-11-14)](https://openai.github.io/openai-agents-python/models/)
-   [PyPI, paquet openai-agents (0.24, Python 3.10+, consulté le 2026-11-14)](https://pypi.org/project/openai-agents/)
-   [Référence de l’API de BroadNet Inference (en anglais)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=fr-guides-openai-agents-sdk-custom-provider&utm_content=sources)
