Uyumlu Uç Noktalar için Ultimate AI Bağlayıcı
Uyumlu Uç Noktalar için Ultimate AI Bağlayıcı, OpenAI uyumlu yapay zeka sağlayıcı API'lerini WordPress çok siteli ağınızla entegre eder. Birden fazla yapay zeka sağlayıcısı yapılandırın — her birinin kendi uç nokta URL'si, API anahtarı ve varsayılan modeli olsun — ve bir sağlayıcı kullanılamadığında istekleri otomatik yedekleme (fallback) ile yönlendirin.
Temel Özellikler
- Çoklu sağlayıcı desteği: Her birinin kendi uç nokta URL'si, API anahtarı ve varsayılan modeli olan birden fazla yapay zeka sağlayıcı kartı ekleyin.
- Sürükle-bırak ile yeniden sıralama: Sağlayıcıları öncelik sırasına göre her karttaki tutma kolunu (grip handle) kullanarak düzenleyin; istekler sağlayıcıları bu sırayla kullanır.
- Otomatik yedekleme yönlendirme: Birincil sağlayıcı kullanılamazsa, istekler otomatik olarak listedeki bir sonraki yapılandırılmış sağlayıcıya yönlendirilir.
- Sağlayıcıya özel yapılandırma: Her sağlayıcı, kendi kimlik bilgileri ve model seçimi ile bağımsız olarak yapılandırılır.
- Kart tabanlı ayarlar arayüzü: Stabil WordPress 6.9+ Kart bileşenleri (CardBody, CardHeader, CardDivider) üzerine inşa edilmiştir.
- Eklemede otomatik genişleme: Yeni sağlayıcı kartları otomatik olarak genişler, böylece detayları hemen doldurabilirsiniz.
- Betik önbellek temizleme (Script cache busting): Sağlayıcı betikleri, en son sürümün yüklendiğinden emin olmak için eklenti güncellendiğinde önbellek temizlenir.
Gereksinimler
- WordPress 5.3 veya üzeri
- PHP 7.4 veya üzeri
- Ultimate Multisite eklentisi (aktif)
- Bir OpenAI uyumlu API uç noktası (kendi barındırdığınız veya üçüncü taraf)
Kurulum
- Eklenti dosyalarını
/wp-content/plugins/dizininize yükleyin. - WordPress'te 'Eklentiler' menüsünden eklentiyi etkinleştirin.
- Eklentiyi yapılandırmak için Ultimate Multisite → AI Connector sayfasına gidin.
Yapılandırma
Çoklu Sağlayıcı Kurulumu
Yapılandırma ekranı, her kartın bir yapay zeka sağlayıcısını temsil ettiği kart tabanlı bir düzen kullanır. İhtiyacınız kadar sağlayıcı ekleyebilirsiniz.
Bir Sağlayıcı Ekleme
- Ağ yöneticisinde Ultimate Multisite → AI Connector sayfasına gidin.
- Provider Ekle'ye tıklayın.
- Yeni bir sağlayıcı kartı görünür ve otomatik olarak genişler.
- Sağlayıcı detaylarını doldurun:
- Provider Name — Bu sağlayıcıyı tanımlamak için bir etiket (örneğin, "OpenAI", "Mistral", "Yerel Ollama")
- Endpoint URL — OpenAI uyumlu API'nin temel URL'si (örneğin,
https://api.openai.com/v1) - API Key — Bu sağlayıcı için API anahtarınız
- Default Model — Bu sağlayıcı için varsayılan olarak kullanılacak model tanımlayıcısı ( örneğin,
gpt-4o,mistral-small)
- Ayarları Kaydet'e tıklayın.
Bir Sağlayıcı Kaldırma
Bir sağlayıcı kartındaki Kaldır düğmesine tıklayarak onu silebilirsiniz. Değişikliği uygulamak için ayarları kaydedin.
Sağlayıcıları Yeniden Sıralama
Herhangi bir sağlayıcı kartının sol tarafındaki tutma simgesini (⣿) sürükleyerek yeniden sıralayabilirsiniz. Sıra, yedekleme önceliğini belirler: istekler ilk sağlayıcıya gönderilir ve bir istek başarısız olursa sonraki sağlayıcılara yedeklenir.
Yedekleme Yönlendirme (Fallback Routing)
Birincil sağlayıcıya yapılan bir istek zaman aşımı, hız limiti veya hizmet kesintisi nedeniyle başarısız olursa, bağlayıcı otomatik olarak listedeki bir sonraki sağlayıcıyla yeniden dener. Bu, bir sağlayıcı başarılı olana veya tüm sağlayıcılar denenene kadar listede devam eder.
| Senaryo | Davranış |
|---|---|
| Birincil sağlayıcı yanıt verirse | İstek normal şekilde hizmet verir |
| Birincil sağlayıcı başarısız olursa | İstek bir sonraki sağlayıcıyla yeniden denenir |
| Tüm sağlayıcılar başarısız olursa | Hata çağırana döndürülür |
Yedekleme, çağıran eklenti veya tema için şeffaftır — kaç sağlayıcı denenmiş olursa olsun, başarılı bir yanıt veya nihai bir hata alırlar.
Sağlayıcı Yapılandırma Referansı
| Alan | Gerekli | Açıklama |
|---|---|---|
| Provider Name | Evet | Bu sağlayıcı için gösterilecek etiket |
| Endpoint URL | Evet | OpenAI uyumlu API'nin temel URL'si |
| API Key | Evet | Bu sağlayıcı için kimlik doğrulama anahtarı |
| Default Model | Evet | İstekte model belirtilmediğinde kullanılan model tanımlayıcısı |
Sorun Giderme
Hiç sağlayıcı listelenmiyor
Sağladıktan sonra sağlayıcı listesi boşsa, lütfen şunları kontrol edin:
- Sağlayıcılar eklendikten sonra Ayarları Kaydet düğmesine tıkladığınızdan emin olun.
- Tarayıcınızın ayarlar sayfasını kaydetmesini engellemediğinden emin olun (JavaScript hataları için tarayıcı konsolunu kontrol edin).
- Eklentinin etkin olduğundan ve ağ yöneticisi ekranında olduğunuzdan emin olun.
Tüm sağlayıcılarda istekler başarısız oluyor
- Her sağlayıcının uç nokta URL'sinin sunucunuzdan (yalnızca tarayıcınızdan değil) erişilebilir olduğunu doğrulayın.
- Her API anahtarının geçerli olduğundan ve süresinin dolmadığından emin olun.
- Sağlayıcının hız limiti ve kota durumunu panolarında kontrol edin.
- Bağlayıcıdan ayrıntılı hata mesajları yakalamak için WordPress hata günlüklemesini (
WP_DEBUG_LOG) etkinleştirin.
Bir sağlayıcı yedekleme için kullanılmıyor
Sürükle-bırak ile yeniden sıralama, yedekleme sırasını değiştirir. Yedekleme istekleri almasını beklediğiniz sağlayıcının listede doğru konumlandırıldığından ve uç nokta URL'si ile API anahtarının doğru olduğundan emin olun.
Yeni sağlayıcı kartı otomatik genişlemiyor
Otomatik genişleme, tarayıcınızda JavaScript'in etkin olmasını gerektirir. Kart tıklayınca genişlemiyorsa, tarayıcı konsolunda hata olup olmadığını kontrol edin. Kart içeriği, otomatik genişleme tetiklenmese bile her zaman kart başlığına tıklayarak erişilebilir durumdadır.
Değişiklik Günlüğü
Tüm sürüm geçmişi için Changelog'a bakın.