Ugrás a fő tartalomra

Telepített kódolóügynök használata Chat-modellként

Ha már előfizet egy kódolóügynökre, és be van jelentkezve a Libre WebUI gépén, külön API-kulcs nélkül beszélgethet vele egy normál Chatben. A Libre WebUI felismeri a CLI-t, és felkínálja a modellválasztóban.

Mit ismer fel a rendszer?​

A Libre WebUI minden modell-listázási kérésnél megkeresi a szerver PATH változójában:

ModellParancsSzolgáltató
Claude CodeclaudeAnthropic
CodexcodexOpenAI
OpenCodeopencodeSST
PipiMario Zechner

Minden megtalált elem megjelenik az Agents csoportban. A rendszer nem telepít semmit, és nincs szükség konfigurációs fájlra; ha a parancs működik a szerver felhasználójának shelljében, megjelenik.

A Settings → Chat → Defaults ezeket a bejegyzéseket is Agent jelöléssel mutatja, a Strandst is, ha az Ön fiókja használhatja. A pluginmodellek megőrzik a szolgáltató nevét; Ollama jelölést csak Ollama-modellek kapnak. Az Ollama kikapcsolása nem rejti el a konfigurált ágenseket vagy pluginokat. Az információs kártya a megjelenítési nevet és szolgáltatót mutatja; méretet, családot és formátumot csak akkor, ha a katalógus közli.

Modellválasztás, nem csak CLI-választás​

  • A Claude Code a bejelentkezett fiók alapértékét, valamint a Sonnet, Opus és Haiku modelleket kínálja. Külön Sonnet 5.5 (claude-sonnet-5-5) és Opus 5.5 (claude-opus-5-5) választási lehetőség is elérhető. A Sonnet 5.5-höz Claude Code 2.1.284 vagy újabb szükséges, az Opus 5.5-höz Claude Code 2.1.280 vagy újabb, mindkettőhöz a bejelentkezett fiókon keresztüli hozzáféréssel; a CLI frissítéséhez futtassa a claude update parancsot. A meglévő Sonnet és Opus aliasok továbbra is a CLI aktuális modelltérképét követik.
  • A Codex az alapértéket és a dokumentált ChatGPT-családot kínálja: GPT-6 Astra, GPT-6.1 Sol (gpt-6.1-sol), GPT-6 Sol, GPT-6 Luna, GPT-5.6 Sol, Terra, Luna, GPT-5.5 és GPT-5.3 Codex Spark. Az elérhetőség a CLI bejelentkezésétől és a fiók hozzáférésétől függ.
  • A Pi a CLI modelljét használja.
  • Az OpenCode minden hitelesített szolgáltató modelljeit felsorolja (az opencode models kimenetéből), és kifejezett választást igényel. A CLI alapértéke olyan helyi szerverre mutathat, amelyet a Libre WebUI nem ér el.

A beépített Strands motor is megjelenik az Agents csoportban, ha az Ön fiókja használhatja. Ez nem CLI: a backenden belül fut, és az Ön Ollama- és szolgáltatói bővítménymodelljeit használja. A sima Strands bejegyzés (strands) az Ön alapértelmezett chatmodelljét használja. A többi bejegyzés (strands:<route>) minden elérhető modellhez egyet listáz, például Strands · gpt-5.6-sol (Codex (ChatGPT)), és a modellt és a szolgáltatóját is rögzíti az adott beszélgetéshez; kieséskor más elérhető szolgáltató nem helyettesítheti. A lehetőségek listázása nem indítja el a motort.

Ugyanezek a Strands-bejegyzések a Settings → Chat → Defaults feladatmodelljeiként is használhatók automatikus címekhez és gondolkodási összefoglalókhoz. A Use current running model a beszélgetés mentett Strands-választását használja. Ezek a rövid szöveges kérések közvetlenül a mögöttes szolgáltatói modellt hívják; nem futtatják az ágens eszközeit, és nem hoznak létre ágens-munkamenetet. Más CLI-profilok e segédkérésekhez Ollama-, plugin- vagy Strands-feladatmodellt igényelnek.

A Pi minden fordulót állapot nélkül futtat (--no-session), letiltott helyi eszközökkel és semleges rendszerprompttal, így a válaszokat nem befolyásolja a szerverfelhasználó személyes Pi-beállítása.

Használat​

  1. Jelentkezzen be rendszergazdaként.
  2. Indítson beszélgetést, és nyissa meg a modellválasztót.
  3. Válasszon az Agents csoportból.
  4. Küldjön üzeneteket a szokásos módon; a válasz tokenenként érkezik.

A beszélgetést a rendszer minden más Chathez hasonlóan menti, folytatható, átnevezhető és kereshető. Minden forduló elküldi a közelmúltbeli átiratot az ügynöknek.

Ki használhatja, és mihez fér hozzá?​

A funkció csak rendszergazdák számára érhető el. Az ügynök a hoston fut a backenddel azonos operációsrendszer-felhasználóként, nem Work-konténerben. Örökli az ügynök hitelesítő adatait és a szokásos hozzáférést, amely fájlolvasást és szerverparancsok futtatását is magában foglalhatja.

Az engedélyezése shell-hozzáférés biztosításával egyenértékű. Ezért letiltva érkezik, és a Settings → User Management → Access & policies → Agent CLI models alatt kapcsolható be. A beállítás tárolódik, és újraindítás nélkül azonnal érvényesül.

E vezérlő módosítása azonnal frissíti a modellkatalógust: az Agents kategória a közvetlen CLI-bejegyzéseket, a Plugin Models pedig a szolgáltatói API-integrációkat, például a Codex (ChatGPT) szolgáltatót tartalmazza. A Strands ugyanebben a kategóriában szerepel, de a saját Strands motor hozzáférési beállítását követi, nem ezt a kapcsolót, így akkor is megjelenhet, ha az Agent CLI modellek ki vannak kapcsolva. A modelljeinek felderítése nem akadályozhatja a telepített CLI-ágensek felismerését.

A meglévő telepítések az önálló CLI-beállítás mentéséig öröklik a korábbi Agents-választást.

A telepítési konfigurációban (és a felületi kapcsolóban) így zárolhatja a döntést:

AGENT_CLI_MODELS_ENABLED=false   # or true

Fájlokkal dolgozó, de sandboxban maradó modellhez használja a Work funkciót.

Használatkövetés​

Nyissa meg a Provider Usage (/usage) oldalt, és keresse felül az Agents részt. A Claude Code, Codex, OpenCode, Pi és a Strands külön bejegyzést kap, egyértelmű jelzéssel, ha az időszakban nincs rögzített hívás.

Az LWUI-n keresztüli CLI-hívások rögzítik az eredményt, időtartamot és jelentett tokeneket. Minden indítás egy esemény; az ismételt pillanatképek és lépésjelentések nem kettőzik meg az eseményeket vagy tokeneket. A hiányzó számlálók ismeretlenek maradnak. A válasz leállítása megszakításként szerepel; egy hibás CLI-kilépés nem válik sikeressé a részleges szövegtől. Az LWUI-n kívüli hívásokat nem importáljuk.

A Strands-hívások a Strands ágenshez tartoznak. Részletek és korlátok: Ágenshasználat.

Beállítás​

VáltozóAlapértékCél
AGENT_CLI_MODELS_ENABLEDunsettrue/false zárolás; egyébként rendszergazdai kapcsoló
AGENT_CLI_TIMEOUT_MS600000Egy forduló maximális időtartama a leállítás előtt

Hibaelhárítás​

Az Agents nem jelenik meg. Ellenőrizze, hogy engedélyezve van-e a Settings → User Management → Access & policies → Agent CLI models alatt, rendszergazdaként jelentkezett-e be, és a parancs a backendfolyamat PATH változójában van-e, nem csak az interaktív shellben. A szolgáltatáskezelők, Docker és asztali indítók gyakran rövidebb PATH értéket használnak.

A válasz azonnal hibára fut. Futtassa kézzel a szerver felhasználójaként (claude -p "hello" vagy codex exec "hello"). Gyakori ok a lejárt bejelentkezés vagy a rate limit. Az OpenCode a lejáratot csak a saját naplóiban jelzi; futtassa újra az opencode auth login parancsot a szerver felhasználójaként.

A válasz leáll. Egy hosszú forduló elérhette az AGENT_CLI_TIMEOUT_MS értéket. Növelje meg, vagy bontsa fel a kérést.

Kapcsolódó dokumentáció​