goose 是一个开源的 AI agent,有桌面应用和 CLI。没有内置的服务可以作为自定义供应商添加,goose 支持 OpenAI 兼容的供应商。BroadNet Inference 提供标准的 chat completions,因此可以这样接入。BroadRouter 是 BroadNet 自己的网站;下面的步骤依据 goose 1.59 时的 goose 供应商文档。
goose 的文档提醒,它“extensively uses tool calling”(译文:大量使用工具调用),不支持工具调用的模型只能在禁用所有扩展的情况下聊天。BroadNet 为 GLM 5.3 和 Qwen3.8 27B 列出了工具调用,做 agent 工作时请用这两个之一。
方式一:goose Desktop
-
打开侧边栏,点击 Settings,再进入 Models 标签页。
-
点击 Configure providers,然后点击底部的 Add Custom Provider。
-
填写信息:
字段 值 Provider Type OpenAI Compatible Display Name BroadNet Inference API URL https://inference.broadnet.ai/v1/chat/completionsAPI Key 你的 BroadNet 密钥 Available Models broadnet/glm-5.3, broadnet/qwen3.8-27bStreaming Support 开启 -
点击 Create Provider,然后选中它和一个模型。
方式二:goose CLI
运行 goose configure,选择 Custom Providers,再选 Add A Custom Provider,按提示填入同样的值:API 类型 OpenAI Compatible,上面的 API URL,认证选 Yes 并使用静态 API 密钥,逗号分隔的模型列表,开启流式输出。
方式三:JSON 文件
创建 ~/.config/goose/custom_providers/broadnet.json(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
}
然后用它启动一个会话:
export BROADNET_API_KEY='your-broadnet-key'
goose session start --provider broadnet
由于密钥保存在环境变量里,这个文件可以放进代码仓库与团队共享。
测试
先问一个简单的问题,比如“what can you do?”(你能做什么?)。得到回答就说明连接正常。然后让它做一件需要用到已启用扩展的事。如果 goose 调用了工具,说明工具调用也正常。如果它只回复文字、从不调用工具,请换成 broadnet/glm-5.3。
在 goose 中显示价格
如果 JSON 文件中的每个模型都写了 input_token_cost 和 output_token_cost(单位为美元/token),goose 就能估算费用。数值取自 BroadNet 的价格页,把每百万 token 的价格除以 1,000,000。如果缺少这两个字段,goose 会退回使用它自带目录中的价格,可能与 BroadNet 的价格不一致。
故障排查
- 401。 密钥不对、已过期或额度已用完,或者启动 goose 的 shell 中没有设置
BROADNET_API_KEY。 - 404。 检查 API URL,应该是
https://inference.broadnet.ai/v1/chat/completions。检查模型 ID 是否与 BroadNet 的完全一致。付费模型需要先充值;$5 额度只覆盖broadnet/gemma-4-26b-a4b和两个 Transcribe 模型,而 Gemma 32,768 token 的上下文对 agent 工作来说偏小。 - 回答为空。 在 DeepSeek V4.1 Flash、GLM 5.3 和 Qwen3.8 27B 上,思考内容计入输出上限。为什么回答会是空的。
- 429。 按量付费密钥每分钟允许 30 个请求,同时最多 4 个进行中的请求。参见错误码与重试。
- 两个 goose 会话共用一个套餐密钥时请求等待或失败。 一个套餐会话同一时间只处理一个请求,所以请给每个 goose 会话单独分配一个。
