Doku
Agenten im Terminal

Goose

Markdown

Agent im Terminal · OpenAI Chat, Anthropic Messages

Vollständiger Leitfaden
FormatWo die Konfiguration erfolgt
OpenAI Chat, Anthropic Messagesgoose configure → Custom Providers → Add A Custom Provider oder JSON in ~/.config/goose/custom_providers/ (Windows: %APPDATA%\Block\goose\config\custom_providers\); Alternative: eingebauter OpenAI-Anbieter mit OPENAI_HOST/OPENAI_BASE_PATH

Konfiguration

Kopieren Sie die Konfiguration und ersetzen Sie sk-... durch Ihren eigenen Schlüssel aus dem Ailoot-Kundenbereich. Speichern Sie den Schlüssel besser in der Umgebungsvariablen AILOOT_API_KEY, sofern die Anwendung dies unterstützt.

Rufen Sie vor dem Start GET /v1/models mit Ihrem Ailoot-Schlüssel ab. Wählen Sie eine genaue Modell-ID mit den Methoden POST /v1/chat/completions, POST /v1/messages und tragen Sie diese ID in die Konfiguration ein. Prüfen Sie bei Agenten auch die Werkzeugunterstützung und die für Ihre Clientversion benötigten Funktionen.

~/.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

# Variante mit dem integrierten OpenAI-Provider:
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"

Beispielmodell: claude-sonnet-5-5. Wählen Sie jedes andere Modell aus dem Katalog und prüfen Sie, ob es das benötigte Format unterstützt.

Wichtige Hinweise

Prüfung

  • Verwenden Sie für custom base_url oder die integrierten Felder OPENAI_HOST und OPENAI_BASE_PATH die passende Variante des obigen Beispiels. Das Präfix der OpenAI-Methoden lautet — https://api.ailoot.ai/v1 (oder der vollständige Pfad, wenn die Anwendung eine vollständige Adresse verlangt).
  • Für das Anthropic-Format lautet die Adresse https://api.ailoot.ai — die Basisadresse der API. Die vollständige Konfiguration dieses Formats ist im obigen Beispiel nicht dargestellt; prüfen Sie in der Client-Dokumentation, welcher Pfad in das Feld gehört. Das Präfix der API-Route lautet — /v1.
  • Stellen Sie eine kurze Frage. Prüfen Sie bei einem Fehler den Code und die Request ID und vergleichen Sie mit der Seite Fehler und Limits.
  • 404 direkt nach der Konfiguration bedeutet fast immer eine falsche Adresse: ein zusätzliches oder fehlendes /v1.
  • 402 bedeutet, dass das Guthaben für die Reservierung nicht ausreicht. Agenten reservieren mehr als Chats: warum.

Dokumentation der Anwendung: https://github.com/aaif-goose/goose/blob/main/documentation/docs/getting-started/providers.md

Noch Fragen? Senden Sie uns die Request ID und eine Beschreibung, damit wir Ihnen weiterhelfen können.Support kontaktieren