BotConnector
warning
Referensi managed-runtime legacy. Contoh command di bawah berasal dari desktop/managed llama.cpp preview lama dan bersifat legacy, bukan permukaan command BCCLI v0.4 saat ini. Gunakan BCCLI dan AI Lokal untuk instruksi terkini.

Masalah API

Connection refused

  1. Apakah server berjalan? botconnector server status
  2. Mulai: botconnector server start (botconnector server)
  3. Konfirmasi port: default 11435 — --port kustom mengubah semua URL.

404 pada model

Field model harus sama dengan id model yang dimuat:

powershell
botconnector ps --json

Gunakan persis id itu dalam permintaan. Model yang diunduh tapi belum dimuat tidak dilayani.

401 / error otorisasi

  • --api-key diatur saat server start; kirim Authorization: Bearer <key> — Autentikasi.
  • Key dirotasi? Perbarui semua klien.

Port salah / proses usang

  • botconnector ps menampilkan apa yang benar-benar berjalan.
  • Instance sebelumnya mungkin memegang port — hentikan atau pakai port lain dan perbarui klien.

Gagal dari perangkat lain

Localhost hanya mengikat mesin ini. Akses remote membutuhkan binding + auth eksplisit — lihat Pengikatan jaringan dan Remote.

Respons rusak / menggantung

  • Verifikasi dengan permintaan mentah:
bash
curl http://127.0.0.1:11435/v1/models
  • Jika curl bekerja tapi klien gagal, base URL klien kemungkinan salah (kehilangan /v1 adalah error paling umum).
  • Klien streaming: pastikan penanganan SSE — Streaming.