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:
| Model | Příkaz | Poskytuje |
|---|---|---|
| Claude Code | claude | Anthropic |
| Codex | codex | OpenAI |
| OpenCode | opencode | SST |
| Pi | pi | Mario Zechner |
Nalezené položky se zobrazí ve skupině Agents. Nic se za vás neinstaluje a není třeba konfigurační soubor — funguje-li příkaz v shellu serveru, položka se zobrazí.
Volíte model, nikoli jen CLI
- Claude Code nabízí výchozí model přihlášeného účtu a Sonnet, Opus a Haiku.
- Codex nabízí nakonfigurovaný výchozí model a dokumentovanou rodinu přihlášení ChatGPT: GPT-5.6 Sol, Terra, Luna a GPT-5.3 Codex Spark.
- 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.
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í
- Přihlaste se jako administrátor.
- Spusťte chat a otevřete výběr modelu.
- Zvolte položku ve skupině Agents.
- 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 Settings → User Management → Agents. Nastavení se uloží a platí okamžitě bez restartu.
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.
Konfigurace
| Proměnná | Výchozí | Účel |
|---|---|---|
AGENT_CLI_MODELS_ENABLED | nenastaveno | Zamkne funkci na true/false; jinak platí administrátorský přepínač |
AGENT_CLI_TIMEOUT_MS | 600000 | Maximální délka jednoho tahu agenta před ukončením |
Řešení problémů
Skupina Agents se nezobrazuje. Ověřte zapnutí v Settings → User Management → Agents, 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.