---
title: "OpenAI Agents SDK mit eigenem OpenAI-kompatiblem Provider"
description: "Das OpenAI Agents SDK für Python per AsyncOpenAI und OpenAIChatCompletionsModel mit BroadNet Inference nutzen und das Tracing mit OpenAI-Schlüsselpflicht abschalten."
url: https://broadrouter.com/de/guides/openai-agents-sdk-custom-provider/
lang: de
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Mit KI-Unterstützung aus dem Englischen übersetzt. [Englisches Original lesen](https://broadrouter.com/guides/openai-agents-sdk-custom-provider/) (aktualisiert am 2026-11-16).

# OpenAI Agents SDK mit BroadNet Inference betreiben

Aktualisiert 2026-11-16

Erstellen Sie einen AsyncOpenAI-Client mit base\_url https://inference.broadnet.ai/v1 und Ihrem BroadNet-Schlüssel, verpacken Sie ihn in OpenAIChatCompletionsModel mit einer Modell-ID wie broadnet/glm-5.3 und übergeben Sie dieses Modell an Ihren Agent. Rufen Sie set\_tracing\_disabled(True) auf, sofern Sie keinen separaten OpenAI-Schlüssel für das Tracing haben.

Das OpenAI Agents SDK ist ein Python-Framework für Agents mit Tools, Handoffs und Guardrails. Seine Dokumentation beschreibt, wie man Provider außerhalb von OpenAI anbindet. Für eine OpenAI-kompatible API wie BroadNet Inference übergeben Sie dem SDK Ihren eigenen `AsyncOpenAI`\-Client und verwenden die Modellklasse für Chat Completions. Standardmäßig nutzt das SDK die Responses API, die viele Anbieter nicht bereitstellen.

## Einrichtung

1.  **SDK installieren.** Es braucht Python 3.10 oder neuer.

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

2.  **Client, Modell und Agent erstellen.**

```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.  **Ausführen.** Der Agent sollte `get_order_status` aufrufen und anhand des Ergebnisses antworten.

## Drei Wege, den Provider anzubinden

Die SDK-Dokumentation nennt diese eingebauten Optionen:

-   **Pro Agent:** Übergeben Sie `OpenAIChatCompletionsModel` als `Agent.model`, wie oben. Das passt, wenn verschiedene Agents verschiedene Provider nutzen.
-   **Globaler Standard:** `set_default_openai_client(client)` macht Ihren Client zum Standard. Kombinieren Sie das mit `set_default_openai_api("chat_completions")`.
-   **Pro Lauf:** Übergeben Sie einen eigenen `ModelProvider` in `RunConfig(model_provider=...)`.

Der globale Standard sieht so aus:

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

Nur mit Umgebungsvariablen setzen Sie `OPENAI_BASE_URL=https://inference.broadnet.ai/v1` und `OPENAI_API_KEY` auf Ihren BroadNet-Schlüssel und machen dann dieselben Aufrufe von `set_default_openai_api` und `set_tracing_disabled`.

Wenn Sie über Chat Completions gehen, verwirft das SDK laut seiner Dokumentation stillschweigend Felder, die es nur in der Responses API gibt, etwa `previous_response_id`, `conversation_id` und `prompt`. Wenn Sie stattdessen einen Fehler wollen, setzen Sie `strict_feature_validation=True` auf `OpenAIProvider`. Halten Sie den Gesprächszustand in Ihrem eigenen Code, zum Beispiel indem Sie die Input-Liste des vorherigen Ergebnisses an den nächsten Lauf übergeben. Gehostete OpenAI-Tools wie Websuche und Dateisuche gibt es bei anderen Providern nicht. Verwenden Sie `function_tool` für alles, was der Agent aufrufen soll.

## Tracing

Das Tracing ist standardmäßig aktiv und sendet Traces an OpenAI. Laut SDK-Dokumentation sollten Sie es ohne API-Schlüssel von platform.openai.com mit `set_tracing_disabled()` abschalten oder einen anderen Tracing-Prozessor einrichten. Wenn Sie einen OpenAI-Schlüssel haben, können Sie das Tracing aktiv lassen und diesen Schlüssel mit `set_tracing_export_api_key(...)` übergeben. Das SDK verwendet ihn nur zum Hochladen der Traces. Ihr BroadNet-Schlüssel funktioniert dafür nicht.

## Welches Modell passt

| Agent-Typ | Modell | Hinweise |
| --- | --- | --- |
| Agents mit Tools | [GLM 5.3](https://broadrouter.com/de/models/glm-5.3/) | Tools und strukturierte Ausgabe gelistet; 1M Kontext |
| Bildeingabe mit Tools | [Qwen3.8 27B](https://broadrouter.com/de/models/qwen3.8-27b/) | 262K Kontext; auf Arabisch getestet |
| Lang laufende Agents zum Festpreis | [DeepSeek V4.1 Flash](https://broadrouter.com/de/models/deepseek-v4.1-flash/) | Unbegrenzte Pläne; Tools von BroadNet nicht gelistet |

Die SDK-Dokumentation warnt, dass manche Provider keine strukturierten Ausgaben per JSON-Schema unterstützen. Wenn Sie `output_type` an einem Agent setzen, nehmen Sie GLM 5.3 oder Qwen3.8 27B. Preise vergleichen Sie auf der [Preisseite](https://broadrouter.com/de/pricing/).

## Fehlerbehebung

-   **401.** Der BroadNet-Schlüssel ist falsch, abgelaufen oder das Pay-as-you-go-Kontingent ist aufgebraucht. Tracing-Fehler im Log sind etwas anderes: Sie bedeuten, dass das Tracing ohne OpenAI-Schlüssel noch aktiv ist.
-   **404 oder „not found“.** Wahrscheinlich nutzen Sie die Responses API. Verwenden Sie `OpenAIChatCompletionsModel` oder `set_default_openai_api("chat_completions")`. Ist das gesetzt, prüfen Sie, ob die Modell-ID exakt der von BroadNet entspricht. Kostenpflichtige Modelle erfordern eine Aufladung; das Guthaben von $5 deckt Gemma 4 VL 26B und die beiden Transcribe-Modelle ab.
-   **Leeres `final_output`.** Reasoning zählt zu `max_tokens`. Wenn Sie `ModelSettings(max_tokens=...)` setzen, erhöhen Sie den Wert. [Warum Antworten leer zurückkommen](https://broadrouter.com/de/guides/reasoning-tokens-empty-response/).
-   **429.** Ein Pay-as-you-go-Schlüssel erlaubt 30 Anfragen pro Minute und 4 gleichzeitig. Jeder Tool-Roundtrip ist eine neue Anfrage. Siehe [Fehler und Retries](https://broadrouter.com/de/guides/errors-and-retries/).
-   **Parallele Agents in einem Plan.** Eine [Session eines unbegrenzten Plans](https://broadrouter.com/de/guides/unlimited-llm-api-sessions/) verarbeitet jeweils eine Anfrage. Agents, die gemeinsam mit `asyncio.gather` gestartet werden, brauchen je eine eigene Session, sonst stehen sie in der Warteschlange. Siehe [parallele Agents zum Festpreis betreiben](https://broadrouter.com/de/blog/run-parallel-coding-agents-flat-rate/).

## Begriffe in dieser Anleitung

[Tool Calling (Function Calling)](https://broadrouter.com/de/glossary/tool-calling/)

Tool Calling, auch Function Calling genannt, ist eine Funktion von LLM-APIs, bei der das Modell eine strukturierte Anfrage zurückgibt, eine vom Entwickler definierte Funktion mit JSON-Argumenten auszuführen. Die Anwendung führt die Funktion aus und sendet das Ergebnis zurück; das Modell selbst führt nie Code aus.

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

Die Chat Completions API ist der HTTP-Endpoint von OpenAI, POST /v1/chat/completions, der einen Modellnamen und eine Liste von Nachrichten mit Rollen entgegennimmt und die nächste Nachricht des Modells zurückgibt. Ihr Format für Anfrage und Antwort wurde zum gemeinsamen Standard, den OpenAI-kompatible Anbieter und SDKs übernehmen.

[Pay-as-you-go](https://broadrouter.com/de/glossary/pay-as-you-go/)

Pay-as-you-go ist ein Preismodell, bei dem Sie nur für tatsächliche Nutzung zahlen, gemessen pro Einheit wie Tokens, Anfragen oder Audiominuten, ohne Abonnement oder Mindestabnahme. Die meisten LLM-APIs rechnen so ab, aus einem vorausbezahlten Guthaben oder per regelmäßiger Rechnung.

[Rate Limit (Ratenbegrenzung)](https://broadrouter.com/de/glossary/rate-limit/)

Ein Rate Limit ist eine Obergrenze, die eine API festlegt, wie stark ein Client sie in einem Zeitfenster nutzen darf, etwa Anfragen pro Minute oder Tokens pro Minute. Anfragen über dem Limit werden abgelehnt, meist mit HTTP 429 Too Many Requests, bis die Nutzung wieder darunter liegt.

[Concurrency (Parallelität)](https://broadrouter.com/de/glossary/concurrency/)

Concurrency (Parallelität) ist die Zahl der Anfragen, die ein Client gleichzeitig offen hat. LLM-APIs begrenzen sie oft pro Schlüssel oder Plan, getrennt von den Anfragen pro Minute, weil jede offene Anfrage GPU-Kapazität belegt, bis ihre Antwort fertig ist.

[Guardrails (Leitplanken für LLMs)](https://broadrouter.com/de/glossary/guardrails/)

Guardrails sind Prüfungen, die eine Anwendung rund um den Aufruf eines Sprachmodells ausführt, um es innerhalb festgelegter Grenzen zu halten. Input-Guardrails prüfen, was ins Modell geht, Output-Guardrails, was herauskommt, und Tool-Guardrails validieren Aktionen vor der Ausführung. Eine fehlgeschlagene Prüfung blockiert, ändert oder markiert die Anfrage.

[JSON Schema](https://broadrouter.com/de/glossary/json-schema/)

JSON Schema ist ein in JSON geschriebenes Vokabular, mit dem Sie die Struktur von JSON-Daten beschreiben und validieren: Typen, Pflichtfelder, erlaubte Werte und Verschachtelung. Die aktuelle Version ist 2020-12. LLM-APIs definieren damit Tool-Parameter und die genaue Struktur, der eine strukturierte Ausgabe folgen muss.

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

Eine OpenAI-kompatible API ist eine HTTP-API, die dieselben Anfrage- und Antwortformate wie die OpenAI API akzeptiert, etwa POST /v1/chat/completions. OpenAI-SDKs und Tools können sie deshalb nutzen, wenn nur Basis-URL, API-Schlüssel und Modellname geändert werden.

## Häufige Fragen

### Warum liefert das Agents SDK mit eigener Basis-URL 404-Fehler?

Das SDK nutzt standardmäßig die Responses API. BroadNet bietet Chat Completions. Verwenden Sie OpenAIChatCompletionsModel oder rufen Sie set\_default\_openai\_api("chat\_completions") auf, wenn Sie den Client über Umgebungsvariablen konfigurieren.

### Warum beschwert sich das Agents SDK über das Tracing?

Das Tracing lädt Daten zu OpenAI hoch und braucht einen Schlüssel von platform.openai.com. Die SDK-Dokumentation empfiehlt set\_tracing\_disabled(), wenn Sie keinen haben, oder einen anderen Tracing-Prozessor.

### Kann ich das Agents SDK nur über Umgebungsvariablen konfigurieren?

Ja. Setzen Sie OPENAI\_BASE\_URL auf https://inference.broadnet.ai/v1 und OPENAI\_API\_KEY auf Ihren BroadNet-Schlüssel und rufen Sie dann set\_default\_openai\_api("chat\_completions") und set\_tracing\_disabled(True) auf. OPENAI\_DEFAULT\_MODEL legt das Modell für Agents fest, die keines nennen.

### Wie viele Plan-Sessions braucht ein Lauf mit mehreren Agents?

Eine pro gleichzeitig laufender Anfrage. Handoffs führen einen Agent nach dem anderen aus, daher reicht eine Session. Agents, die mit asyncio.gather parallel laufen, brauchen je eine eigene Session.

## Verwandte Anleitungen

-   [OpenAI Python SDK mit BroadNet Inference nutzen](https://broadrouter.com/de/guides/openai-python-sdk/)
-   [So funktionieren die unbegrenzten LLM-API-Pläne für Agenten](https://broadrouter.com/de/guides/unlimited-llm-api-sessions/)
-   [Warum ein Reasoning-Modell eine leere Antwort liefert](https://broadrouter.com/de/guides/reasoning-tokens-empty-response/)
-   [LiteLLM an BroadNet Inference anbinden (SDK und Proxy)](https://broadrouter.com/de/guides/litellm-proxy-custom-provider/)
-   [Alle Tools, die mit BroadNet Inference funktionieren (auf Englisch)](https://broadrouter.com/integrations/): SDKs, Coding-Agenten, Chat-Oberflächen und Automatisierungstools, jeweils mit den genauen Einstellungen

Testen Sie es mit Ihrem echten Workload. Neue Konten starten mit USD 5 Guthaben für Gemma und Transkription. DeepSeek, GLM und Qwen3.8 erfordern eine Aufladung.

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

**Quellen**

-   [Dokumentation des OpenAI Agents SDK, Models (Nicht-OpenAI-Provider) (geprüft am 2026-11-14)](https://openai.github.io/openai-agents-python/models/)
-   [PyPI, Paket openai-agents (0.24, Python 3.10+, geprüft am 2026-11-14)](https://pypi.org/project/openai-agents/)
-   [API-Referenz von BroadNet Inference (auf Englisch)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=de-guides-openai-agents-sdk-custom-provider&utm_content=sources)
