---
title: "OpenAI Agents SDK con un provider compatibile con OpenAI"
description: "Usa l’OpenAI Agents SDK per Python con BroadNet Inference tramite AsyncOpenAI e OpenAIChatCompletionsModel, e disattiva il tracing che richiede una chiave OpenAI."
url: https://broadrouter.com/it/guides/openai-agents-sdk-custom-provider/
lang: it
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Tradotto dall’inglese con l’aiuto dell’IA. [Leggi l’originale in inglese](https://broadrouter.com/guides/openai-agents-sdk-custom-provider/) (aggiornato il 2026-11-16).

# Usare l’OpenAI Agents SDK con BroadNet Inference

Aggiornato 2026-11-16

Crea un client AsyncOpenAI con base\_url https://inference.broadnet.ai/v1 e la tua chiave BroadNet, avvolgilo in OpenAIChatCompletionsModel con un ID di modello come broadnet/glm-5.3 e passa quel modello al tuo Agent. Chiama set\_tracing\_disabled(True), a meno che tu non abbia una chiave OpenAI separata per il tracing.

L’OpenAI Agents SDK è un framework Python per agenti con strumenti, handoff e guardrail. La sua documentazione spiega come collegare provider diversi da OpenAI. Per un’API compatibile con OpenAI come BroadNet Inference, passi all’SDK il tuo client `AsyncOpenAI` e usi la classe di modello per Chat Completions. L’SDK usa di default la Responses API, che molti provider non servono.

## Configurazione

1.  **Installa l’SDK.** Richiede Python 3.10 o successivo.

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

2.  **Crea il client, il modello e l’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.  **Eseguilo.** L’agente dovrebbe chiamare `get_order_status` e rispondere in base al risultato.

## Tre modi per collegare il provider

La documentazione dell’SDK elenca queste opzioni integrate:

-   **Per agente:** passa `OpenAIChatCompletionsModel` come `Agent.model`, come sopra. Usalo quando agenti diversi usano provider diversi.
-   **Default globale:** `set_default_openai_client(client)` rende il tuo client quello predefinito. Abbinalo a `set_default_openai_api("chat_completions")`.
-   **Per esecuzione:** passa un `ModelProvider` personalizzato in `RunConfig(model_provider=...)`.

Il default globale ha questo aspetto:

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

Con le sole variabili d’ambiente, imposta `OPENAI_BASE_URL=https://inference.broadnet.ai/v1` e `OPENAI_API_KEY` con la tua chiave BroadNet, poi fai le stesse chiamate a `set_default_openai_api` e `set_tracing_disabled`.

Quando passi per Chat Completions, secondo la documentazione dell’SDK i campi che esistono solo nella Responses API, come `previous_response_id`, `conversation_id` e `prompt`, vengono scartati senza avviso. Per ottenere invece un errore, imposta `strict_feature_validation=True` su `OpenAIProvider`. Gestisci lo stato della conversazione nel tuo codice, per esempio passando la lista di input del risultato precedente all’esecuzione successiva. Gli strumenti ospitati da OpenAI, come web search e file search, non esistono sugli altri provider. Usa `function_tool` per tutto ciò che l’agente deve chiamare.

## Tracing

Il tracing è attivo di default e invia le tracce a OpenAI. La documentazione dell’SDK dice che, senza una chiave API di platform.openai.com, devi disattivarlo con `set_tracing_disabled()` o configurare un altro processore di tracing. Se hai una chiave OpenAI, puoi lasciare attivo il tracing e passarla con `set_tracing_export_api_key(...)`. L’SDK la usa solo per caricare le tracce. La tua chiave BroadNet non funziona a questo scopo.

## Quale modello scegliere

| Tipo di agente | Modello | Note |
| --- | --- | --- |
| Agenti che usano strumenti | [GLM 5.3](https://broadrouter.com/it/models/glm-5.3/) | Strumenti e output strutturato indicati; contesto da 1M |
| Input di immagini con strumenti | [Qwen3.8 27B](https://broadrouter.com/it/models/qwen3.8-27b/) | Contesto da 262K; testato in arabo |
| Agenti di lunga durata a tariffa fissa | [DeepSeek V4.1 Flash](https://broadrouter.com/it/models/deepseek-v4.1-flash/) | Piani illimitati; strumenti non indicati da BroadNet |

La documentazione dell’SDK avverte che alcuni provider non supportano gli output strutturati con JSON schema. Se imposti `output_type` su un agente, usa GLM 5.3 o Qwen3.8 27B. Confronta i prezzi nella [pagina dei prezzi](https://broadrouter.com/it/pricing/).

## Risoluzione dei problemi

-   **401.** La chiave BroadNet è sbagliata, scaduta o ha esaurito la quota a consumo. Gli errori di tracing nei log sono un’altra cosa: indicano che il tracing è ancora attivo senza una chiave OpenAI.
-   **404 o “not found”.** Probabilmente stai usando la Responses API. Usa `OpenAIChatCompletionsModel` o `set_default_openai_api("chat_completions")`. Se è già impostato, verifica che l’ID del modello corrisponda esattamente a quello di BroadNet. I modelli a pagamento richiedono una ricarica; il credito di $5 copre Gemma 4 VL 26B e i due modelli Transcribe.
-   **`final_output` vuoto.** Il ragionamento conta in `max_tokens`. Se imposti `ModelSettings(max_tokens=...)`, alzalo. [Perché le risposte arrivano vuote](https://broadrouter.com/it/guides/reasoning-tokens-empty-response/).
-   **429.** Una chiave a consumo consente 30 richieste al minuto e 4 contemporanee. Ogni giro di chiamata a uno strumento è una nuova richiesta. Vedi [errori e nuovi tentativi](https://broadrouter.com/it/guides/errors-and-retries/).
-   **Agenti paralleli su un piano.** Una [sessione del piano illimitato](https://broadrouter.com/it/guides/unlimited-llm-api-sessions/) esegue una richiesta alla volta. Gli agenti avviati insieme con `asyncio.gather` richiedono una sessione ciascuno, altrimenti finiscono in coda. Vedi [agenti in parallelo a tariffa fissa](https://broadrouter.com/it/blog/run-parallel-coding-agents-flat-rate/).

## Termini in questa guida

[Tool calling (chiamata di strumenti)](https://broadrouter.com/it/glossary/tool-calling/)

Il tool calling, detto anche function calling, è una funzionalità delle API LLM in cui il modello restituisce una richiesta strutturata di eseguire una funzione definita dallo sviluppatore, con argomenti JSON. L’applicazione esegue la funzione e rimanda il risultato; il modello non esegue mai codice da solo.

[Pagamento a consumo (pay-as-you-go)](https://broadrouter.com/it/glossary/pay-as-you-go/)

Il pagamento a consumo è un modello di prezzo in cui paghi solo ciò che usi, misurato per unità come token, richieste o minuti di audio, senza abbonamento né impegno minimo. La maggior parte delle API LLM fattura così, da un saldo prepagato o con una fattura periodica.

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

La Chat Completions API è l’endpoint HTTP di OpenAI, POST /v1/chat/completions, che riceve il nome di un modello e una lista di messaggi con un ruolo e restituisce il messaggio successivo del modello. La forma della sua richiesta e risposta è diventata il formato comune che riusano provider e SDK compatibili con OpenAI.

[Concorrenza (concurrency)](https://broadrouter.com/it/glossary/concurrency/)

La concorrenza è il numero di richieste che un client ha in corso nello stesso momento. Le API LLM spesso la limitano per chiave o per piano, separatamente dalle richieste al minuto, perché ogni richiesta aperta occupa capacità GPU finché la sua risposta non è terminata.

[Rate limit (limite di frequenza)](https://broadrouter.com/it/glossary/rate-limit/)

Un rate limit è un tetto che un’API pone a quanto un client può usarla in un intervallo di tempo, per esempio richieste al minuto o token al minuto. Le richieste oltre il limite vengono rifiutate, di solito con HTTP 429 Too Many Requests, finché l’uso non torna sotto la soglia.

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

Un’API compatibile con OpenAI è un’API HTTP che accetta gli stessi formati di richiesta e di risposta dell’API di OpenAI, come POST /v1/chat/completions, così SDK e strumenti di OpenAI possono usarla cambiando solo base URL, chiave API e nome del modello.

[Chiave API (API key)](https://broadrouter.com/it/glossary/api-key/)

Una chiave API è una stringa segreta che identifica e autorizza un client che chiama un’API. Le API LLM di solito la vogliono in un header Authorization: Bearer, e chiunque possieda la chiave può fare richieste fatturate all’account a cui appartiene.

[Credito prepagato (prepaid credit)](https://broadrouter.com/it/glossary/prepaid-credit/)

Il credito prepagato è denaro aggiunto a un account API prima dell’uso. Ogni richiesta scala il proprio costo dal saldo e, quando il saldo si esaurisce, le richieste a consumo si fermano finché non ricarichi. Limita la spesa a quanto hai versato.

## Domande frequenti

### Perché l’Agents SDK mi restituisce errori 404 con una base URL personalizzata?

L’SDK usa per impostazione predefinita la Responses API, mentre BroadNet serve chat completions. Usa OpenAIChatCompletionsModel, oppure chiama set\_default\_openai\_api("chat\_completions") se configuri il client tramite variabili d’ambiente.

### Perché l’Agents SDK segnala errori sul tracing?

Il tracing carica i dati su OpenAI e richiede una chiave di platform.openai.com. La documentazione dell’SDK consiglia set\_tracing\_disabled() se non ne hai una, oppure un altro processore di tracing.

### Posso configurare l’Agents SDK solo con le variabili d’ambiente?

Sì. Imposta OPENAI\_BASE\_URL su https://inference.broadnet.ai/v1 e OPENAI\_API\_KEY con la tua chiave BroadNet, poi chiama set\_default\_openai\_api("chat\_completions") e set\_tracing\_disabled(True). OPENAI\_DEFAULT\_MODEL imposta il modello per gli agenti che non ne indicano uno.

### Quante sessioni del piano servono per un’esecuzione multi-agente?

Una per ogni richiesta eseguita contemporaneamente. Gli handoff eseguono un agente dopo l’altro, quindi basta una sessione. Gli agenti eseguiti in parallelo con asyncio.gather richiedono una sessione ciascuno.

## Guide correlate

-   [Usare l’SDK Python di OpenAI con BroadNet Inference](https://broadrouter.com/it/guides/openai-python-sdk/)
-   [Come funzionano i piani API LLM illimitati per gli agenti](https://broadrouter.com/it/guides/unlimited-llm-api-sessions/)
-   [Perché un modello di ragionamento restituisce una risposta vuota](https://broadrouter.com/it/guides/reasoning-tokens-empty-response/)
-   [Instradare LiteLLM verso BroadNet Inference (SDK e proxy)](https://broadrouter.com/it/guides/litellm-proxy-custom-provider/)
-   [Tutti gli strumenti che funzionano con BroadNet Inference (in inglese)](https://broadrouter.com/integrations/): SDK, agenti di coding, interfacce di chat e strumenti di automazione, con le impostazioni esatte per ciascuno

Provalo sul tuo carico di lavoro reale. I nuovi account partono con USD 5 di credito per Gemma e trascrizione. DeepSeek, GLM e Qwen3.8 richiedono una ricarica.

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

**Fonti**

-   [Documentazione dell’OpenAI Agents SDK, Models (provider diversi da OpenAI) (verificata il 2026-11-14)](https://openai.github.io/openai-agents-python/models/)
-   [PyPI, pacchetto openai-agents (0.24, Python 3.10+, verificato il 2026-11-14)](https://pypi.org/project/openai-agents/)
-   [Riferimento API di BroadNet Inference (in inglese)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-guides-openai-agents-sdk-custom-provider&utm_content=sources)
