Configuration du fournisseur personnalisé Goose

goose documente trois façons de créer un fournisseur personnalisé : Bureau, CLI et un fichier de fournisseur. TokenHub utilise OpenAI Compatible. Dans le schéma du fournisseur personnalisé de goose, saisissez les terminaisons de conversation complètes URL : https://us-api.tokenhub.com/v1/chat/completions.

Utilisez le chemin officiel du bureau goose

1. Cliquez sur le bouton de la barre latérale dans le coin supérieur gauche.
2. Accédez à Settings → Models.
3. Cliquez sur Configure providers.
4. Faites défiler vers le bas et cliquez sur Add Custom Provider.
5. Choisissez OpenAI Compatible pour Provider Type.
6. Saisissez TokenHub pour Display Name.
7. Saisissez https://us-api.tokenhub.com/v1/chat/completions pour API URL.
8. Gardez This provider requires an API key activé et entrez votre clé TokenHub API. Desktop le stocke dans le trousseau système ou dans secrets.yaml lorsqu'un trousseau n'est pas disponible.
9. Sous Available Models, saisissez les identifiants exacts du modèle TokenHub séparés par des virgules anglaises.
10. Activez Streaming Support et cliquez sur Create Provider.

Desktop ne peut actuellement pas ajouter d'en-têtes personnalisés. Si un déploiement en nécessite un, créez le fournisseur et modifiez ensuite son JSON.

Utilisez le chemin officiel goose CLI

Exécutez :

goose configure

Suivez ensuite exactement le menu :

1. Sélectionnez Custom Providers (Add custom provider with compatible API).
2. Sélectionnez Add A Custom Provider.
3. Choisissez OpenAI Compatible pour le type API.
4. Nommez-le TokenHub et entrez les terminaisons de chat complètes URL.
5. Répondez Oui à Authentication Required, choisissez Static API key et collez la clé TokenHub.
6. Entrez les ID de modèle exacts sous forme de liste séparée par des virgules sous Available Models.
7. Activez la prise en charge du streaming. Ajoutez des en-têtes personnalisés uniquement si le point de terminaison en a réellement besoin.

Le CLI prend également en charge le Command (refreshable) pour les informations d'identification de courte durée. Une clé TokenHub API normale n'a pas besoin de ce chemin.

Inspecter le fichier fournisseur goose généré

Sous macOS et Linux, les fichiers se trouvent sous ~/.config/goose/custom_providers/. Sous Windows, utilisez %APPDATA%\Block\goose\config\custom_providers\. Les champs importants doivent correspondre :

{
  "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 est nécessaire lorsque vous écrivez manuellement JSON. Une clé statique saisie via Desktop ou CLI est stockée en toute sécurité par goose. Remplacez context_limit par la limite réelle du modèle.

Changer de modèle et appliquer le changement

Dans Desktop, accédez à Settings → Models → Switch models, choisissez le fournisseur et le modèle TokenHub, puis cliquez sur Select model. La documentation goose indique qu'une modification du fournisseur personnalisé prend effet dans next goose session, ne la testez donc pas dans une ancienne session.

Commencez la nouvelle session avec une tâche de codage en lecture seule et confirmez le chemin complet /v1/chat/completions dans les journaux TokenHub. Pour un 404, inspectez API URL. Si un modèle est invisible, vérifiez la liste séparée par des virgules ou models[].name. Si le chat fonctionne mais que l'agent ne peut pas agir, utilisez un modèle qui renvoie des appels d'outils structurés.

Référence officielle

• goose : configurer un fournisseur LLM