goose는 데스크톱 앱과 CLI를 갖춘 오픈 소스 AI 에이전트입니다. 기본 내장되지 않은 서비스는 커스텀 제공자로 추가하며, goose는 OpenAI 호환 제공자를 지원합니다. BroadNet Inference는 표준 chat completions를 제공하므로 이 방식으로 연결됩니다. BroadRouter는 BroadNet이 운영하는 사이트이며, 아래 단계는 goose 1.59 기준 goose 제공자 문서를 따릅니다.
goose 문서는 goose가 “extensively uses tool calling”(번역: 도구 호출을 광범위하게 사용함)이라고 경고하며, 도구 호출이 없는 모델은 모든 확장을 끈 상태에서 채팅만 할 수 있다고 설명합니다. BroadNet은 도구 호출을 GLM 5.3과 Qwen3.8 27B에 표기하므로, 에이전트 작업에는 둘 중 하나를 쓰세요.
방법 1: 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를 클릭한 뒤, 이 제공자와 모델을 선택하세요.
방법 2: goose CLI
goose configure를 실행하고 Custom Providers, 이어서 Add A Custom Provider를 고른 뒤, 프롬프트에 같은 값을 입력하세요. API 유형은 OpenAI Compatible, API URL은 위와 같고, 인증은 Yes로 해서 고정 API 키를 쓰며, 모델 목록은 쉼표로 구분하고, 스트리밍은 켭니다.
방법 3: 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 파일의 각 모델에 토큰당 USD 단위의 input_token_cost와 output_token_cost가 있으면 goose가 비용을 추정할 수 있습니다. BroadNet 가격 페이지의 100만 토큰당 가격을 1,000,000으로 나눈 값을 넣으세요. 두 필드가 모두 없으면 goose는 자체 카탈로그 가격을 쓰는데, 이 값은 BroadNet 가격과 다를 수 있습니다.
문제 해결
- 401. 키가 틀렸거나 만료되었거나 사용 가능 금액이 소진되었습니다. 또는 goose를 실행하는 셸에
BROADNET_API_KEY가 설정되지 않았습니다. - 404. API URL이
https://inference.broadnet.ai/v1/chat/completions형태인지 확인하세요. 모델 ID가 BroadNet ID와 정확히 일치하는지도 확인하세요. 유료 모델은 충전이 필요하며, 초기 크레딧($5 상당)으로는broadnet/gemma-4-26b-a4b모델과 Transcribe 모델 두 개만 쓸 수 있으며, Gemma의 32,768 토큰 컨텍스트는 에이전트 작업에는 작습니다. - 빈 답변. DeepSeek V4.1 Flash, GLM 5.3, Qwen3.8 27B에서는 추론도 출력 한도에 포함됩니다. 답변이 비어서 오는 이유를 참고하세요.
- 429. 종량제 키는 분당 30 요청, 동시 처리 4 건까지 허용합니다. 오류와 재시도를 참고하세요.
- 플랜 키 하나로 goose 세션 두 개를 돌리면 요청이 대기하거나 실패함. 플랜 세션은 한 번에 요청 하나만 처리하므로, goose 세션마다 별도의 플랜 세션을 쓰세요.
