Cara mengatur model kustom di WorkBuddy
Masukkan URL, kunci API, dan nama model sesuai urutan yang ditampilkan, lalu verifikasi koneksi lengkap.
Panduan ini menggunakan antarmuka model kustom WorkBuddy saat ini. Siapkan kunci OmniaKey API dan satu ID model yang tepat sebelum membuka WorkBuddy.
Formulir yang sudah selesai: pilih Kustom, masukkan https://api.omniakey.com/v1, tempelkan kunci OmniaKey API Anda, dan gunakan ID model yang tepat seperti deepseek-v4-flash.
Formulir, detail model yang disimpan, dan pemilih model diperiksa di aplikasi macOS yang menjalankan WorkBuddy v5.3.14. Instruksi resmi Tencent Cloud memerlukan setidaknya v4.22.15 untuk fitur ini.
| bidang WorkBuddy | Nilai |
|---|---|
| Penyedia | Custom di bawah grup Lainnya |
| Alamat antarmuka | https://api.omniakey.com/v1 |
| Kunci API | Kunci dibuat di OmniaKey |
| Nama model | Misalnya, deepseek-v4-flash |
Sebelum memulai, siapkan dua item
Kunci OmniaKey API
Masuk ke OmniaKey dan buka halaman Kunci API:
- Pilih Buat kunci.
- Beri nama
WorkBuddy, lalu tetapkan batas dan masa berlaku yang sesuai. - Buat dan segera salin kunci baru.
Biarkan dialog kunci tetap terbuka hingga Anda menempelkan kredensial ke WorkBuddy. Jangan letakkan kunci di tangkapan layar, pesan obrolan, atau file publik.
Akun tersebut juga memerlukan saldo atau kredit percobaan yang tersedia. Membuat kunci hanya menciptakan kredensial; itu tidak menjamin bahwa akun tersebut dapat mendanai permintaan.
ID model yang tepat
Buka katalog model OmniaKey, pilih model yang tersedia saat ini, dan salin ID model yang ditampilkan di halaman. Untuk tes pertama, gunakan:
deepseek-v4-flash
ID harus sama persis. Jangan memasukkan nama tampilan DeepSeek V4 Flash, menghapus tanda hubung, atau membuat alias yang lebih pendek.
Langkah 1: Buka Tambahkan model
Mulai WorkBuddy dan buka:
System Settings → Models → + Add model
Pada halaman Model, pilih + Tambahkan model di sudut kanan atas.
Anda juga dapat memasukkan tugas baru dari bawah:
Model picker → + Configure custom model
Jika tidak ada entri yang tersedia, perbarui WorkBuddy ke versi v4.22.15 atau lebih baru. Instruksi Tencent Cloud saat ini memerlukan setidaknya versi ini untuk antarmukanya.
Langkah 2: Pilih Kustom dan lengkapi empat bidang
Isi formulir dari atas ke bawah.
1. Pilih penyedia Kustom
Buka menu Penyedia dan pilih:
Custom
Di v5.3.14, ini muncul di bawah grup Lainnya. Jangan memilih OpenAI bawaan, Tencent Cloud Token Plan, atau penyedia lain karena profil tersebut tidak menggunakan alamat antarmuka OmniaKey.
2. Masukkan alamat melalui /v1
Di Alamat antarmuka atau Base URL, masukkan persis:
https://api.omniakey.com/v1
Jangan salin placeholder abu-abu. Ini menunjukkan contoh yang diakhiri dengan /v1/chat/completions, namun OmniaKey menggunakan Base URL https://api.omniakey.com/v1 di bidang ini.
3. Tempel kunci API
Tempelkan kunci yang Anda salin dari OmniaKey ke Kunci API. Jangan menambahkan tanda kutip, spasi, atau kata Bearer; masukkan hanya nilai kunci.
4. Masukkan nama model
Di bawah Nama model atau Model ID, masukkan ID katalog yang tepat:
deepseek-v4-flash
Bentuk inti sekarang seharusnya berbunyi:
Provider: Custom
Interface address: https://api.omniakey.com/v1
API Key: [your OmniaKey API key]
Model name: deepseek-v4-flash
Untuk pengujian koneksi pertama, biarkan kolom lainnya pada nilai default dan pastikan Protokol khusus tidak aktif. Di v5.3.14, formulir baru dimulai dengan Tool calling aktif, Input gambar nonaktif, Mode Penalaran nonaktif, Protokol kustom nonaktif, dan batas input dan output default penyedia. Prasetel deepseek-v4-flash yang terverifikasi muncul di bawah.
Langkah 3: Simpan, pilih model, dan uji
Pilih Simpan dan kembali ke tugas baru. Buka pemilih model di bagian bawah, temukan bagian model khusus, dan pilih deepseek-v4-flash.
Kirim satu pesan tes singkat:
Reply with exactly: Connection successful
Respons normal mengonfirmasi empat bagian pengaturan sekaligus:
- WorkBuddy menyimpan penyedia khusus.
- Base URL benar.
- Kunci API diterima dan memiliki kredit yang dapat digunakan.
- Kuncinya dapat mengakses ID model yang dipilih.
Terakhir, buka OmniaKey Usage dan konfirmasikan bahwa panggilan tersebut muncul dengan model yang diharapkan. Ini menutup putaran verifikasi dari WorkBuddy ke OmniaKey.
Jika model yang disimpan tidak segera muncul, tutup dan buka kembali alat pilih. Keluar sepenuhnya dan mulai ulang WorkBuddy jika masih tidak muncul.
Pengaturan lanjutan yang disarankan untuk pengujian pertama
Jangan mengubah beberapa kontrol kemampuan sebelum obrolan dasar berfungsi. Model kustom baru di WorkBuddy v5.3.14 dimulai dengan:
| Pilihan | Default bentuk baru |
|---|---|
| Tool calling | Aktif |
| masukan gambar | Mati |
| Modus penalaran | Mati |
| Protokol khusus | Mati |
| Batas masukan dan keluaran | Default penyedia |
Gunakan default ini untuk memverifikasi URL, kunci, dan nama model terlebih dahulu. Kemudian sesuaikan kemampuan untuk model tersebut.
Prasetel deepseek-v4-flash terverifikasi
Model tersimpan dan balasan lokal yang berhasil menggunakan konfigurasi ini:
| Pilihan | Pengaturan deepseek-v4-flash |
|---|---|
| Tool calling | Mati |
| masukan gambar | Mati |
| Modus penalaran | Aktif |
| Hanya penalaran | Mati |
| Izinkan menonaktifkan alasan | Aktif |
| Protokol khusus | Mati |
| Upaya penalaran standar | Auto (use request-layer default) |
| Mendukung upaya penalaran | Biarkan Rendah, Sedang, Tinggi, Ekstra Tinggi, dan Maksimum tidak dicentang |
| Batas masukan dan keluaran | Default penyedia |
WorkBuddy menampilkan Penalaran saja, Izinkan penonaktifan penalaran, dan kontrol upaya setelah mode Penalaran diaktifkan. Tinggalkan upaya pada Otomatis untuk pengujian pertama.
Kapan mengaktifkan pemanggilan alat
Aktifkan Tool calling ketika WorkBuddy perlu membaca file, menggunakan konektor, atau melakukan tugas agen. Model tersebut juga harus mendukung pemanggilan alat terstruktur. deepseek-v4-flash saat ini memiliki dukungan alat di katalog OmniaKey, jadi aktifkan setelah obrolan dasar berfungsi dan mulailah dengan tugas hanya-baca. Ini dapat tetap nonaktif untuk pengujian obrolan hanya koneksi.
Kapan mengaktifkan input gambar
Aktifkan hanya untuk model yang secara eksplisit ditandai sebagai menerima gambar. Peralihan klien tidak dapat menambahkan kemampuan penglihatan ke model hanya teks.
Kapan mengaktifkan mode penalaran
Aktifkan ketika katalog atau dokumentasi model secara eksplisit mencantumkan alasan, pemikiran, atau mode serupa. Pertahankan upaya otomatis dan Izinkan penonaktifan alasan. Jangan menambahkan nilai upaya yang tidak didukung, dan jangan menjadikan mode hanya penalaran sebagai default untuk tugas biasa.
Menambahkan model lain
Jangan menimpa entri model yang berfungsi. Buka Tambahkan model lagi, pertahankan URL OmniaKey dan kunci API yang sama, ganti hanya ID model yang tepat, dan simpan sebagai model khusus lainnya.
Verifikasi satu model sebelum menambahkan model berikutnya. Ketika masalah muncul, ini memperjelas entri tersimpan mana yang menyebabkannya.
Pemecahan masalah berdasarkan gejala
Konfigurasi model kustom tidak ada
Periksa versi WorkBuddy terlebih dahulu. Perbarui ke v4.22.15 atau lebih baru, lalu lihat di pemilih model tugas baru atau di Pengaturan Sistem → Model.
HTTP 401, Kunci API tidak sah atau tidak valid
Salin lagi kunci OmniaKey. Periksa spasi dan pastikan Anda tidak menempelkan Bearer dengannya. Konfirmasikan bahwa kunci telah diaktifkan dan belum kedaluwarsa, serta saldo akun dan batas kunci dapat digunakan.
Mengubah ID model tidak memperbaiki 401; otentikasi gagal sebelum pemilihan model penting.
HTTP 404 atau titik akhir tidak ditemukan
Alamatnya harus persis:
https://api.omniakey.com/v1
Jangan gunakan domain kosong, duplikat /v1, atau tambahkan /chat/completions. Pastikan juga Protokol khusus tidak aktif.
Model tidak ditemukan atau UNKNOWN_MODEL
Salin lagi ID dari katalog model langsung. Nama tampilan, tebakan alias, atau ID yang dihentikan bukan merupakan ID model saat ini yang valid.
Obrolan berfungsi tetapi alat gagal
Koneksi model dasar sudah berfungsi. Periksa sakelar Tool calling WorkBuddy dan kemampuan alat model. Memasukkan kembali kunci atau URL API tidak akan menambah dukungan alat.
Input gambar gagal
Kedua kondisi tersebut harus benar: model mendukung gambar dan kontrol input Gambar WorkBuddy diaktifkan.
Model hilang setelah Simpan
Konfirmasikan bahwa Anda memilih Simpan, lalu buka kembali alat pilih model. Mulai ulang WorkBuddy jika perlu. Jika entri konfigurasi itu sendiri tidak tersedia, periksa kembali versi klien.
Pertanyaan yang sering diajukan
URL OmniaKey apa yang harus digunakan WorkBuddy?
Gunakan hanya https://api.omniakey.com/v1. Ini adalah Base URL; WorkBuddy menambahkan jalur operasi.
Apakah saya memerlukan file models.json?
Tidak. Panduan ini mengikuti antarmuka Konfigurasi model kustom saat ini. Petunjuk file konfigurasi lokal yang lebih lama menjelaskan jalur pengaturan yang berbeda.
Bisakah saya mengonfigurasi GPT, Claude, Gemini, atau model lainnya?
Ya, jika model saat ini terdaftar di OmniaKey dan mendukung rute yang kompatibel dengan OpenAI. Pertahankan URL yang sama dan gunakan ID model katalog yang sama.
Apakah MCP dikonfigurasi pada formulir ini?
Tidak. Formulir ini mengonfigurasi model API. MCP dan konektor adalah pengaturan WorkBuddy yang terpisah. Tetapkan respons model dasar sebelum menambahkan alat tersebut.