Gratis AI Agent Ayarları

Gratis AI Agent'deki Ayarlar → Gelişmiş ekranı, v1.5.0 ile eklenen arka uç entegrasyonları için yönetici düzeyinde yapılandırma sağlar. Bu sayfa, Geri Bildirim Endpoint'i alanlarını ve beklenen formatlarını belgelendirir.

Ayarlara Erişim

1. WordPress yöneticisinde, Gratis AI Agent → Ayarlar yolunu izleyin.
2. Gelişmiş sekmesine tıklayın.

Geri Bildirim Endpoint Yapılandırması

Geri bildirim endpoint'i, bir kullanıcı beğenmeme düğmesi, otomatik istem bandı veya /report-issue komutu aracılığıyla geri bildirim gönderdiğinde AI agent'dan POST istekleri alır.

Alan	Açıklama
Feedback Endpoint URL	Geri bildirim gönderimlerini JSON gövdesi ile HTTP POST istekleri olarak alan URL.
Feedback API Key	Her geri bildirim isteğinin Authorization başlığında gönderilen bir bearer token. Endpoint'inizin kimlik doğrulaması gerektirmiyorsa boş bırakın.

Beklenen JSON Yükü (Payload)

Geri bildirim endpoint'iniz, en az aşağıdaki alanları içeren bir JSON gövdesi kabul etmelidir:

{
  "message_id": "msg_abc123",
  "conversation_id": "conv_xyz789",
  "feedback_text": "Fiyatlandırma hakkında verilen cevap yanlış.",
  "triage_category": "factual_error"
}

Ek alanlar, konuşma bağlamına bağlı olarak yükte bulunabilir.

triage_category Değerleri

AI triyaj katmanı, yükü iletmeden önce triage_category için aşağıdaki değerlerden birini atar:

Değer	Anlamı
factual_error	Asistan yanlış olgusal bilgi sağlamıştır.
unhelpful_answer	Yanıt teknik olarak doğru ancak kullanışlı değildir.
inappropriate_content	Yanıt, kullanıcılara gösterilmemesi gereken içerik içermiştir.
other	Geri bildirim bilinen bir kategoriye uymamıştır.

Kimlik Doğrulama (Authentication)

Endpoint'iniz kimlik doğrulama gerektiriyorsa, Feedback API Key alanına bearer token'ınızı girin. Agent şunları gönderir:

Authorization: Bearer <your-api-key>

Feedback API Key alanı boşsa, herhangi bir Authorization başlığı gönderilmez.

Geri Bildirim Toplamayı Devre Dışı Bırakma

Hem Feedback Endpoint URL hem de Feedback API Key alanlarını boş bırakın. Beğenmeme düğmesi ve geri bildirim arayüzü kullanıcılara görünmeye devam eder, ancak gönderimler herhangi bir harici servise iletilmez.

Brave Search API Key

Ayrıca Gelişmiş sekmesinde bulunan Brave Search API Key alanı, Internet Search yeteneğini etkinleştirir.

Alan	Açıklama
Brave Search API Key	Brave Search geliştirici kontrol panelinizdeki API anahtarınız. AI asistanında internet aramayı etkinleştirmek için gereklidir.

Alan etiketi, Brave Search API kayıt sayfasına tıklanabilir bir bağlantı içerir. İnternet aramayı devre dışı bırakmak için boş bırakın.

Bu özellik hakkında son kullanıcı dokümantasyonu için Internet Search'e bakın.

Özellik Bayrakları (Feature Flags)

v1.9.0'da da tanıtılan Ayarlar → Özellik Bayrakları sekmesi, isteğe bağlı işlevsellikler için açma/kapama düğmeleri sağlar. Her bayrak ağ genelinde ya etkin ya da devre dışıdır; şu anda siteye özel bir geçersiz kılma (override) yoktur.

Özellik Bayraklarına Erişim

1. WordPress yöneticisinde, Gratis AI Agent → Ayarlar yolunu izleyin.
2. Özellik Bayrakları sekmesine tıklayın.

Erişim Kontrol Bayrakları

Bayrak	Varsayılan	Açıklama
Restrict to Administrators	Kapalı	Etkinleştirildiğinde, yalnızca administrator rolüne sahip kullanıcılar AI Agent sohbet paneline erişebilir. Diğer tüm roller bunun yerine "Yöneticinizle iletişime geçin" mesajını görür.
Restrict to Network Admins	Kapalı	Multisite ağında etkinleştirildiğinde, yalnızca Süper Yöneticiler (Super Admins) agent'ı kullanabilir. Bireysel site yöneticileri engellenir. Her ikisi de etkinse "Restrict to Administrators" özelliğinin önüne geçer.
Allow Subscriber Access	Kapalı	Etkinleştirildiğinde, subscriber rolündeki kullanıcılar sohbet arayüzünü kullanabilir ancak yalnızca salt okunur yeteneklerle sınırlıdır (yazı oluşturma veya ayar değiştirme yapamazlar).
Disable for Non-Members	Kapalı	Ultimate Multisite üyelik durumu ile entegre olur. Etkinleştirildiğinde, aktif bir üyeliği olmayan siteler için sohbet gizlenir.

Markalama (Branding) Bayrakları

Bayrak	Varsayılan	Açıklama
Hide "Powered by Gratis AI Agent" Footer	Kapalı	Sohbet widget'ının altında gösterilen marka atıf çizgisini kaldırır. Beyaz etiketli (white-label) dağıtımlar için önerilir.
Custom Agent Name	(boş)	Sohbet başlığındaki ve yönetici menüsündeki varsayılan "Gratis AI Agent" etiketini kendi ürün adınızla değiştirir. Varsayılanı kullanmak için boş bırakın.
Hide Agent Picker	Kapalı	Etkinleştirildiğinde, kullanıcılar beş yerleşik agent arasında geçiş yapamaz. Mevcut agent, Ayarlar → Genel'de varsayılan olarak yapılandırılan agent ile sabitlenir.
Use Site Icon as Chat Avatar	Kapalı	Sohbet widget'ı başlığındaki varsayılan AI simgesini WordPress site simgesi ile değiştirir (Görünüm → Özelleştir → Site Kimliği altında ayarlanır).

Değişiklikleri Uygulama

Herhangi bir bayrağı açıp kapattıktan sonra Ayarları Kaydet düğmesine tıklayın. Değişiklikler anında geçerli olur; önbellek temizlemeye veya eklenti yeniden etkinleştirmeye gerek yoktur.