Tovább a tartalomhoz

Adapterek és modellek kezelése

Ez az útmutató bemutatja, hogyan csatlakoztathat modellszolgáltatókat, és hogyan választhatja ki, min fusson egy ügynök.

Minden itt leírt beállítás egyetlen oldalon található: Beállítások → Szerver → Modellszolgáltatók. Az alsó oldalsáv bejegyzése „Modellszolgáltatók”, az oldal címsora pedig „Adapterek”.

Az adapter az a futtató, amely végrehajtja az ügynök egy körét. Kettő van belőle, és a lista rögzített — harmadikat nem adhat hozzá.

Adapter CLI Átvitel
Control Center (beépített) nincs Folyamaton belüli ügynökciklus, HTTP-n keresztül beszél a szolgáltatókkal
Claude Code claude claude -p --output-format stream-json

A Cursor, a Codex, az Anthropic, az OpenAI és a többi a beépített adapter szolgáltatója, nem külön CLI. Amit viszont hozzáadhat, az egy további szolgáltató — bármely OpenAI- vagy Anthropic-kompatibilis végpont. Erről szól a következő szakasz.

A beépített adapter csak akkor tud futni, ha legalább egy szolgáltató csatlakoztatva van hozzá. A katalógus alapból tizennégy szolgáltatót tartalmaz.

  1. Lépjen a Beállítások → Szerver → Modellszolgáltatók oldalra
  2. Görgessen a Szolgáltatók és modellek szakaszig
  3. Keresse meg a szolgáltatóját, és csatlakoztassa:
Szolgáltató Hogyan csatlakoztatható
Anthropic API-kulcs. A Claude Pro/Max előfizetés nem Anthropic API-bejelentkezés — ilyen csomaghoz a Claude Code adaptert használja
OpenAI, Codex, Cursor Böngészős OAuth-bejelentkezés vagy API-kulcs. A Codex a Codex Responses háttérrendszeren keresztül elért ChatGPT Plus/Pro, nem külön elindított CLI
Kimi Code Csak böngészős OAuth — eszközkódos folyamat. Átalánydíjas csomag, ezért nincs tokenenkénti ára
OpenRouter, Google Gemini, DeepSeek, Mistral, xAI, z.ai, z.ai GLM Coding Plan, Moonshot (Kimi API) API-kulcs

Ellenőrzőpont: a sor jelvénye „csatlakoztatva” állapotra vált, és a sor kinyitásakor megjelenik az adott szolgáltató összes modellje, mindegyiknél az egymillió tokenre jutó ár és a kontextusablak.

Az OAuth-tokenek a szerver saját hitelesítőadat-tárába kerülnek, és a lejáratuk előtt frissülnek. A szolgáltatói hitelesítő adatok hoszt-szintűek — a telepítés minden munkaterülete megosztja őket, egyikhez sincsenek hozzákötve.

Ezt Ollamához, LM Studio-hoz, vLLM-hez vagy saját telepítésű végponthoz használja.

  1. A Szolgáltatók és modellek alatt, az Egyéni szolgáltatók csoportban nyomja meg a Szolgáltató hozzáadása gombot
  2. Adjon meg egy nevet, válassza ki az API típusát (OpenAI-kompatibilis vagy Anthropic-kompatibilis), és adja meg az Alap-URL-t (például http://localhost:11434/v1)
  3. Ha a végpont igényli, adjon meg API-kulcsot, majd nyomja meg a Szolgáltató hozzáadása gombot

Az egyéni szolgáltató ugyanabban a listában jelenik meg, olyan törlésgombbal, amellyel a beépített társai nem rendelkeznek.

  1. Lépjen a Beállítások → Munkaterület → Ügynökök oldalra, és válassza ki az ügynököt
  2. A Beállítások lapon válassza ki az adaptert
  3. A mellette lévő legördülő listából válassza ki a modellt

A beépített adapternél a legördülő lista élőben, a csatlakoztatott szolgáltatók saját katalógusából áll össze. Az a szolgáltató, amelyhez nincs tárolt hitelesítő adat, nulla modellt ad hozzá, ezért az üres legördülő lista szinte mindig azt jelenti, hogy „még nincs semmi csatlakoztatva”, nem pedig azt, hogy „nincs elérhető modell”.

A beépített adapter modellazonosítói provider/model formában minősítettek, és | karakterrel elválasztott tartalék láncot is hordozhatnak. Tartalék lánc esetén a költség annak a modellnek az árán számolódik, amelyik ténylegesen kiszolgálta a kört, nem annak, amelyiket kérte.

A beépített adapter nem igényel telepítést. A Claude Code esetében telepítse a CLI-jét a szervergépre az adott eszköz saját csomagkezelőjével, például:

Terminál
npm install -g @anthropic-ai/claude-code

Ezután nyomja meg az oldal tetején a Frissítés gombot. Minden felismert sor mutatja a feloldott verziót és útvonalat, valamint jelzőcímkéket arról, hogy támogatja-e a JSON módot és a modellválasztást.

A külső CLI a saját hitelesítő adatait a saját konfigurációjában, a szervergépen tartja. A Control Center nem kezeli ezeket.

Annak korlátozása, mely szolgáltatókat használhat egy munkaterület

Szekció neve “Annak korlátozása, mely szolgáltatókat használhat egy munkaterület”

A szolgáltatók szabályozása munkaterületenként történik, és kiértékelése az utolsó egyezés nyer elven működik.

  1. A Szolgáltatók és modellek alatt kapcsolja ki egy szolgáltató sorában az Engedélyezés kapcsolót

Ezzel egy deny utasítás íródik az adott szolgáltatóhoz az aktív munkaterületen, és a modelljei kiesnek annak a munkaterületnek a katalógusából. A kapcsoló visszakapcsolása eltávolítja az utasítást.

Egy futtató nem találhatóként jelenik meg

Szekció neve “Egy futtató nem találhatóként jelenik meg”
  • Ellenőrizze, hogy a CLI a szervergép PATH-jában szerepel-e, nem csak az Önében
  • A grafikus felületről indított asztali alkalmazás minimális PATH-tal indítja a szerverét; egy csak shellből elérhető útvonalra telepített CLI láthatatlan lehet számára
  • Telepítés után nyomja meg a Frissítés gombot
  • A beépített adapter van kiválasztva, és nincs csatlakoztatva szolgáltató — csatlakoztasson egyet a Szolgáltatók és modellek alatt
  • Vagy a szolgáltató csatlakoztatva van, de a munkaterület szabályozási kapcsolója tiltja

A modell fut, de az ár ismeretlenként jelenik meg

Szekció neve “A modell fut, de az ár ismeretlenként jelenik meg”

Az élő modellista hordozza az azonosítót; az árat és a kontextust a models.dev adja. Egy vadonatúj modellnek vagy egy egyéni szolgáltatótól származó modellnek még nincs bejegyzése a katalógusban.