Přeskočit na hlavní obsah

Použití nainstalovaného programovacího agenta jako chatového modelu

Pokud již platíte za programovacího agenta a jste k němu přihlášeni na stroji s Libre WebUI, můžete s ním mluvit z běžného chatu bez přidávání samostatného API klíče. Libre WebUI rozpozná jeho příkazové rozhraní a nabídne jej ve výběru modelu.

Co se rozpoznává​

Při každém požadavku na seznam modelů hledá Libre WebUI v serverovém PATH tyto příkazy:

ModelPříkazPoskytuje
Claude CodeclaudeAnthropic
CodexcodexOpenAI
OpenCodeopencodeSST
PipiMario Zechner

Nalezené položky se zobrazí ve skupině Agenti. Nic se za vás neinstaluje a není třeba konfigurační soubor. Pokud příkaz funguje v shellu serveru, položka se zobrazí.

Nastavení → Chat → Výchozí nastavení také označuje tyto položky jako Agent, včetně Strands, pokud ho váš účet smí používat. Modely pluginů zachovávají název poskytovatele; označení Ollama mají jen modely Ollama. Vypnutí Ollama neskrývá nastavené agenty ani pluginy. Informační karta modelu ukazuje zobrazovaný název a poskytovatele, velikost, rodinu a formát jen tehdy, když je katalog poskytne.

Volíte model, nikoli jen CLI​

  • Claude Code nabízí výchozí model přihlášeného účtu a Sonnet, Opus a Haiku. K dispozici jsou také explicitní volby Sonnet 5.5 (claude-sonnet-5-5) a Opus 5.5 (claude-opus-5-5). Sonnet 5.5 vyžaduje Claude Code 2.1.284 nebo novější a Opus 5.5 vyžaduje Claude Code 2.1.280 nebo novější, obojí s přístupem prostřednictvím přihlášeného účtu; CLI aktualizujete příkazem claude update. Stávající aliasy Sonnet a Opus nadále používají aktuální mapování modelů CLI.
  • Codex nabízí nakonfigurovaný výchozí model a dokumentovanou rodinu přihlášení ChatGPT: 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 a GPT-5.3 Codex Spark. Dostupnost závisí na přihlášení CLI a přístupu účtu.
  • Pi používá model nakonfigurovaný přímo v CLI.
  • OpenCode vypíše modely všech ověřených poskytovatelů (z opencode models) a vždy vyžaduje explicitní volbu. Výchozí hodnota CLI může ukazovat na místní server, ke kterému se hostitel Libre WebUI nedostane.

Vestavěný engine Strands se ve skupině Agenti zobrazí také, pokud ho váš účet smí používat. Nejde o CLI: běží uvnitř backendu a pohání vaše modely Ollama a modely pluginů poskytovatelů. Samotná položka Strands (strands) používá váš výchozí chatový model. Ostatní položky (strands:<route>) nabízejí po jedné každý dostupný model, například Strands · gpt-5.6-sol (Codex (ChatGPT)), a připnou ke konverzaci model i jeho poskytovatele; při výpadku je nenahradí jiný dostupný poskytovatel. Načtení seznamu voleb engine nespouští.

Stejné položky Strands lze použít jako model úloh v Nastavení → Chat → Výchozí nastavení pro automatické názvy a souhrny uvažování. Použít aktuálně spuštěný model použije uloženou volbu Strands konverzace. Tyto krátké textové požadavky volají přímo podkladový model poskytovatele, bez nástrojů agenta či nové relace agenta. Jiné profily CLI pro ně vyžadují model úloh Ollama, pluginu nebo Strands.

Pi spouští každý tah bez stavu (--no-session), s vypnutými místními nástroji a neutrálním systémovým promptem, takže odpovědi neovlivňuje osobní konfigurace Pi systémového uživatele serveru.

Použití​

  1. Přihlaste se jako administrátor.
  2. Spusťte chat a otevřete výběr modelu.
  3. Zvolte položku ve skupině Agenti.
  4. Odesílejte zprávy běžným způsobem; odpověď se streamuje token po tokenu.

Konverzace se ukládá jako každý jiný chat, takže ji lze opustit, vrátit se, přejmenovat a vyhledat. Každý tah posílá agentovi výpis nedávné konverzace.

Kdo může funkci používat a kam agent dosáhne​

Funkce je pouze pro administrátory. Agent běží na hostiteli pod stejným systémovým uživatelem jako backend Libre WebUI, nikoli v kontejneru Work. Dědí proto přihlašovací údaje agenta a běžný přístup uživatele, včetně možnosti číst soubory a spouštět příkazy na serveru.

Zapnutí odpovídá udělení shellového přístupu agentovi. Funkce je proto ve výchozím stavu vypnutá a administrátor ji musí zapnout v Nastavení → Správa uživatelů → Přístup a zásady → Modely agentů CLI. Nastavení se uloží a platí okamžitě bez restartu.

Změna tohoto přepínače ihned obnoví katalog modelů: kategorie Agenti obsahuje přímé položky CLI, kategorie Modely pluginů integrace API poskytovatelů, například Codex (ChatGPT). Strands je uveden ve stejné kategorii, ale řídí se vlastním nastavením přístupu Engine Strands, ne tímto přepínačem, takže se může zobrazit i při vypnutých modelech agentů CLI. Jeho zjišťování modelů nemůže zablokovat hledání nainstalovaných agentů CLI.

Existující instalace dědí dřívější uloženou volbu Agentů, dokud se neuloží nezávislé nastavení CLI.

Rozhodnutí lze zamknout na úrovni nasazení (a tím zamknout přepínač v rozhraní) pomocí:

AGENT_CLI_MODELS_ENABLED=false   # or true

Pro model, který smí pracovat se soubory, ale má zůstat v sandboxu, použijte Work.

Sledování využití​

Otevřete Využití poskytovatelů (/usage) a nahoře najděte Agenti. Claude Code, Codex, OpenCode, Pi a Strands mají samostatné položky, včetně jasné informace, když za období nejsou zaznamenána volání.

Volání CLI přes LWUI ukládají výsledek, délku a hlášené tokeny. Každé spuštění vytváří jednu událost; opakované snímky a hlášení jednotlivých kroků nezdvojují události ani tokeny. Chybějící počítadla zůstávají nehlášená. Zastavení odpovědi se zapíše jako zrušení; neúspěšné ukončení CLI se nestane úspěchem kvůli částečnému textu. Volání mimo LWUI se neimportují.

Volání Strands se přiřazují agentovi Strands. Rozdělení a omezení popisuje Využití agentů.

Konfigurace​

ProměnnáVýchozíÚčel
AGENT_CLI_MODELS_ENABLEDnenastavenoZamkne funkci na true/false; jinak platí administrátorský přepínač
AGENT_CLI_TIMEOUT_MS600000Maximální délka jednoho tahu agenta před ukončením

Řešení problémů​

Skupina Agents se nezobrazuje. Ověřte zapnutí v Nastavení → Správa uživatelů → Přístup a zásady → Modely agentů CLI, přihlášení administrátora a to, že příkaz je v PATH procesu backendu, nikoli jen vašeho interaktivního shellu. Správci služeb, Docker nebo desktopové spouštěče často používají kratší PATH.

Odpověď okamžitě selže. Spusťte stejný příkaz ručně pod serverovým uživatelem (claude -p "hello" nebo codex exec "hello"). Nejčastější příčinou je vypršené přihlášení nebo limit předplatného. OpenCode hlásí vypršení přihlášení poskytovatele pouze ve vlastních logách; spusťte pod serverovým uživatelem znovu opencode auth login.

Odpověď se zastaví. Dlouhý tah mohl dosáhnout AGENT_CLI_TIMEOUT_MS. Limit zvyšte nebo požadavek rozdělte.

Související​