Qevron AI Gateway Kurulumu
Qevron Sosyabot'un varsayılan LLM gateway'idir — her metin üretim çağrısı (prompts, inline assist, AI agents) buradan geçer, sonra admin'in AI Modelleri'nde etkinleştirdiği upstream modele gider. /admin/api-integration/qevron admin formu Sosyabot'u Qevron dağıtımına yönlendirdiğin yerdir.
Genel bakış
| Form alanı | Options anahtarı | Zorunlu |
|---|---|---|
| Base URL | qevron_api-base-url | Evet |
| API Key | qevron_api-key | Evet |
| Status | qevron_integration_status | — |
ENV fallback: QEVRON_API_BASE_URL, QEVRON_API_KEY.
Sosyabot'un çağırdığı tam chat-completions URL'i <Base URL>/v1/chat/completions'dır — yalnızca origin Base URL'e girer; Sosyabot path'i ekler.
Adım adım
1. Qevron dağıtımı sağla
Qevron self-hosted (veya satıcı tarafından yönetilen) OpenAI uyumlu bir gateway'dir. Zaten çalıştırıyorsan 2. adıma atla. Aksi halde dağıtım URL'i ve API token için Qevron operatörüne başvur.
2. API token oluştur
Qevron admin UI'sinde chat completions'a scope edilmiş bir Bearer token ver. Token'ı kopyala — Qevron tipik olarak bir kez gösterir.
3. Public origin'i onayla
Sosyabot'un ihtiyaç duyduğu Base URL çıplak origin'dir (path yok, trailing slash yok). Örnekler:
http://172.19.16.57:3001(internal)https://qevron.example.com(public)
Sosyabot admin paneline yapıştırma
/admin/api-integration/qevron:
- Base URL: public origin.
- API Key: Bearer token.
- Status: Enable.
- Save → Test connection
<Base URL>/v1/chat/completions'a minimal bir probe gönderir ve HTTP status'ü raporlar.
Hata: Qevron not configured: set credentials from the admin panel (Integrations → Qevron) or via QEVRON_API_KEY env.
Model-başı API key override
AI Modelleri'nde kayıtlı her AI model kendi API key'ini taşıyabilir (PUT /api/v1/ai-models/:id/api-key). Ayarlandığında o spesifik model için global Qevron anahtarını override eder — bir model farklı bir gateway veya kota planı arkasında olduğunda yararlı.
Doğrulama
/admin/data/ai-models'ten test et → bir text model seç → Test butonu. Test, Qevron üzerinden tek seferlik bir prompt çalıştırır ve yanıtı (veya upstream hatayı) inline gösterir.
Inline AI'yi /app/ai-contents'ten de deneyebilirsin: herhangi bir model seç, Generate'e tıkla ve yanıtı doğrula.
Sorun giderme
| Belirti | Sebep | Çözüm |
|---|---|---|
Qevron not configured: ... | Admin + ENV eksik | Hem Base URL hem API Key ayarla. |
Test connection 401 döner | Yanlış API token | Qevron'da yeniden ver, tekrar yapıştır. |
Test connection 404 döner | Base URL'de path veya trailing slash var | Çıplak origin kullan. Sosyabot /v1/chat/completions'ı ekler. |
| Spesifik model başarısız ama diğerleri çalışıyor | Model-başı API key geçersiz | Modelin model-başı key'ini AI Modelleri'nde kontrol et; global Qevron anahtarına düşmesi için temizle. |
ENV fallback
QEVRON_API_BASE_URL=https://qevron.example.com
QEVRON_API_KEY=<bearer token'ın>.env düzenledikten sonra ./service.sh restart api.