Ultimate AI Connector for Compatible Endpoints
Ultimate AI Connector for Compatible Endpoints, OpenAI uyumlu yapay zeka sağlayıcı API'lerini WordPress multisite ağınızla entegre eder. Birden fazla AI sağlayıcısı yapılandırın — her birinin kendi endpoint URL'si, API anahtarı ve varsayılan modeli olsun — ve bir sağlayıcı kullanılamadığında otomatik geri dönüş (fallback) ile istekleri yönlendirin.
Temel Özellikler
- Çoklu sağlayıcı desteği: Her biri kendi endpoint URL'si, API anahtarı ve varsayılan modeli olan birden fazla AI sağlayıcı kartı ekleyin.
- Sürükle-Bırak Sıralama: Sağlanan her karttaki tutma kolunu (grip handle) kullanarak sağlayıcıları öncelik sırasına göre düzenleyin; istekler sağlayıcıları bu sırayla kullanır.
- Otomatik Geri Dönüş Yönlendirme: Birincil sağlayıcı kullanılamazsa, istekler otomatik olarak bir sonraki yapılandırılmış sağlayıcıya geri döner.
- 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+ Card 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.
- Script Cache Busting: Sağlayıcı scriptleri, en son sürümün yüklendiğinden emin olmak için eklenti güncellendiğinde cache-busting yapılır.
Gereksinimler
- WordPress 5.3 veya üzeri
- PHP 7.4 veya üzeri
- Ultimate Multisite eklentisi (aktif)
- Bir OpenAI uyumlu API endpoint'i (kendi barındırdığınız veya üçüncü taraf)
Kurulum
- Eklenti dosyalarını
/wp-content/plugins/dizininize yükleyin. - WordPress'te 'Plugins' menüsünden eklentiyi etkinleştirin.
- Eklentiyi yapılandırmak için Ultimate Multisite → AI Connector yolunu izleyin.
Yapılandırma
Çoklu Sağlayıcı Kurulumu
Yapılandırma ekranı, her kartın bir AI 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.
- Add Provider'a 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", "Local 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).
- Save Settings'e tıklayın.
Bir Sağlayıcı Kaldırma
Bir sağlayıcı kartındaki Remove 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ıralama, geri dönüş önceliğini belirler: istekler ilk sağlayıcıya gönderilir ve bir istek başarısız olursa sonraki sağlayıcılara geri döner.
Geri Dönüş (Fallback) Yönlendirme
Birincil sağlayıcıya yapılan bir istek zaman aşımı, hız limiti veya hizmet kesintisi nedeniyle başarısız olursa, konektör 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 verdi | İstek normal şekilde hizmet verir |
| Birincil sağlayıcı başarısız oldu | İstek bir sonraki sağlayıcıyla yeniden denenir |
| Tüm sağlayıcılar başarısız oldu | Hata çağırana döndürülür |
Geri dönüş, ç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çbir sağlayıcı listelenmiyor
Kaydetme işleminden sonra sağlayıcı listesi boşsa, lütfen şunları kontrol edin:
- Sağlayıcılar eklendikten sonra Save Settings'e tıkladığınızdan emin olun.
- Tarayıcınızın ayarlar sayfasının kaydedilmesini engellemediğinden emin olun (JavaScript hataları için tarayıcı konsolunu kontrol edin).
- Eklentinin aktif 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 endpoint 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 dashboard'undaki hız limiti ve kota durumunu gözden geçirin.
- Konektörden ayrıntılı hata mesajları yakalamak için WordPress debug logging'i (
WP_DEBUG_LOG) etkinleştirin.
Bir sağlayıcı geri dönüş için kullanılmıyor
Sürükle-Bırak Sıralama, geri dönüş sırasını değiştirir. Geri dönüş istekleri almasını beklediğiniz sağlayıcının listede doğru konumlandırıldığından ve endpoint URL'si ile API anahtarının doğru olduğundan emin olun.
Yeni sağlayıcı kartı otomatik olarak 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.
Changelog
Tüm sürüm geçmişi için Changelog'a bakın.