---
title: "goose: provider personalizzato compatibile OpenAI | BroadRouter"
description: "Collega l’agente AI goose a BroadNet Inference come custom provider OpenAI Compatible, da goose Desktop, con goose configure o con un file JSON."
url: https://broadrouter.com/it/guides/goose-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/goose-custom-provider/) (aggiornato il 2026-11-16).

# Aggiungere BroadNet Inference a goose come provider personalizzato

Aggiornato 2026-11-16

In goose aggiungi un custom provider di tipo OpenAI Compatible, con API URL https://inference.broadnet.ai/v1/chat/completions, la tua chiave BroadNet e modelli disponibili come broadnet/glm-5.3. Usa il pulsante Add Custom Provider di goose Desktop, goose configure nel terminale o un file JSON in ~/.config/goose/custom\_providers/. goose si basa sul tool calling, quindi parti da GLM 5.3 o Qwen3.8 27B.

goose è un agente AI open source con un’app desktop e una CLI. I servizi non integrati si aggiungono come **custom provider**, e goose supporta quelli compatibili con OpenAI. BroadNet Inference serve chat completions standard, quindi funziona in questo modo. BroadRouter è il sito di BroadNet; i passaggi seguono [la documentazione di goose sui provider](https://goose-docs.ai/docs/getting-started/providers/) alla versione 1.59.

La documentazione di goose avverte che goose “extensively uses tool calling” (traduzione: usa ampiamente il tool calling) e che i modelli che non lo supportano possono solo chattare, con tutte le estensioni disattivate. BroadNet indica il tool calling per GLM 5.3 e Qwen3.8 27B, quindi usa uno di questi due per il lavoro da agente.

## Opzione 1: goose Desktop

1.  Apri la barra laterale e clicca **Settings**, poi la scheda **Models**.
    
2.  Clicca **Configure providers**, poi **Add Custom Provider** in fondo.
    
3.  Compila i dati:
    
    | Campo | Valore |
    | --- | --- |
    | Provider Type | **OpenAI Compatible** |
    | Display Name | BroadNet Inference |
    | API URL | `https://inference.broadnet.ai/v1/chat/completions` |
    | API Key | la tua chiave BroadNet |
    | Available Models | `broadnet/glm-5.3, broadnet/qwen3.8-27b` |
    | Streaming Support | attivo |
    
4.  Clicca **Create Provider**, poi selezionalo insieme a un modello.
    

## Opzione 2: goose CLI

Esegui `goose configure`, scegli **Custom Providers**, poi **Add A Custom Provider**, e rispondi alle domande con gli stessi valori: tipo di API OpenAI Compatible, l’API URL qui sopra, autenticazione **Yes** con una chiave API statica, l’elenco dei modelli separati da virgole e lo streaming attivo.

## Opzione 3: un file JSON

Crea `~/.config/goose/custom_providers/broadnet.json` (su Windows, `%APPDATA%\Block\goose\config\custom_providers\`):

```json
{
  "name": "broadnet",
  "engine": "openai",
  "display_name": "BroadNet Inference",
  "description": "BroadNet Inference, OpenAI-compatible",
  "api_key_env": "BROADNET_API_KEY",
  "base_url": "https://inference.broadnet.ai/v1/chat/completions",
  "models": [
    { "name": "broadnet/glm-5.3", "context_limit": 1048576 },
    { "name": "broadnet/qwen3.8-27b", "context_limit": 262144 },
    { "name": "broadnet/deepseek-v4.1-flash", "context_limit": 1048576 }
  ],
  "supports_streaming": true,
  "requires_auth": true
}
```

Poi avvia una sessione con questo provider:

```bash
export BROADNET_API_KEY='your-broadnet-key'
goose session start --provider broadnet
```

Puoi mettere il file in un repository per il tuo team, perché la chiave resta nell’ambiente.

## Provalo

Inizia con una domanda semplice, come “what can you do?”. Se risponde, la connessione funziona. Poi chiedi qualcosa che richieda una delle estensioni attive. Se goose chiama lo strumento, funziona anche il tool calling. Se risponde solo con testo e non chiama mai uno strumento, passa a `broadnet/glm-5.3`.

## I prezzi in goose

goose può stimare il costo se ogni modello nel file JSON ha `input_token_cost` e `output_token_cost` in USD per token. Prendi i valori dalla [pagina dei prezzi](https://broadrouter.com/it/pricing/) di BroadNet e dividi il prezzo per milione per 1.000.000. Senza entrambi i campi, goose ripiega sui prezzi del proprio catalogo, che potrebbero non corrispondere a quelli di BroadNet.

## Risoluzione dei problemi

-   **401.** La chiave è sbagliata, scaduta o ha esaurito la quota, oppure `BROADNET_API_KEY` non è impostata nella shell che avvia goose.
-   **404.** Controlla l’API URL: deve essere `https://inference.broadnet.ai/v1/chat/completions`. Verifica che l’ID del modello 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, e il contesto da 32.768 token di Gemma è piccolo per il lavoro da agente.
-   **Risposte vuote.** Su DeepSeek V4.1 Flash, GLM 5.3 e Qwen3.8 27B il ragionamento conta nel limite di output. [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 in corso contemporaneamente. Vedi [errori e retry](https://broadrouter.com/it/guides/errors-and-retries/).
-   **Le richieste attendono o falliscono con due sessioni di goose sulla stessa chiave del piano.** Una [sessione del piano](https://broadrouter.com/it/guides/unlimited-llm-api-sessions/) esegue una richiesta alla volta, quindi dai a ogni sessione di goose la sua.

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

[Streaming](https://broadrouter.com/it/glossary/streaming/)

Lo streaming è un modo di restituire la risposta di un modello linguistico in piccoli pezzi mentre viene ancora generata, invece che in un’unica risposta alla fine. Le API compatibili con OpenAI trasmettono in streaming tramite server-sent event quando la richiesta imposta stream a true.

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

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

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

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

[Agente AI (AI agent)](https://broadrouter.com/it/glossary/agent/)

Un agente AI è un sistema in cui un modello linguistico dirige da solo i propri passi verso un obiettivo: decide quali strumenti chiamare, legge i risultati e ripete finché produce una risposta finale o raggiunge un limite. Uno script fisso che chiama un modello in punti prestabiliti di solito si chiama invece workflow.

## Domande frequenti

### L’API URL di goose deve finire con /v1 o con /v1/chat/completions?

L’esempio di custom provider nella documentazione di goose usa l’URL completo delle chat completions, quindi usa https://inference.broadnet.ai/v1/chat/completions. In questo modo goose resta anche sulle chat completions, che sono ciò che serve BroadNet.

### Quale modello BroadNet funziona meglio con goose?

GLM 5.3 (broadnet/glm-5.3). La documentazione di goose dice che usa molto il tool calling, e BroadNet indica gli strumenti solo per GLM 5.3 e Qwen3.8 27B.

### Posso usare goose con il piano illimitato di BroadNet?

I piani coprono solo DeepSeek V4.1 Flash, e la documentazione di BroadNet non indica il tool calling per quel modello. goose dice che i modelli senza tool calling possono solo chattare con le estensioni disattivate, quindi provalo prima di comprare un mese.

### Dove salva goose la chiave API?

Nel portachiavi di sistema, oppure in secrets.yaml se il keyring è disattivato. Con un file JSON, goose legge invece la variabile indicata in api\_key\_env.

## Guide correlate

-   [Usare Kilo Code con BroadNet Inference (provider OpenAI Compatible)](https://broadrouter.com/it/guides/kilo-code-openai-compatible/)
-   [Aggiungere BroadNet Inference a opencode come provider personalizzato](https://broadrouter.com/it/guides/opencode-custom-provider/)
-   [Come funzionano i piani API LLM illimitati per gli agenti](https://broadrouter.com/it/guides/unlimited-llm-api-sessions/)
-   [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-goose-custom-provider&utm_content=page-cta) ·

**Fonti**

-   [Documentazione di goose, Model providers e Configure Custom Provider (verificata il 2026-11-15)](https://goose-docs.ai/docs/getting-started/providers/)
-   [goose su GitHub (aaif-goose/goose), ultima versione v1.59.1 (verificato il 2026-11-15)](https://github.com/aaif-goose/goose)
-   [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-goose-custom-provider&utm_content=sources)
