---
title: "smolagents OpenAIModel con api_base personalizzato | BroadRouter"
description: "Collega smolagents di Hugging Face a BroadNet Inference con OpenAIModel e api_base: CodeAgent su qualsiasi modello, ToolCallingAgent su GLM 5.3 e Qwen3.8 27B."
url: https://broadrouter.com/it/guides/smolagents-openai-compatible/
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/smolagents-openai-compatible/) (aggiornato il 2026-11-16).

# Usare smolagents su BroadNet Inference con OpenAIModel

Aggiornato 2026-11-16

Crea l’OpenAIModel di smolagents con model\_id impostato su un ID BroadNet come broadnet/glm-5.3, api\_base su https://inference.broadnet.ai/v1 e api\_key sulla tua chiave BroadNet, poi passalo a CodeAgent o ToolCallingAgent. CodeAgent scrive Python invece di usare le tool call native, quindi gira anche su DeepSeek V4.1 Flash. ToolCallingAgent richiede GLM 5.3 o Qwen3.8 27B.

smolagents è la piccola libreria Python di Hugging Face per gli agenti. La sua classe `OpenAIModel` “connects to an OpenAI-compatible API server” (traduzione: si collega a un server API compatibile con OpenAI), con `api_base` per l’URL. BroadNet Inference serve chat completions su `https://inference.broadnet.ai/v1`, quindi funziona direttamente. BroadRouter è il sito di BroadNet; questa guida segue la documentazione di smolagents 1.26.0.

## Installazione

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

## CodeAgent

```python
import os
from smolagents import OpenAIModel, CodeAgent

model = OpenAIModel(
    model_id="broadnet/deepseek-v4.1-flash",
    api_base="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
    max_tokens=4000,
)

agent = CodeAgent(tools=[], model=model)
print(agent.run("What is 6 * 7? Use Python to check."))
```

`CodeAgent` chiede al modello di scrivere Python tra tag `<code>` e lo esegue in locale. La richiesta è una normale chat completion con stop sequence come `</code>` e senza campo `tools`. Quindi non dipende dal tool calling nativo e può girare su `broadnet/deepseek-v4.1-flash`, il modello dei [piani illimitati](https://broadrouter.com/it/guides/unlimited-llm-api-sessions/) di BroadNet. La qualità del codice cambia comunque da modello a modello, quindi prova i tuoi task.

CodeAgent esegue codice scritto dal modello. Leggi le indicazioni di smolagents sull’esecuzione sicura del codice prima di dargli strumenti che toccano file, rete o credenziali.

## ToolCallingAgent

```python
from smolagents import ToolCallingAgent, tool

@tool
def get_weather(city: str) -> str:
    """Get the weather for a city.

    Args:
        city: The city name.
    """
    return f"21C in {city}"

model = OpenAIModel(
    model_id="broadnet/glm-5.3",
    api_base="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
    max_tokens=4000,
)
agent = ToolCallingAgent(tools=[get_weather], model=model)
print(agent.run("What's the weather in Riyadh?"))
```

`ToolCallingAgent` invia i tuoi strumenti, più il suo strumento `final_answer`, come schemi di funzione con `tool_choice: "required"`. Usa `broadnet/glm-5.3` o `broadnet/qwen3.8-27b`: la documentazione di BroadNet indica gli strumenti solo per questi due modelli.

## Quale modello scegliere

| Agente | Modello |
| --- | --- |
| `CodeAgent`, esecuzioni lunghe con un piano a prezzo fisso | `broadnet/deepseek-v4.1-flash` |
| `ToolCallingAgent` | `broadnet/glm-5.3` |
| Entrambi gli agenti con input di immagini | `broadnet/qwen3.8-27b` |

Una sessione del piano esegue una richiesta alla volta, e un agente invia i suoi passi uno dopo l’altro, quindi una sessione basta per un agente. [Prezzi di tutti i modelli](https://broadrouter.com/it/pricing/).

## Come l’abbiamo testato

Il 2026-11-15 abbiamo installato smolagents 1.26.0 in un ambiente virtuale pulito e abbiamo eseguito entrambi gli agenti contro un server mock locale che parla il formato di chat completions di BroadNet. Il `CodeAgent` sull’ID DeepSeek ha ricevuto una risposta con codice, l’ha eseguito e ha restituito 42. Le sue richieste avevano `max_tokens: 4000`, le stop sequence e nessun tool. Per il `ToolCallingAgent` abbiamo controllato la forma della richiesta: l’ID del modello è stato inviato invariato, con entrambi gli schemi degli strumenti e `tool_choice: "required"`. smolagents rimanda i risultati degli strumenti come messaggi user. Il nostro mock non seguiva quel formato, quindi non abbiamo portato quell’agente fino alla risposta finale. Non avevamo una chiave BroadNet, quindi non abbiamo testato l’output reale del modello.

## Risoluzione dei problemi

-   **401.** La chiave è sbagliata, scaduta o ha esaurito la quota.
-   **404.** `api_base` deve finire con `/v1`. Controlla l’ID del modello. I modelli a pagamento richiedono una ricarica; il credito di $5 copre solo `broadnet/gemma-4-26b-a4b` e i due modelli Transcribe.
-   **“Make sure to provide correct code blobs”.** La risposta del modello non conteneva un blocco di codice. Alza `max_tokens`, perché il ragionamento conta in quel limite, oppure prova un altro modello. [Perché le risposte arrivano vuote](https://broadrouter.com/it/guides/reasoning-tokens-empty-response/).
-   **ToolCallingAgent non finisce mai.** Passa a `broadnet/glm-5.3` o `broadnet/qwen3.8-27b`.
-   **429.** Una chiave a consumo consente 30 richieste al minuto. smolagents può limitarsi da solo con `requests_per_minute`. Vedi [errori e retry](https://broadrouter.com/it/guides/errors-and-retries/).

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

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

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

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

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

[Sequenze di stop (stop sequences)](https://broadrouter.com/it/glossary/stop-sequences/)

Le sequenze di stop sono stringhe che invii con una richiesta e che fanno smettere il modello di generare appena ne produce una. OpenAI chiama il campo stop e accetta fino a 4 sequenze; Anthropic lo chiama stop\_sequences. Di norma il testo trovato non compare nell’output restituito.

[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

### Si usa OpenAIModel o OpenAIServerModel?

smolagents 1.26 documenta OpenAIModel per qualsiasi server compatibile con OpenAI. Il pacchetto esporta ancora OpenAIServerModel, ma la documentazione descrive OpenAIModel.

### smolagents funziona con il piano illimitato di BroadNet?

I piani coprono DeepSeek V4.1 Flash. BroadNet non indica il tool calling per quel modello, ma CodeAgent non ha bisogno di tool call native: chiede al modello codice Python. Nel nostro test con un server mock, un CodeAgent sull’ID DeepSeek ha inviato normali richieste di chat senza campo tools.

### Perché ToolCallingAgent richiede GLM 5.3 o Qwen3.8 27B?

Invia gli strumenti come schemi di funzione OpenAI con tool\_choice impostato su required. La documentazione di BroadNet indica gli strumenti solo per GLM 5.3 e Qwen3.8 27B.

### Come passo max\_tokens o temperature?

Come argomenti keyword di OpenAIModel. La documentazione di smolagents dice che gli argomenti in più vengono inoltrati a ogni chiamata di completion. Nel nostro test max\_tokens=4000 è stato inviato a ogni richiesta.

## 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/)
-   [Codici di errore di BroadNet Inference e quando ritentare](https://broadrouter.com/it/guides/errors-and-retries/)
-   [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-smolagents-openai-compatible&utm_content=page-cta) ·

**Fonti**

-   [Documentazione di smolagents v1.26.0, riferimento Models (OpenAIModel) (verificata il 2026-11-15)](https://huggingface.co/docs/smolagents/reference/models)
-   [PyPI, smolagents 1.26.0 (verificato il 2026-11-15)](https://pypi.org/project/smolagents/)
-   [Riferimento API di BroadNet Inference (verificato il 2026-11-15) (in inglese)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-guides-smolagents-openai-compatible&utm_content=sources)
