---
title: "CrewAI: base_url personalizzato compatibile con OpenAI"
description: "Collega gli agenti CrewAI a BroadNet Inference con LLM(custom_openai=True, base_url=...), poi scegli i modelli per strumenti, contesto lungo e piano flat."
url: https://broadrouter.com/it/guides/crewai-custom-openai-endpoint/
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/crewai-custom-openai-endpoint/) (aggiornato il 2026-11-16).

# CrewAI con BroadNet Inference come endpoint OpenAI personalizzato

Aggiornato 2026-11-16

Crea il modello con la classe LLM di crewai, passando model con un ID BroadNet come broadnet/glm-5.3, custom\_openai=True, base\_url impostato su https://inference.broadnet.ai/v1 e api\_key con la tua chiave BroadNet. Poi assegna quell’LLM a ogni Agent. CrewAI usa il suo client OpenAI nativo e chat completions, quindi non serve installare LiteLLM.

CrewAI è un framework Python per squadre di agenti. La sua documentazione mostra uno schema di **endpoint personalizzato compatibile con OpenAI**: un `LLM` con `custom_openai=True` e un `base_url`. BroadNet Inference serve chat completions standard su `https://inference.broadnet.ai/v1`, quindi si collega proprio lì. BroadRouter è il sito di BroadNet; questa guida segue la documentazione e il codice sorgente di CrewAI alla versione 1.15.41.

## Installazione

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

## Connessione

```python
import os
from crewai import LLM, Agent

llm = LLM(
    model="broadnet/glm-5.3",
    custom_openai=True,
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
    max_tokens=4000,  # reasoning counts toward this limit
)

# Quick test: one call straight to the model
print(llm.call("Say hello in five words."))

analyst = Agent(
    role="Analyst",
    goal="Summarize incidents",
    backstory="You write short incident summaries.",
    llm=llm,
)
print(analyst.kickoff("Summarize: the API returned 503 for four minutes after a deploy."))
```

Se `llm.call` stampa una risposta, chiave, URL e ID del modello sono corretti.

## Come CrewAI instrada la richiesta

Il codice sorgente di CrewAI stabilisce un ordine: `custom_openai=True` viene prima di tutto e forza il provider OpenAI nativo, scavalcando qualunque cosa suggerisca il nome del modello. Solleva anche un errore se non è impostato un endpoint personalizzato tramite `base_url`, `api_base`, `OPENAI_BASE_URL` o `OPENAI_API_BASE`. La stringa del modello viene inviata così com’è, quindi `broadnet/glm-5.3` arriva a BroadNet invariato.

Senza `custom_openai`, un nome come `broadnet/glm-5.3` verrebbe letto come provider `broadnet`, che CrewAI non conosce, e si ripiegherebbe su LiteLLM. L’alternativa documentata è `model="openai/broadnet/glm-5.3"` con un `base_url`: CrewAI rimuove il prefisso `openai/` e invia il resto.

Altre due cose dal codice e dalla documentazione di CrewAI:

-   **Campo del limite di token.** Se passi `max_tokens`, il client nativo invia `max_tokens` su chat completions, il campo descritto dal riferimento API di BroadNet. Se passi `max_completion_tokens`, viene inviato quello.
-   **Resta su chat completions.** La documentazione di CrewAI mostra `api="responses"` per passare alla Responses API. Non impostarlo: BroadNet non indica quell’API.

## Quale modello per quale agente

| Agente | Modello | Perché |
| --- | --- | --- |
| Agenti con strumenti | `broadnet/glm-5.3` | BroadNet indica strumenti e output strutturato; contesto da 1M |
| Input di immagini o in arabo, con strumenti | `broadnet/qwen3.8-27b` | Strumenti più immagini; contesto da 262K |
| Letture lunghe, piano flat | `broadnet/deepseek-v4.1-flash` | Piani illimitati; strumenti non indicati da BroadNet |

Una crew può combinarli: dai a ogni `Agent` il suo `LLM`.

## Risoluzione dei problemi

-   **401.** La chiave è sbagliata, scaduta o senza più quota. Se hai omesso `api_key`, CrewAI ha letto `OPENAI_API_KEY`, che potrebbe contenere una chiave OpenAI.
-   **“custom\_openai=True requires base\_url”.** Passa `base_url`, oppure imposta `OPENAI_BASE_URL`.
-   **Modello non trovato.** Controlla che l’ID corrisponda esattamente a quello di BroadNet. I modelli a pagamento richiedono una ricarica; il credito di $5 copre solo `broadnet/gemma-4-26b-a4b` e i due modelli Transcribe.
-   **`EmptyLLMResponseError`.** CrewAI ritenta una volta una risposta vuota, poi solleva questo errore. Alza `max_tokens`. [Perché le risposte arrivano vuote](https://broadrouter.com/it/guides/reasoning-tokens-empty-response/).
-   **429 con più agenti.** Una chiave a consumo consente 30 richieste al minuto e 4 in corso, e una sessione del piano esegue una richiesta alla volta. 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.

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

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

[Token](https://broadrouter.com/it/glossary/token/)

Un token è l’unità di testo che un modello linguistico legge e scrive: una parola, una parte di parola, un segno di punteggiatura o una sequenza di byte prodotta dal tokenizer del modello. Le API LLM contano, limitano e di solito fatturano l’uso in token.

[Base URL (URL di base)](https://broadrouter.com/it/glossary/base-url/)

La base URL è l’indirizzo radice fisso di un’API, come https://api.example.com/v1, che un client antepone a ogni percorso di endpoint, come /chat/completions. Negli SDK compatibili con OpenAI, cambiare la base URL, insieme alla chiave API e all’ID del modello, punta lo stesso codice verso un altro provider.

[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

### Cosa fa custom\_openai=True in CrewAI?

Secondo il codice sorgente di CrewAI, forza il provider OpenAI nativo qualunque sia l’aspetto del nome del modello, e richiede base\_url, api\_base, OPENAI\_BASE\_URL o OPENAI\_API\_BASE. La stringa del modello viene inviata così com’è, quindi broadnet/glm-5.3 arriva a BroadNet invariato.

### Posso scrivere invece model="openai/broadnet/glm-5.3"?

Sì. Con un base\_url personalizzato, CrewAI instrada il prefisso openai/ al suo client OpenAI nativo e lo rimuove, quindi BroadNet riceve broadnet/glm-5.3. custom\_openai=True è la forma più chiara.

### Perché la mia crew fallisce con EmptyLLMResponseError?

CrewAI ripete una volta la richiesta quando la risposta è vuota, cioè senza contenuto e senza chiamate agli strumenti, e solleva questo errore se anche il nuovo tentativo è vuoto. Con i modelli di ragionamento di BroadNet di solito significa che il ragionamento ha consumato il budget di output. Alza max\_tokens.

### Quale modello BroadNet conviene agli agenti CrewAI?

GLM 5.3 per gli agenti con strumenti, perché BroadNet indica per lui strumenti e output strutturato. Anche Qwen3.8 27B ha gli strumenti e accetta immagini.

## Guide correlate

-   [Usare Pydantic AI con BroadNet Inference (OpenAICompatibleProvider)](https://broadrouter.com/it/guides/pydantic-ai-openai-compatible/)
-   [Usare l’SDK Python di OpenAI con BroadNet Inference](https://broadrouter.com/it/guides/openai-python-sdk/)
-   [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-crewai-custom-openai-endpoint&utm_content=page-cta) ·

**Fonti**

-   [Documentazione di CrewAI, LLM (OpenAI, endpoint personalizzato compatibile con OpenAI) (verificata il 2026-11-15)](https://docs.crewai.com/en/concepts/llms)
-   [Codice sorgente di CrewAI, instradamento dell’LLM con custom\_openai (llm.py) (verificato il 2026-11-15)](https://github.com/crewAIInc/crewAI/blob/main/lib/crewai/src/crewai/llm.py)
-   [PyPI, crewai 1.15.41, da Python 3.10 a 3.13 (verificato il 2026-11-15)](https://pypi.org/project/crewai/)
-   [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-crewai-custom-openai-endpoint&utm_content=sources)
