docs
Ügynökök a terminálban

Pi

Markdown

Terminálügynök · OpenAI Chat, Anthropic Messages, Gemini

Teljes útmutató
FormátumHol állítható be?
OpenAI Chat, Anthropic Messages, Gemini~/.pi/agent/models.json (vagy a projekt .pi/models.json fájlja a projekt megbízhatóvá tétele után); kiválasztás: /model

Beállítás

Másolja le a konfigurációt, és cserélje ki a sk-... értéket a saját Ailoot-fiókkulcsára. Érdemes a kulcsot a következő környezeti AILOOT_API_KEYváltozóban tárolni, ha az alkalmazás támogatja.

Indítás előtt hívd meg a GET /v1/models végpontot az Ailoot-kulcsoddal. Válassz pontos modellazonosítót, amelynek metódusai között szerepel POST /v1/chat/completions, POST /v1/messages, POST /v1beta/models/{model}:generateContent, és ezt használd a beállításban. Ügynököknél ellenőrizd az eszközkezelést és a kliensverziódhoz szükséges funkciókat is.

{
  "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"
        }
      ]
    }
  }
}

Ez a beállítás a kulcsot ebből a változóból olvassa: AILOOT_API_KEY. Az alkalmazás indítása előtt állítsa be:

export AILOOT_API_KEY="sk-..."   # adja hozzá a ~/.zshrc vagy ~/.bashrc fájlhoz

Példamodell: claude-sonnet-5-5. Más modelleket a katalógusból válasszon — ellenőrizze, hogy támogatják-e a szükséges formátumot.

Fontos tudnivalók

Ellenőrzés

  • OpenAI formátumnál a cím: https://api.ailoot.ai/v1 (vagy a teljes útvonal, ha az alkalmazás teljes címet kér).
  • Anthropic formátumnál a cím: https://api.ailoot.ai — az API gyökércíme. A formátum teljes beállítása a fenti példában nem szerepel; a kliens mezőjében szükséges útvonalat a kliens dokumentációjában ellenőrizze. Az API útvonalának előtagja — /v1.
  • Gemini formátumnál a cím: https://api.ailoot.ai — az API gyökércíme. A formátum teljes beállítása a fenti példában nem szerepel; a kliens mezőjében szükséges útvonalat a kliens dokumentációjában ellenőrizze. Az API útvonalának előtagja — /v1beta.
  • Tegyen fel egy rövid kérdést. Ha hiba érkezik, nézze meg a kódot és a Request ID-t, majd vesse össze ezzel az oldallal: Hibák és korlátok.
  • A közvetlenül a beállítás után érkező 404-es hiba szinte mindig hibás címet jelent: felesleges vagy hiányzó /v1.
  • 402 — az egyenleg nem fedezi a zárolást. Az ügynökök többet zárolnak, mint a csevegők: miért?.

Az alkalmazás dokumentációja: https://github.com/earendil-works/pi/blob/main/packages/coding-agent/docs/models.md

Maradt kérdése? Küldje el a Request ID-t és a probléma leírását — segítünk tisztázni.Írjon a támogatásnak