Halaman AI Models menentukan model AI mana yang boleh dipakai organization dan model mana yang menjalankan setiap fitur platform secara default. Organization yang diizinkan Qlar membawa model AI sendiri juga menghubungkan key provider dan gateway miliknya di sini. Untuk panduan langkah demi langkah, lihat Memakai API Key Sendiri dan Menghubungkan Gateway. Buka dengan tile AI Models di halaman menu organization.
Akses
| |
|---|
| Owner/Admin | Bisa melihat dan mengubah semua yang ada di halaman ini. |
| Role Lain | Tile AI Models tidak ditampilkan. Membuka halaman lewat alamatnya menampilkan "Only organization Owners and Admins can open AI Models." |
Tab
Halaman ini punya tiga tab. Tab yang terbuka disimpan di alamat (?tab=models, ?tab=sources, ?tab=defaults), sehingga refresh atau tombol Back browser kembali ke tab yang sama.
| |
|---|
| Models | Semua model yang bisa dipakai organization, beserta switch-nya. Terbuka secara default. |
| Sources | Gateways dan API keys provider milik organization. Hanya tampil untuk organization yang diizinkan membawa model AI sendiri atau memakai gateway (dan, selama gateway dimatikan, untuk organization yang masih punya gateway); di organization lain ?tab=sources membuka Models. |
| Defaults | Model mana yang menjalankan setiap fitur. |
| Di ponsel | Lebar layar dibagi rata untuk ketiga tab. |
Banner Gateway Offline
Di atas tab, satu peringatan untuk setiap gateway yang offline selagi modelnya menyala: "Office PC is offline, so sonnet-office can't answer right now." Ditambah "It powers the default for …" bila salah satu model itu menjadi default fitur. Bring it back online membuka panel Bring it back online gateway tersebut di Sources.
Tab Models
Model dikelompokkan menurut asalnya. Setiap baris menampilkan alias model, deskripsi satu baris, chip untuk apa yang diterima dan dihasilkannya (misalnya Image in, Document in, Audio out, atau Text only), dan sebuah switch.
| |
|---|
| Chip filter | All, Qlar, API key, dan Gateway, masing-masing dengan jumlah modelnya. API key hanya tampil bila organization boleh membawa key sendiri, Gateway hanya bila organization boleh memakai gateway. |
| Search models | Menyaring baris berdasarkan alias atau deskripsi. |
| Qlar | Model bawaan, ditagih dengan credit Qlar. Deskripsinya memuat pengali credit, misalnya "3× credits". |
| Your API keys | Model yang diakses dengan key provider milik organization. Tidak ada credit Qlar yang ditagih untuk model ini. Add API key membuka dialog Add / Edit API Key. |
| Your gateways | Model di gateway milik organization. Tidak ada credit Qlar yang ditagih untuk model ini. Connect a gateway membuka wizard Connect a Gateway. Setiap baris menampilkan tool dan modelnya, lalu tempat model itu berjalan: ● Office PC saat online, ○ Office PC, offline 3 h ago saat tidak, atau Office PC · not offered by this computer bila komputer itu tidak lagi menawarkan model tersebut. |
| Switch | Menyalakan atau mematikan model untuk organization. Model yang dimatikan disembunyikan dari semua agent. |
| Chip Default | Default diikuti fitur yang dijalankan model ini, misalnya "Default · Conversation". |
| Switch Terkunci | Model Qlar yang menjadi default sebuah fitur tidak bisa dimatikan. Ganti dulu default fitur tersebut; tooltip menyebutkan fiturnya. |
| Di ponsel | Baris hanya menampilkan nama, deskripsi, dan switch. Ketuk baris untuk membuka panel berisi chip kapabilitas dan default-nya; Close menutupnya. |
Tab Sources
Tab ini punya dua bagian, Gateways dan API keys. Masing-masing hanya tampil bila organization boleh memakainya; Gateways juga tetap tampil selama gateway dimatikan untuk organization yang masih punya gateway.
Gateways
| |
|---|
| Connect a gateway | Membuka wizard Connect a Gateway menggantikan daftar. |
| Dimatikan | "Gateways are turned off for this organization, so their models can't be used. Everything comes back as it was when Qlar turns them on again. You can still remove a gateway." Kartu hanya bisa dibaca dan hanya menawarkan Remove. |
| Empty State | No gateways yet. Hubungkan sebuah komputer untuk memakai akun Claude atau ChatGPT Anda sebagai ganti credit Qlar. |
| Kartu | Nama gateway, chip status, ● Online atau ○ Offline · last seen …, lalu nama komputer, sistem, versi gateway, dan "n of 2 jobs running", satu chip per tool beserta cara sign-in-nya (misalnya Claude Code · subscription (Max)), dan modelnya. |
| Menu ⋯ | Rename, Move to another computer (gateway yang sudah disetujui), dan Remove…. |
Status kartu dan tombol yang ditawarkannya:
| Chip status | Arti | Tombol |
|---|
| Connected · ● Online | Sudah disetujui dan berjalan. | Models · n: menambah atau menghapus modelnya. |
| Connected · ○ Offline | Sudah disetujui, tetapi tidak berjalan atau tidak terjangkau. | Bring it back online |
| Waiting for the command to run | Perintah penyiapan belum melapor. Kodenya tidak bisa ditampilkan lagi. | Get a new code |
| Code expired | Perintah tidak dijalankan dalam 15 menit. | Get a new code |
| Waiting for your approval | Gateway sudah enrolment; fingerprint-nya menunggu persetujuan. | Review fingerprint |
| Moving to a new computer | Pemindahan menunggu perintahnya dijalankan di komputer baru. Komputer saat ini tetap bekerja. | Get a new code |
| New computer waiting for approval | Komputer baru sudah enrolment; komputer saat ini tetap bekerja sampai Anda menyetujuinya. | Review fingerprint |
| Move: code expired | Kode untuk komputer baru kedaluwarsa sebelum dipakai. | Get a new code |
| Revoked | Gateway tidak bisa terhubung lagi. | Remove |
| No longer registered | Layanan gateway tidak lagi mengenal gateway ini. | Remove |
| Status unavailable | Qlar tidak bisa menjangkau layanan gateway untuk memeriksanya. | Retry |
Bring it back online
Dibuka dari kartu yang offline atau dari banner offline.
| |
|---|
| Same computer | Perintah untuk menjalankannya lagi: qlar-inference-gateway run di terminal, atau perintah restart untuk service (Windows schtasks /Run /TN "Qlar Inference Gateway", macOS launchctl kickstart -k gui/$(id -u)/ai.qlar.inference-gateway, Linux sudo systemctl restart qlar-inference-gateway), serta perintah install-service agar tetap jalan setelah restart berikutnya. Kartunya berubah hijau begitu gateway melapor. |
| New or reset computer | Get a new code memulai pemindahan ke komputer lain. Model, agent yang memakainya, dan pengaturannya tetap seperti semula. |
API keys
| |
|---|
| API keys | Satu kartu per key: alias, lalu provider, nama model atau deployment, endpoint, key yang disamarkan, dan "turned off" bila modelnya dimatikan di Models. |
| Add API key | Membuka dialog Add / Edit API Key. |
| Edit | Membuka dialog yang sama untuk key tersebut, dengan tombol Delete. |
| Empty State | No API keys yet. |
Wizard Connect a Gateway
Terbuka menggantikan daftar Sources, berjudul Connect a gateway (Move nama to another computer saat memindahkan, Models on nama saat menambah model), dengan "Step n of 4" dan progress bar. × menutupnya; penyiapan dilanjutkan dari kartu gateway. Refresh tetap membuka wizard (?gateway= di alamat).
| Langkah | Field dan tombol |
|---|
| 1 Where | Name (wajib, maksimal 100 karakter, ditampilkan ke tim Anda di daftar model) dan Where will it run?: Windows (Windows 10 atau 11, x64), macOS (Apple silicon), Linux (x64 atau arm64). Create code membuat gateway dan kode sekali pakai yang kedaluwarsa setelah 15 menit. |
| 2 Run | Perintah untuk sistem yang dipilih, dengan tautan untuk beralih ke sistem lain. Copy command; di ponsel atau bila berbagi didukung, Send to my computer…. One-time code dengan tombol salinnya sendiri, dan perintah enroll yang lebih pendek untuk komputer yang sudah punya gateway. Hitung mundur selama menunggu gateway melapor. Get a new code bila kode kedaluwarsa atau halaman dimuat ulang. Cancel menghapus gateway yang belum pernah disetujui. |
| 3 Confirm | A gateway has enrolled — confirm it is yours: nama komputer, sistem, dan versi gateway, serta Key fingerprint (SHA-256) dalam 4 baris berisi 4 grup. Fingerprint matches — approve, atau It doesn't match — cancel. Bila key berubah selagi Anda membandingkan, Show the new fingerprint. |
| 4 Sign in | Cara setiap tool sign-in (subscription, API key, not signed in beserta perintah yang perlu dijalankan, atau Waiting for sign-in…), lalu Choose models to make available: kotak centang dan nama untuk setiap model. Nama memakai huruf kecil, angka, ., _, atau -, tanpa +, dan tidak boleh sama dengan model lain. Model dari tool yang belum sign-in menampilkan "sign in to use it". Keep it running after a restart menampilkan perintah install-service untuk sistemnya. Finish menambahkan model yang dicentang; Skip for now menutup tanpa menambah. |
Dialog Rename dan Remove Gateway
| |
|---|
| Rename nama | Name (maksimal 100 karakter). Save. Hanya nama di Qlar yang berubah. |
| Remove nama? | Menjelaskan bahwa gateway diputus dan tidak bisa dipakai lagi, dan menyebutkan modelnya. Lalu apa lagi yang berubah: fitur yang default-nya kembali ke default Qlar (yang memakai credit Qlar), agent yang modelnya kembali ke default organization, dan agent yang panggilan voice-nya berhenti sampai voice lain dipilih (tidak pindah ke voice Qlar). Keep it atau Remove gateway. Gateway yang belum pernah disetujui langsung dihapus tanpa dialog ini. |
Dialog Add / Edit API Key
Judul dialog adalah Add custom model saat menambah dan Edit "alias" saat mengedit: setiap entri API key adalah satu model yang diakses dengan key tersebut.
| |
|---|
| Alias | Wajib diisi. Nama model di CMS. Harus unik dan tidak boleh sama dengan alias predefined. Tidak bisa diubah setelah dibuat. |
| Provider | OpenAI, Azure OpenAI, Azure AI Inference, atau DeepSeek. |
| Invocation method | Chat Completion atau Response API. DeepSeek hanya mendukung Chat Completion. |
| Native model name | Nama model dari provider, misalnya gpt-4o-mini. Wajib kecuali deployment name diisi. |
| Deployment name | Khusus provider Azure. |
| Endpoint | Wajib untuk provider Azure. Opsional untuk DeepSeek, yang default-nya https://api.deepseek.com. |
| Response API endpoint | Khusus Azure AI Inference. |
| API key | Wajib saat menambah. Saat mengedit, kosongkan untuk mempertahankan key yang ada. |
| Short description | Ringkasan opsional yang ditampilkan ke pengguna. |
| Estimated credit ratio | Opsional. Biarkan 0 bila tidak diketahui. |
| Capabilities | Switch untuk Input (Image, Audio, Video, Document) dan Output (Image, Audio, Video). Atur berdasarkan dokumentasi model itu sendiri; kapabilitas tidak bisa dideteksi otomatis. |
| Document types | Tampil bila input Document menyala. Minimal satu dari PDF, DOCX, CSV, TXT, XLSX, PPTX wajib dipilih. |
| Delete | Khusus edit. Menanyakan "Delete this model?"; Yes, delete menghapusnya. |
| Create / Save | Membuat atau memperbarui model. |
Tab Defaults
Di bawah Feature defaults, pilih model yang menjalankan setiap fitur. Hanya model yang menyala untuk organization yang ditawarkan, dikelompokkan per sumber; model gateway tertulis "alias · nama gateway", dengan "(offline)" selama gateway-nya offline. Model gateway tidak ditawarkan untuk KB Training. Default yang modelnya tidak bisa dipakai saat ini (gateway dimatikan, model dihapus) menampilkan "alias is not available — using the Qlar default". Biarkan sebuah fitur kosong untuk mewarisi default platform, yang ditampilkan sebagai placeholder. Setiap perubahan langsung tersimpan.
| |
|---|
| Conversation | Model default untuk percakapan. |
| Summarization | Model default untuk peringkasan. |
| Personalization | Model default untuk personalization. |
| Reranker | Model default untuk reranking. |
| KB Training | Model default untuk training knowledge base. |
| Conversation Analysis | Model default untuk conversation analysis. |