goose カスタムプロバイダーのセットアップ

goose では、カスタム プロバイダーを作成する 3 つの方法 (デスクトップ、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 キーを入力します。デスクトップは、キーリングをシステム キーチェーンに保存するか、キーリングが使用できない場合は 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 に「はい」と答え、Static API key を選択し、TokenHub キーを貼り付けます。
6. 正確なモデル ID をカンマ区切りのリストとして Available Models の下に入力します。
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
}

api_key_envは、JSONを手書きする場合に必要です。デスクトップまたは 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 プロバイダーの構成