WorkBuddy özel model kurulumu

Bu kılavuz WorkBuddy'nin mevcut özel model arayüzünü kullanır. WorkBuddy'yi açmadan önce bir OmniaKey API anahtarı ve tam bir model kimliği hazırlayın.

Form, kaydedilen model ayrıntıları ve model seçici, WorkBuddy v5.3.14 çalıştıran macOS uygulamasında kontrol edildi. Tencent Cloud'un resmi talimatları bu özellik için en az v4.22.15 gerektirir.

Başlamadan önce iki öğe hazırlayın

Bir OmniaKey API anahtarı

OmniaKey'de oturum açın ve API Anahtarlar sayfasını açın:

1. Anahtar oluştur'u seçin.
2. Bunu WorkBuddy olarak adlandırın, ardından uygun bir limit ve son tarih belirleyin.
3. Oluşturun ve yeni anahtarı hemen kopyalayın.

Kimlik bilgisini WorkBuddy'ye yapıştırana kadar anahtar iletişim kutusunu açık tutun. Anahtarı ekran görüntülerine, sohbet mesajlarına veya genel dosyalara koymayın.

Hesabın ayrıca kullanılabilir bakiyeye veya deneme kredisine ihtiyacı var. Anahtar oluşturmak yalnızca bir kimlik bilgisi oluşturur; hesabın bir talebi finanse edebileceğini garanti etmez.

Tam bir model kimliği

OmniaKey model kataloğunu açın, mevcut bir modeli seçin ve sayfada gösterilen model kimliğini kopyalayın. İlk test için şunu kullanın:

deepseek-v4-flash

Kimlik tam olarak eşleşmelidir. DeepSeek V4 Flash görünen adını girmeyin, kısa çizgileri kaldırmayın veya daha kısa bir takma ad icat etmeyin.

Adım 1: Model Ekle'yi açın

WorkBuddy'yi başlatın ve açın:

System Settings → Models → + Add model

Modeller sayfasında sağ üst köşedeki + Model ekle seçeneğini seçin.

Ayrıca yeni bir görevin alt kısmından da girebilirsiniz:

Model picker → + Configure custom model

Her iki giriş de mevcut değilse, WorkBuddy'yi v4.22.15 veya sonraki bir sürüme güncelleyin. Tencent Cloud'un mevcut talimatları, arayüz için en azından bu sürümü gerektiriyor.

Adım 2: Özel'i seçin ve dört alanı doldurun

Formu yukarıdan aşağıya doğru doldurun.

1. Özel sağlayıcıyı seçin

Sağlayıcı menüsünü açın ve şunu seçin:

Custom

v5.3.14'de Diğer grubu altında görünür. Yerleşik OpenAI, Tencent Cloud Token Planını veya başka bir sağlayıcıyı seçmeyin çünkü bu profiller OmniaKey arayüz adresini kullanmaz.

2. /v1 aracılığıyla adresi girin

Arayüz adresi veya Base URL alanına tam olarak şunu girin:

https://api.omniakey.com/v1

3. API anahtarını yapıştırın

OmniaKey'den kopyaladığınız anahtarı API Anahtarı'na yapıştırın. Tırnak işareti, boşluk veya Bearer sözcüğünü eklemeyin; yalnızca anahtar değerini girin.

4. Model adını girin

Model adı veya Model ID altına tam katalog kimliğini girin:

deepseek-v4-flash

Çekirdek form şimdi şunu okumalıdır:

Provider: Custom
Interface address: https://api.omniakey.com/v1
API Key: [your OmniaKey API key]
Model name: deepseek-v4-flash

İlk bağlantı testi için kalan alanları varsayılan değerlerinde bırakın ve Özel protokolün kapalı olduğundan emin olun. v5.3.14'de, Tool calling açık, Görüntü girişi kapalı, Muhakeme modu kapalı, Özel protokol kapalı ve sağlayıcının varsayılan giriş ve çıkış limitleri ile yeni bir form başlar. Doğrulanmış bir deepseek-v4-flash ön ayarı aşağıda görünür.

Adım 3: Kaydedin, modeli seçin ve test edin

Kaydet'i seçin ve yeni göreve dönün. Alttaki model seçiciyi açın, özel model bölümünü bulun ve deepseek-v4-flash'yi seçin.

Kısa bir test mesajı gönderin:

Reply with exactly: Connection successful

Normal bir yanıt, kurulumun dört bölümünü aynı anda doğrular:

1. WorkBuddy özel sağlayıcıyı kaydetti.
2. Base URL doğrudur.
3. API anahtarı kabul edilir ve kullanılabilir krediye sahiptir.
4. Anahtar seçilen model kimliğine erişebilir.

Son olarak OmniaKey Kullanımı'i açın ve çağrının beklenen modelle göründüğünü doğrulayın. Bu, WorkBuddy'den OmniaKey'ye doğrulama döngüsünü kapatır.

Kaydedilen model hemen görünmüyorsa seçiciyi kapatıp yeniden açın. Hala görünmüyorsa WorkBuddy'den tamamen çıkın ve yeniden başlatın.

İlk test için önerilen gelişmiş ayarlar

Temel sohbet çalışmadan önce çeşitli yetenek kontrollerini değiştirmeyin. WorkBuddy v5.3.14'deki yeni özel model şununla başlar:

Önce URL'yi, anahtarı ve model adını doğrulamak için bu varsayılanları kullanın. Daha sonra modelin yeteneklerini ayarlayın.

Doğrulanmış deepseek-v4-flash ön ayarı

Kaydedilen model ve başarılı yerel yanıtlar bu yapılandırmayı kullandı:

WorkBuddy, Yalnızca Akıl Yürütme, Akıl yürütmenin devre dışı bırakılmasına izin ver ve Akıl Yürütme modu etkinleştirildikten sonra efor kontrollerini gösterir. İlk test için çabayı Otomatik'te bırakın.

Araç çağırma ne zaman etkinleştirilmeli?

WorkBuddy'nin dosyaları okuması, bağlayıcı kullanması veya aracı görevlerini gerçekleştirmesi gerektiğinde Tool calling'yi etkinleştirin. Model ayrıca yapılandırılmış araç çağrılarını da desteklemelidir. deepseek-v4-flash şu anda OmniaKey kataloğunda araç desteğine sahiptir; bu nedenle, temel sohbet çalışmalarından sonra bunu etkinleştirin ve salt okunur bir görevle başlayın. Yalnızca bağlantıya dayalı sohbet testi için kapalı kalabilir.

Görüntü girişi ne zaman etkinleştirilmeli?

Bunu yalnızca görselleri kabul ediyor olarak açıkça işaretlenmiş bir model için etkinleştirin. İstemci anahtarı salt metinden oluşan bir modele görme yeteneği ekleyemez.

Akıl yürütme modu ne zaman etkinleştirilmeli?

Katalog veya model belgelerinde akıl yürütme, düşünme veya benzer bir mod açıkça listelendiğinde bunu etkinleştirin. Otomatik çabayı koru ve akıl yürütmenin devre dışı bırakılmasına izin ver. Desteklenmeyen efor değerleri eklemeyin ve sıradan görevler için yalnızca akıl yürütme modunu varsayılan yapmayın.

Başka bir model ekleme

Çalışan bir model girişinin üzerine yazmayın. Model ekle'yi tekrar açın, aynı OmniaKey URL'sini ve API anahtarını koruyun, yalnızca tam model kimliğini değiştirin ve bunu başka bir özel model olarak kaydedin.

Bir sonrakini eklemeden önce bir modeli doğrulayın. Bir sorun ortaya çıktığında, bu, sorunun hangi kayıtlı girişten kaynaklandığını açıkça ortaya koyar.

Belirtiye göre sorun giderme

Özel modeli yapılandır eksik

Önce WorkBuddy sürümünü kontrol edin. v4.22.15 veya sonraki bir sürüme güncelleyin, ardından yeni görev modeli seçiciye veya Sistem Ayarları → Modeller altına bakın.

HTTP 401, Yetkisiz veya geçersiz API anahtarı

OmniaKey anahtarını tekrar kopyalayın. Boşluk olup olmadığını kontrol edin ve Bearer'yi bu alana yapıştırmadığınızdan emin olun. Anahtarın etkinleştirildiğini, süresinin dolmadığını ve hem hesap bakiyesinin hem de anahtar limitinin kullanılabilir olduğunu doğrulayın.

Model kimliğini değiştirmek 401'yi düzeltmez; Model seçimi önem kazanmadan önce kimlik doğrulama başarısız oldu.

HTTP 404 veya uç nokta bulunamadı

Adres tam olarak şu şekilde olmalıdır:

https://api.omniakey.com/v1

Çıplak etki alanını kullanmayın, /v1'yi çoğaltmayın veya /chat/completions'yi eklemeyin. Ayrıca Özel protokolün kapalı olduğundan emin olun.

Model bulunamadı veya UNKNOWN_MODEL

Kimliği canlı model kataloğundan tekrar kopyalayın. Görünen ad, tahmin edilen takma ad veya kullanımdan kaldırılan kimlik, geçerli bir geçerli model kimliği değildir.

Sohbet çalışıyor ancak araçlar başarısız oluyor

Temel model bağlantısı zaten çalışıyor. WorkBuddy'nin Tool calling anahtarını ve modelin alet kapasitesini kontrol edin. API anahtarının veya URL'sinin yeniden girilmesi araç desteği sağlamayacaktır.

Görüntü girişi başarısız oluyor

Her iki koşulun da doğru olması gerekir: model görüntüleri destekler ve WorkBuddy'nin Görüntü giriş kontrolü etkinleştirilir.

Kaydettikten sonra model eksik

Kaydet'i seçtiğinizi doğrulayın ve ardından model seçiciyi yeniden açın. Gerekirse WorkBuddy'yi yeniden başlatın. Yapılandırma girişinin kendisi kullanılamıyorsa istemci sürümünü tekrar kontrol edin.

Sık sorulan sorular

WorkBuddy hangi OmniaKey URL'sini kullanmalıdır?

Yalnızca https://api.omniakey.com/v1. Bu bir Base URL'dir; WorkBuddy işlem yolunu ekler.

models.json dosyasına ihtiyacım var mı?

Hayır. Bu kılavuz mevcut Özel modeli yapılandır arayüzünü takip etmektedir. Daha eski yerel yapılandırma dosyası talimatları farklı bir kurulum yolunu açıklar.

GPT, Claude, Gemini veya başka bir modeli yapılandırabilir miyim?

Evet, model şu anda OmniaKey'de listelendiğinde ve OpenAI uyumlu rotayı desteklediğinde. Aynı URL'yi koruyun ve tam katalog model kimliğini kullanın.

Bu formda MCP yapılandırılmış mı?

Hayır. Bu form API modelini yapılandırır. MCP ve konektörler ayrı WorkBuddy ayarlarıdır. Bu araçları eklemeden önce temel bir model yanıtı oluşturun.

Doğrulanmış referanslar

• Tencent Cloud: WorkBuddy'yi yapılandırın ve kullanın
• OmniaKey OpenAI uyumlu API referansı
• OmniaKey canlı model kataloğu