Doku
Agenten im Terminal

Pi

Markdown

Agent im Terminal · OpenAI Chat, Anthropic Messages, Gemini

Vollständiger Leitfaden
FormatWo die Konfiguration erfolgt
OpenAI Chat, Anthropic Messages, Gemini~/.pi/agent/models.json (oder die projektbezogene .pi/models.json, nachdem dem Projekt vertraut wurde); Auswahl — /model

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, POST /v1beta/models/{model}:generateContent 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.

{
  "providers": {
    "ailoot": {
      "baseUrl": "https://api.ailoot.ai/v1",
      "api": "openai-completions",
      "apiKey": "$AILOOT_API_KEY",
      "models": [
        {
          "id": "claude-sonnet-5-5",
          "input": [
            "text",
            "image"
          ]
        },
        {
          "id": "deepseek-v4-pro"
        }
      ]
    }
  }
}

Diese Konfiguration liest den Schlüssel aus der Variablen AILOOT_API_KEY. Setzen Sie sie vor dem Start der Anwendung:

export AILOOT_API_KEY="sk-..."   # Fügen Sie dies zu ~/.zshrc oder ~/.bashrc hinzu

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

  • Für das OpenAI-Format lautet die Adresse 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.
  • Für das Gemini-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 — /v1beta.
  • 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/earendil-works/pi/blob/main/packages/coding-agent/docs/models.md

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