BroadRouter

Adicionar a BroadNet Inference ao goose como provedor personalizado

Atualizado em

No goose, adicione um custom provider do tipo OpenAI Compatible, com API URL https://inference.broadnet.ai/v1/chat/completions, a sua chave da BroadNet e modelos disponíveis como broadnet/glm-5.3. Use o botão Add Custom Provider do goose Desktop, o goose configure no terminal ou um arquivo JSON em ~/.config/goose/custom_providers/. O goose depende de tool calling, então comece com GLM 5.3 ou Qwen3.8 27B.

O goose é um agente de IA open source com app desktop e CLI. Serviços que não vêm integrados são adicionados como custom providers, e o goose aceita os compatíveis com a OpenAI. A BroadNet Inference oferece chat completions padrão, então funciona desse jeito. O BroadRouter é o site da própria BroadNet; os passos seguem a documentação de provedores do goose na versão 1.59.

A documentação do goose avisa que ele “extensively uses tool calling” (tradução: usa tool calling intensamente) e que modelos sem esse recurso só conseguem conversar, com todas as extensões desativadas. A BroadNet lista tool calling para GLM 5.3 e Qwen3.8 27B, então use um desses dois para trabalho de agente.

Opção 1: goose Desktop

  1. Abra a barra lateral e clique em Settings, depois na aba Models.

  2. Clique em Configure providers e depois em Add Custom Provider, no fim da página.

  3. Preencha os dados:

    Campo Valor
    Provider Type OpenAI Compatible
    Display Name BroadNet Inference
    API URL https://inference.broadnet.ai/v1/chat/completions
    API Key a sua chave da BroadNet
    Available Models broadnet/glm-5.3, broadnet/qwen3.8-27b
    Streaming Support ligado
  4. Clique em Create Provider e selecione o provedor e um modelo.

Opção 2: goose CLI

Rode goose configure, escolha Custom Providers e depois Add A Custom Provider, e responda às perguntas com os mesmos valores: tipo de API OpenAI Compatible, a API URL acima, autenticação Yes com uma chave de API fixa, a lista de modelos separados por vírgula e streaming ligado.

Opção 3: um arquivo JSON

Crie ~/.config/goose/custom_providers/broadnet.json (no Windows, %APPDATA%\Block\goose\config\custom_providers\):

{
  "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
}

Depois inicie uma sessão com ele:

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

O arquivo pode ir para um repositório do seu time, porque a chave fica no ambiente.

Teste

Comece com uma pergunta simples, como “what can you do?”. Se vier resposta, a conexão funciona. Depois peça algo que precise de uma das extensões ativas. Se o goose chamar a ferramenta, o tool calling também funciona. Se ele só responder com texto e nunca chamar uma ferramenta, troque para broadnet/glm-5.3.

Preços no goose

O goose consegue estimar o custo se cada modelo no arquivo JSON tiver input_token_cost e output_token_cost em USD por token. Pegue os valores na página de preços da BroadNet e divida o preço por milhão por 1.000.000. Sem os dois campos, o goose usa os preços do próprio catálogo, que podem não bater com os da BroadNet.

Solução de problemas

  • 401. A chave está errada, expirou ou ficou sem cota, ou BROADNET_API_KEY não está definida no shell que inicia o goose.
  • 404. Confira a API URL: ela deve ser https://inference.broadnet.ai/v1/chat/completions. Confira se o ID do modelo é exatamente o da BroadNet. Os modelos pagos exigem uma recarga; o crédito de $5 cobre só broadnet/gemma-4-26b-a4b e os dois modelos Transcribe, e o contexto de 32.768 tokens do Gemma é pequeno para trabalho de agente.
  • Respostas vazias. No DeepSeek V4.1 Flash, no GLM 5.3 e no Qwen3.8 27B, o raciocínio conta para o limite de saída. Por que as respostas vêm vazias.
  • 429. Uma chave de pagamento por uso permite 30 requisições por minuto e 4 em andamento. Veja erros e novas tentativas.
  • Requisições esperam ou falham com duas sessões do goose na mesma chave de plano. Uma sessão do plano roda uma requisição por vez, então dê a cada sessão do goose a sua própria.

Perguntas frequentes

A API URL do goose deve terminar em /v1 ou em /v1/chat/completions?

O exemplo de custom provider da própria documentação do goose usa a URL completa de chat completions, então use https://inference.broadnet.ai/v1/chat/completions. Isso também mantém o goose em chat completions, que é o que a BroadNet oferece.

Qual modelo da BroadNet funciona melhor com o goose?

GLM 5.3 (broadnet/glm-5.3). A documentação do goose diz que ele usa tool calling intensamente, e a BroadNet lista ferramentas só para GLM 5.3 e Qwen3.8 27B.

Posso usar o goose no plano ilimitado da BroadNet?

Os planos cobrem só o DeepSeek V4.1 Flash, e a documentação da BroadNet não lista tool calling para ele. O goose diz que modelos sem tool calling só conseguem conversar com as extensões desativadas, então teste antes de comprar um mês.

Onde o goose guarda a chave de API?

No chaveiro do sistema, ou em secrets.yaml se o keyring estiver desligado. Com um arquivo JSON, o goose lê a variável indicada em api_key_env.

Ler em MarkdownPerguntar ao ChatGPTPerguntar ao ClaudePerguntar ao Perplexity