거위 맞춤 공급자 설정

goose는 사용자 지정 공급자를 만드는 세 가지 방법인 데스크톱, CLI 및 공급자 파일을 문서화합니다. TokenHub는 OpenAI Compatible를 사용합니다. goose의 사용자 정의 공급자 스키마에 전체 채팅 완료 URL: https://us-api.tokenhub.com/v1/chat/completions를 입력합니다.

공식 goose 데스크탑 경로를 사용하세요.

1. 왼쪽 상단 모서리에 있는 사이드바 버튼을 클릭합니다.
2. Settings → Models로 이동합니다.
3. Configure providers를 클릭합니다.
4. 아래로 스크롤하여 Add Custom Provider를 클릭합니다.
5. Provider Type에 대해 OpenAI Compatible를 선택합니다.
6. Display Name에 TokenHub를 입력합니다.
7. API URL에 https://us-api.tokenhub.com/v1/chat/completions를 입력합니다.
8. This provider requires an API key를 활성화된 상태로 유지하고 TokenHub API 키를 입력하세요. Desktop에서는 이를 시스템 키체인에 저장하거나 키링을 사용할 수 없는 경우 secrets.yaml에 저장합니다.
9. Available Models 아래에 정확한 TokenHub 모델 ID를 영어 쉼표로 구분하여 입력하세요.
10. Streaming Support를 활성화하고 Create Provider를 클릭합니다.

데스크톱에서는 현재 맞춤 헤더를 추가할 수 없습니다. 배포에 공급자가 필요한 경우 공급자를 생성하고 나중에 해당 JSON를 편집합니다.

공식 goose CLI 경로를 사용하세요.

실행:

goose configure

그런 다음 메뉴를 정확하게 따르십시오.

1. **Custom Providers (Add custom provider with compatible API)**를 선택합니다.
2. Add A Custom Provider를 선택합니다.
3. API 유형으로 OpenAI Compatible를 선택합니다.
4. 이름을 TokenHub로 지정하고 전체 채팅 완료 URL를 입력하세요.
5. Authentication Required에 Yes라고 대답하고 Static API key를 선택한 후 TokenHub 키를 붙여넣습니다.
6. Available Models 아래에 정확한 모델 ID를 쉼표로 구분된 목록으로 입력하세요.
7. 스트리밍 지원을 활성화합니다. 엔드포인트에 실제로 필요한 경우에만 사용자 지정 헤더를 추가하세요.

CLI는 단기 자격 증명을 위해 Command (refreshable)도 지원합니다. 일반 TokenHub API 키에는 해당 경로가 필요하지 않습니다.

생성된 공급자 파일 goose를 검사합니다.

macOS 및 Linux에서 파일은 ~/.config/goose/custom_providers/ 아래에 있습니다. Windows에서는 %APPDATA%\Block\goose\config\custom_providers\를 사용합니다. 중요한 필드는 다음과 일치해야 합니다.

{
  "name": "tokenhub",
  "engine": "openai",
  "display_name": "TokenHub",
  "api_key_env": "TOKENHUB_API_KEY",
  "base_url": "__API_BASE_URL__/v1/chat/completions",
  "models": [
    {
      "name": "YOUR_TOKENHUB_MODEL_ID",
      "context_limit": 128000
    }
  ],
  "supports_streaming": true,
  "requires_auth": true
}

JSON를 직접 작성할 때 api_key_env가 필요합니다. Desktop 또는 CLI를 통해 입력한 정적 키는 goose에 의해 안전하게 저장됩니다. context_limit를 모델의 실제 한계로 바꿉니다.

모델 전환 및 변경 사항 적용

데스크톱에서 Settings → Models → Switch models로 이동하여 TokenHub 공급자와 모델을 선택한 다음 Select model를 클릭합니다. goose 문서에는 사용자 지정 공급자 변경 사항이 next goose session에 적용된다고 나와 있으므로 이전 세션에서 테스트하지 마세요.

읽기 전용 코딩 작업으로 새 세션을 시작하고 TokenHub 로그에서 전체 /v1/chat/completions 경로를 확인합니다. 404의 경우 API URL를 검사합니다. 모델이 보이지 않는 경우 쉼표로 구분된 목록 또는 models[].name를 확인하세요. 채팅은 작동하지만 상담원이 조치를 취할 수 없는 경우 구조화된 도구 호출을 반환하는 모델을 사용하세요.

공식 참고자료

• goose: LLM 공급자 구성