docs
Agents dans le terminal

Goose

Markdown

Agent dans le terminal · OpenAI Chat, Anthropic Messages

Guide complet
FormatOù configurer
OpenAI Chat, Anthropic Messagesgoose configure → Custom Providers → Add A Custom Provider, ou JSON dans ~/.config/goose/custom_providers/, et sous Windows dans %APPDATA%\Block\goose\config\custom_providers\ ; autre option : fournisseur OpenAI intégré avec OPENAI_HOST/OPENAI_BASE_PATH

Configuration

Copiez la configuration et remplacez sk-... par votre clé de l’espace client Ailoot. Il est préférable de conserver la clé dans la variable d’environnement AILOOT_API_KEY, si l’application le permet.

Avant de démarrer, appelez GET /v1/models avec votre clé Ailoot. Choisissez un identifiant exact de modèle dont les méthodes incluent POST /v1/chat/completions, POST /v1/messages, puis utilisez-le dans la configuration. Pour les agents, vérifiez aussi les outils et les fonctions nécessaires à votre version du client.

~/.config/goose/custom_providers/ailoot.json

{
  "name": "ailoot",
  "engine": "openai",
  "display_name": "Ailoot",
  "description": "Ailoot API",
  "api_key_env": "AILOOT_API_KEY",
  "base_url": "https://api.ailoot.ai/v1/chat/completions",
  "models": [
    {
      "name": "claude-sonnet-5-5",
      "context_limit": 1000000
    },
    {
      "name": "gpt-6.1-sol",
      "context_limit": 272000
    }
  ],
  "supports_streaming": true,
  "requires_auth": true
}
export AILOOT_API_KEY="sk-..."
goose session start --provider ailoot

# Autre option, via le fournisseur OpenAI intégré :
export GOOSE_PROVIDER=openai
export OPENAI_HOST=https://api.ailoot.ai
export OPENAI_BASE_PATH=v1/chat/completions
export OPENAI_API_KEY="$AILOOT_API_KEY"

Exemple de modèle : claude-sonnet-5-5. Choisissez tout autre modèle dans le catalogue — vérifiez qu’il prend en charge le format requis.

À savoir

Vérification

  • Pour custom base_url ou les champs intégrés OPENAI_HOST et OPENAI_BASE_PATH, utilisez la variante correspondante de l’exemple ci-dessus. Le préfixe des méthodes OpenAI est — https://api.ailoot.ai/v1 (ou le chemin complet si l’application demande une adresse complète).
  • Pour le format Anthropic, l’adresse est https://api.ailoot.ai — l’adresse racine de l’API. La configuration complète de ce format n’est pas présentée dans l’exemple ci-dessus ; consultez la documentation du client pour vérifier le chemin à saisir dans son champ. Le préfixe de la route API est — /v1.
  • Posez une question courte. En cas d’erreur, consultez le code et le Request ID, puis reportez-vous à la page Erreurs et limites.
  • Une erreur 404 immédiatement après la configuration indique presque toujours une adresse incorrecte : la présence superflue ou l’absence de /v1.
  • Une erreur 402 signifie que le solde ne couvre pas la réservation. Les agents réservent plus qu’un chat : explication.

Documentation de l’application : https://github.com/aaif-goose/goose/blob/main/documentation/docs/getting-started/providers.md

Encore des questions ? Envoyez le Request ID et une description : nous vous aiderons à l’analyser.Contacter l’assistance