Lewati ke konten utama

Gunakan Agen Koding Terpasang sebagai Model Chat

Jika Anda sudah membayar agen koding dan agen masuk di komputer Libre WebUI, gunakan melalui chat biasa tanpa kunci API tambahan. Libre WebUI mendeteksi CLI dan menampilkannya di pemilih model.

Yang Dideteksi​

ModelPerintahPenyedia
Claude CodeclaudeAnthropic
CodexcodexOpenAI
OpenCodeopencodeSST
PipiMario Zechner

Perintah dicari di PATH server dan muncul dalam Agents. Tidak ada instalasi tambahan.

Pengaturan → Chat → Bawaan juga menandai entri ini sebagai Agen, termasuk Strands jika akun Anda boleh menggunakannya. Model plugin tetap memakai nama penyedia; hanya Ollama mendapat label Ollama. Mematikan Ollama tidak menyembunyikan agen atau plugin. Kartu informasi menampilkan nama dan penyedia, serta ukuran, keluarga, dan format hanya jika katalog menyediakannya.

Memilih Model​

Setiap CLI dapat menyediakan beberapa pilihan dalam grup Agen:

  • Claude Code: bawaan, Sonnet, Opus, Haiku. Tersedia pula pilihan eksplisit Sonnet 5.5 (claude-sonnet-5-5) dan Opus 5.5 (claude-opus-5-5). Sonnet 5.5 memerlukan Claude Code 2.1.284 atau yang lebih baru, dan Opus 5.5 memerlukan Claude Code 2.1.280 atau yang lebih baru, keduanya dengan akses melalui akun yang masuk; jalankan claude update untuk memperbarui CLI. Alias Sonnet dan Opus yang ada tetap mengikuti pemetaan model CLI saat ini.
  • Codex: bawaan, 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, GPT-5.3 Codex Spark. Ketersediaan bergantung pada sesi masuk CLI dan akses akun.
  • Pi: model CLI.
  • OpenCode: model penyedia dari opencode models.

Mesin Strands tertanam juga muncul di grup Agen jika akun Anda boleh menggunakannya. Mesin ini bukan CLI: mesin berjalan di dalam backend dan menjalankan model Ollama serta plugin penyedia Anda. Entri Strands biasa (strands) memakai model chat default Anda. Entri lainnya (strands:<route>) tercantum satu per model yang tersedia, misalnya Strands · gpt-5.6-sol (Codex (ChatGPT)), dan mengunci model beserta penyedianya untuk percakapan itu; penyedia lain yang tersedia tidak dapat menggantikannya saat terjadi gangguan. Menampilkan daftar pilihan tidak menyalakan mesin.

Entri Strands yang sama dapat menjadi model tugas di Pengaturan → Chat → Bawaan untuk judul otomatis dan ringkasan penalaran. Gunakan model yang sedang berjalan memakai pilihan Strands yang tersimpan di percakapan. Permintaan teks singkat ini memanggil model penyedia yang mendasarinya secara langsung; permintaan ini tidak menjalankan alat agen atau membuat sesi agen. Profil CLI lain memerlukan model tugas Ollama, plugin, atau Strands untuk permintaan tambahan tersebut.

Pi berjalan tanpa status (--no-session), alat lokal mati, dan perintah sistem netral.

Penggunaan​

  1. Masuk sebagai admin.
  2. Buka pemilih model.
  3. Pilih Agents.
  4. Kirim pesan.

Percakapan disimpan seperti chat lain dan tiap giliran mengirim riwayat terbaru ke agen.

Siapa yang dapat memakai dan apa yang dapat diakses​

Fitur ini khusus administrator karena agen berjalan sebagai pengguna OS yang sama dengan backend Libre WebUI, pada host, bukan kontainer Work. Ia mewarisi kredensial serta akses normal agen, termasuk membaca berkas dan menjalankan perintah di server jika diperlukan.

Mengaktifkannya setara dengan memberikan akses shell ke komputer. Karena itu fitur dinonaktifkan secara default dan harus diaktifkan administrator di Pengaturan → Manajemen Pengguna → Akses dan kebijakan → Model agen CLI. Pilihan disimpan dan langsung berlaku tanpa restart.

Mengubah kontrol ini langsung menyegarkan katalog model. Kategori Agen berisi entri CLI langsung, sedangkan Model Plugin berisi integrasi API penyedia seperti Codex (ChatGPT). Strands tercantum di kategori yang sama, tetapi mengikuti pengaturan akses Mesin Strands miliknya sendiri, bukan sakelar ini, sehingga Strands dapat muncul saat model agen CLI mati. Penemuan modelnya tidak dapat menghalangi penemuan agen CLI yang terpasang.

Instalasi lama mewarisi pilihan Agen terdahulu sampai pengaturan CLI independen disimpan.

Untuk mengunci pilihan pada tingkat penerapan, tanpa mengikuti kontrol runtime, tetapkan variabel lingkungan ke salah satu nilai berikut. Ini juga mengunci sakelar UI:

AGENT_CLI_MODELS_ENABLED=false   # or true

Jika model perlu mengolah berkas namun tetap dalam sandbox, gunakan Work: model berkemampuan alat berjalan di kontainer terkunci dengan ruang terisolasi.

Pencatatan penggunaan​

Buka Penggunaan Penyedia (/usage) dan temukan Agen di bagian atas. Claude Code, Codex, OpenCode, Pi, serta Strands memiliki entri terpisah dan pesan jelas jika periode itu tanpa catatan.

Panggilan CLI lewat LWUI mencatat hasil, durasi, dan token yang dilaporkan. Satu pemanggilan menghasilkan satu event; snapshot atau laporan langkah berulang tidak menggandakan event dan token. Penghitung yang hilang tetap tidak dilaporkan. Menghentikan respons dicatat sebagai pembatalan, dan exit gagal tidak menjadi sukses hanya karena ada teks parsial. Panggilan di luar LWUI tidak diimpor.

Panggilan Strands dicatat atas nama agen Strands. Lihat Penggunaan agen untuk rincian dan batasnya.

Konfigurasi​

VariabelBawaanTujuan
AGENT_CLI_MODELS_ENABLEDtidak disetelPaksa true/false; jika kosong memakai sakelar admin
AGENT_CLI_TIMEOUT_MS600000Batas giliran

Pemecahan Masalah​

Grup Agen tidak muncul. Pastikan fitur aktif di Pengaturan → Manajemen Pengguna → Akses dan kebijakan → Model agen CLI (default nonaktif) dan Anda masuk sebagai administrator. Perintah harus ada di PATH proses backend, bukan hanya shell interaktif. Manajer layanan, kontainer Docker, atau peluncur desktop sering memakai PATH yang lebih sempit daripada terminal login.

Jawaban langsung gagal. Jalankan (claude -p "hello" atau codex exec "hello") sebagai pengguna server. Perbarui masuk dengan opencode auth login bila perlu.

Jawaban terhenti. Naikkan AGENT_CLI_TIMEOUT_MS atau pecah permintaan.

Terkait​