Bilgi sağlığı ve arka plan işlemleri

Bilgi tabanınız, bir müşteri sorduğunda asistan doğru parçayı bulabildiği sürece işe yarar. Bu sayfa bunu sağlayan üç aracı anlatır:

• bir şey eklenebilmesi için bilgi tabanının ihtiyaç duyduğu gömme (embedding) modeli;
• arka plan işlemleri — bir web sitesini yenilemek, tekrarları temizlemek ya da geçmiş konuşmalardan öğrenmek gibi uzun işler, ilerleme ve günlükle;
• haftalık Bilgi sağlığı kontrolü.

Hepsi Ayarlar → Bilgi tabanı altında (geçmişten öğrenme Ayarlar → Eğitim altında). Telefonda: Menü → AI eğitimi → Arka plan işlemleri.

Önce gömme modeli

Bilgi tabanındaki her parça bir gömmeye (embedding) — anlamını yakalayan bir sayı dizisine — çevrilir; böylece bir soru, onu cevaplayan parçalarla eşleştirilebilir. Bunun için bir gömme modeli gerekir.

Çalışma alanınızda yoksa Bilgi tabanı ekranında, AI ayarlarında ve telefondaki AI eğitimi ekranında "Bilgi tabanı için bir gömme (embedding) modeli seçin" uyarısını görürsünüz ve:

• yeni kaynak eklenemez (Yeni düğmesi kapalıdır);
• "Eğitimde kullan" ve otomatik öğrenme hiçbir şey kaydetmez;
• asistan cevap verirken bilgi tabanında arama yapmaz.

Düzeltmek için Ayarlar → AI asistanı → Model ekranını açın ve:

• platform anahtarını (model pazaryeri) kullanın — gömmeler ConnectWiz'in anahtarıyla çalışır ve AI kredinizden ödenir; ya da
• Ayarlar → Kimlik bilgileri altında bir OpenAI kimlik bilgisi ekleyip gömme kimlik bilgisi olarak seçin (Anthropic, Gemini veya yalnız sohbet için olan bir kimlik bilgisinin burada gömme modeli yoktur).

AI açma/kapama anahtarı bilgi tabanını etkilemez: asistan kapalıyken de bilgi tabanını kurabilirsiniz. Yalnız otomatik öğrenme asistanın açık olmasını bekler (aşağıya bakın).

Arka plan işlemleri

Uzun bilgi tabanı işleri arka planda çalışır. Her biri Arka plan işlemleri listesinde şunlarla görünür:

• durumu — Sırada, Çalışıyor, Duraklatıldı, Bitti, Başarısız ya da İptal edildi;
• bir ilerleme çubuğu ("245 / 820");
• işlem günlüğü (kaydırma simgesi): her adım, sizin dilinizde, iş sürerken güncellenir;
• Duraklat, Sürdür ve İptal et.

Sunucu ortada yeniden başlarsa işlem kaldığı yerden devam eder. Aynı hedef için aynı türden yalnız bir işlem çalışır — örneğin her web sitesi için tek yenileme.

İşlem	Ne yapar	Nereden başlar
Kaynağı yenile	Bir web sayfasını veya siteyi yeniden okur, değişeni günceller	Web kaynağındaki yenile simgesi ya da kaynağın otomatik yenileme takvimi
Tekrarları temizle	Birebir aynı parçaları siler, site geneli blokları tek kez saklar	Tekrarları kontrol et → Tekrarları temizle
Bilgiyi yeniden göm	Her şeyi güncel gömme modeliyle yeniden gömer	Yeniden göm (gömme modelini değiştirdikten sonra)
Eksik başlıkları ekle	Sayfa başlığı olmayan eski parçalara başlığı ekler ve yeniden gömer	Eksik başlıkları ekle
Geçmiş konuşmalardan öğren	Aşağıya bakın	Ayarlar → Eğitim
Bilgi sağlığı kontrolü	Aşağıya bakın	Haftada bir otomatik ya da Şimdi kontrol et

Bir siteyi güvenle yenilemek

Yenileme bir kaynağı asla boşaltmaz. Sitenin yeni hali, asistanın kullandığının yanında kurulur ve ancak tamamlandığında onun yerine geçer:

• Yenileme başarısız olursa (site kapalı, bir sayfa zaman aşımına uğradı) önceki içerik kullanılmaya devam eder ve kaynakta "Son yenileme başarısız oldu; önceki içerik kullanılmaya devam ediyor." yazar.
• Değişmeyen sayfalar bir şeye mal olmaz. Sunucunun değişmedi dediği ya da metni bir önceki seferle aynı olan sayfa olduğu gibi korunur — ona AI kredisi harcanmaz.
• Siteden kaybolan bir sayfa bir yenilemede korunur, art arda ikinci yenilemede kaldırılır; geçici bir aksaklık hiçbir şeyi silmez.
• Elle seçilen siteler elle seçilmiş kalır. Bir sitenin sayfalarını kendiniz seçtiyseniz yenileme yalnız o sayfaları yeniden okur; yeni bulunan bağlantılar seçmeniz için sayfa listesinde bekler.

Tekrar yok

Aynı metin bir kez saklanır:

• aynı kapsamda zaten bulunan bir parça yeniden saklanmaz — başka bir kaynaktan geldiyse iki kaynak onu paylaşır ve birini silmek diğerinden kaldırmaz;
• bir web sitesinin sayfalarının %30'undan fazlasında geçen bir blok (alt bilgi, iletişim kutusu) her sayfa için değil site için bir kez saklanır;
• ilki hâlâ okunurken aynı web sitesini veya sayfayı ikinci kez eklemek reddedilir.

Bu kurallardan önce kurulmuş bir bilgi tabanı için Tekrarları kontrol et'i kullanın: hiçbir şeyi değiştirmeden kaç parçanın tekrar olduğunu gösterir. Tekrarları temizle ardından onları arka planda temizler.

Geçmiş konuşmalardan öğrenmek

Otomatik öğrenme temsilcilerinizin bundan sonraki cevaplarını alır. Geçmiş konuşmalardan öğren (Ayarlar → Eğitim altında) aynısını ekibinizin daha önce verdiği cevaplar için yapar:

1. Bir tarih aralığı ve isterseniz bazı kanallar veya departmanlar seçin.
2. Tahmin et'e basın. Kaç temsilci cevabının ve konuşmanın okunacağını, yaklaşık kaç AI çağrısı ve token gerektiğini ve platform anahtarını kullanıyorsanız AI kredinizden tahmini maliyeti görürsünüz. Henüz hiçbir şey değişmez.
3. Öğrenmeyi başlat'a basın. Çalıştırma ilerlemesi ve günlüğüyle aşağıda görünür.

Her cevap otomatik öğrenmeyle aynı adımlardan geçer: genel bir soru ve kişisel ayrıntı içermeyen bir cevap olarak yeniden yazılır; genel bir cevap herkes için öğrenilir (Öğrenilen cevapları kullanmadan önce incele açıksa onayınızı bekler); kişisel bir cevap o kişide kalır, kişi veri toplama açık şekilde kayıtlı değilse atlanır. Bilgi tabanının zaten bildiği bir cevap da, sınıflandırılamayan bir cevap da atlanır.

Yalnız AI asistanı ve otomatik öğrenme ikisi de açıkken çalışır. Çalışma sırasında biri kapatılırsa çalıştırma duraklar; yeniden açılınca sürdürün. Asistan kapalıyken otomatik olarak hiçbir şey öğrenilmez.

Bilgi sağlığı

Haftada bir Bilgi sağlığı kontrolü bilgi tabanınızı ölçer; Bilgi tabanı ekranının üstündeki kart sonucu ve eğilimini gösterir. Şimdi kontrol et hemen çalıştırır.

Ölçü	Anlamı	İyi değer
Bulma puanı	Deneme sorularınız varsa: parçası ilk 6 sonuç arasında gelen soruların oranı. Yoksa: örnek parçaların kendi başlığı soru olarak sorulur	Yüksek; düşüş, asistanın doğru parçayı daha az bulduğu demektir
Tekrarlar	Birebir kopya olan parçaların oranı	0'a yakın — Tekrarları temizle
Gömülü	Güncel modelle gömülmüş parçaların oranı	%100 — değilse Yeniden göm
Başarısız kaynaklar	Son işlenmesi başarısız olan kaynaklar	0
Başlıksız parçalar	Sayfa başlığı eksik web sitesi parçaları	0 — Eksik başlıkları ekle
Eskimiş sayfalar	30 gündür yeniden okunmayan web sayfaları	Site değişiyorsa düşük
Şüpheli iletişim bilgisi	"Telefon numarası" bir yıl veya tarihe benzeyen iletişim blokları	0 — kaynağı yenileyin
Ortalama parça uzunluğu	Parça başına karakter	Bilgi amaçlı

Bulma değerlendirmesi

Bulma değerlendirmesi kartı (Bilgi sağlığının altında) en önemli soruyu cevaplar: müşteri bilgi tabanınızın cevaplayabileceği bir şey sorduğunda asistan doğru parçayı buluyor mu — hizmet verdiğiniz her dilde? Kendi bilgi tabanınızdan yazılan deneme sorularıyla çalışır.

Değerlendirme başlatmak

1. Değerlendirmeyi başlat'a basın. Önce bir tahmin görürsünüz: kaç parça için deneme sorusu yazılacağı, bunun kaç AI çağrısı ve token tuttuğu, kaç arama yapılacağı ve — platform anahtarında — AI kredinizden tahmini maliyet (kendi anahtarınızda sağlayıcınız faturalar). Bilgi tabanınıza hiçbir şey yazılmaz.
2. Değerlendirmeyi başlat'a yeniden basın. Arka planda çalışır; ilerlemesi ve günlüğü Arka plan işlemleri altında görünür.

İlk değerlendirme deneme sorularını yazar; sonrakiler aynı soruları yeniden sorar (AI çağrısı yok, yalnız arama), böylece sayılar karşılaştırılabilir kalır. Soruları yenilemek için — örneğin kaynaklarınızda büyük bir değişiklikten sonra — Yeni deneme soruları yazdır'ı işaretleyin.

Deneme soruları her parçanın kendi dilinde yazılır. Japonca bir sayfaya Japonca, Arapça bir sayfaya Arapça sorular — o sayfanın müşterisinin soracağı gibi. AI her parça için parçanın cevapladığı, müşterinin kendi kelimeleriyle bir soru yazar; her üç parçadan birinde de bilgi tabanınızın cevaplamadığı gerçekçi bir soru. Tek bir kişiye ait parçalar (kişiye özel öğrenilmiş cevaplar) hiç kullanılmaz.

"Bilgi tabanında yok" soruları bilgi tabanınızla karşılaştırılır. AI böyle bir soruyu yalnız tek bir parçaya bakarak yazar; başka bir sayfanın cevapladığı bir şeyi sorabilir. Yazımdan hemen sonra her yeni "bilgi tabanında yok" sorusu bir kez aranır. Hem sorunun kelimelerinin yeterincesini içeren hem de anlamca yakın bir parça gelirse (asistanın kullandığı iki sınır, birlikte), soru "bilgi tabanında yok" olarak tutulmaz: kısa bir AI kontrolü o parçanın soruyu cevaplayıp cevaplamadığını sorar — evetse soru o parçayı gösteren cevaplanabilir bir soruya çevrilir; hayırsa ya da kontrol yapılamazsa silinir. Sizin yazdığınız ya da düzenlediğiniz sorulara hiç dokunulmaz. Tahmin bu kontrolleri de sayar; kart kaç sorunun çevrildiğini ya da silindiğini gösterir.

Otomatik deneme soruları

Deneme sorularını otomatik yaz açıkken (varsayılan), henüz deneme sorusu olmayan bir çalışma alanı bunları haftalık Bilgi sağlığı kontrolünden alır: kontrol, soruları yazan (30 parça) ve ölçen tek bir değerlendirmeyi kuyruğa alır. Bu yalnızca şu durumda olur:

• AI asistanı açıksa (çalışma sırasında kapatılırsa değerlendirme daha fazla harcamadan durur);
• bir gömme modeli ve bir AI sohbet modeli kullanılabiliyorsa;
• platform anahtarında AI krediniz tahmini karşılıyorsa — karşılamıyorsa atlanır; krediniz hiçbir zaman sıfırın altına inmez.

Haftada en fazla bir kez denenir; atlanır ya da başarısız olursa bir sonraki haftalık kontrol yeniden karar verir. Her karar — kuyruğa alındı ya da neden atlandı — sağlık kontrolünün Arka plan işlemleri altındaki günlüğüne yazılır. Şimdi kontrol et ile başlatılan kontrol hiçbir zaman soru yazmaz. Değerlendirmeleri yalnız elle çalıştırmak için anahtarı kapatın; telefonda bu ayar salt okunur gösterilir.

Sayıların anlamı

Ölçü	Anlamı	İyi değer
İlk 6 içinde bulundu	Parçası, asistana verilen 6 parça arasında çıkan deneme sorularının oranı	Yüksek
İlk sırada bulundu	Parçası en üstte çıkanların oranı	Yüksek
Ortalama sıra puanı (MRR)	Doğru parça hep ilk sıradaysa 1, hep ikinci sıradaysa ½	1'e yakın
"Bilgi tabanında yok" yine de cevaplandı	Bilgi tabanınızın cevaplayamadığı sorulardan, aramanın yine de parça getirdiklerinin oranı — asistan "bilmiyorum" demek ya da devretmek yerine ilgisiz bir şeyden cevaplardı	Düşük
Güncelliğini yitirmiş sorular	Sorular yazıldıktan sonra parçaları değişti ya da silindi	0 — soruları yeniden yazdırın

Sayıların altında önceki değerlendirmeye göre fark (Neler değişti daha iyi ya da daha kötü cevaplanan soruları listeler), eğilim, dile göre tablo ve — sorularınız gösteriyorsa — daha az "bilgi tabanında yok" cevabı verecek bir mesafe sınırı önerisi görürsünüz. Öneri yalnız gösterilir; hiçbir şey değiştirilmez.

Anahtar kelime kanıtı aramanın öteki sınırını gösterir: anlamca uzak bir parça, sorunun kelimelerinin yeterincesini içeriyorsa yine kullanılır — bugün yarısını. Tablo sorularınızı kelimelerin %34'ü, %50'si ve %67'si istenerek (mesafe sınırı aynı) yeniden oynatır ve her birinde kaç parçanın bulunacağını, kaç "bilgi tabanında yok" sorusunun cevaplanacağını gösterir. Sorularınızda başka bir düzey daha iyi sonuç veriyorsa önerilir — o da yalnız gösterilir, uygulanmaz. Fazladan bir maliyeti yoktur: aynı arama sonuçlarını yeniden okur.

En az beş deneme sorunuz olduğunda haftalık Bilgi sağlığı kontrolü de onları sorar; sağlık kartındaki bulma puanı sizin sorularınızı izler. Tek seferlik otomatik ilk küme dışında haftalık kontrol hiçbir zaman yeni soru yazmaz.

Deneme soruları

Deneme soruları her soruyu dili, düzenleyip düzenlemediğiniz, kaynağı ve son değerlendirmede ne olduğu (2. sırada bulundu, Bulunamadı, Doğru: hiçbir şey bulunmadı, 3 parça getirildi) ile listeler. Şunları yapabilirsiniz:

• bir soruyu düzenlemek — düzenlediğiniz soru sizindir, sorular yeniden yazdırılınca korunur;
• anlamsız olanı silmek (örneğin bilgi tabanınızın başka bir yerde aslında cevapladığı bir "bilgi tabanında yok" sorusu);
• soruları yeniden yazdırmak (önce tahmin gösterilir).

Telefonda Menü → AI eğitimi → Arka plan işlemleri son sayıları salt okunur gösterir; değerlendirme başlatmak ve soruları düzenlemek web panelindedir.

Asistan nasıl arar

Asistan her soru için parçaları birbirinden bağımsız iki yolla arar ve iki sıralamayı birleştirir:

• anlama göre (gömme) ve
• kelimelere göre, her dilin kendi kurallarıyla: Türkçe, Almanca, Arapça ve birçok dil kelime köküyle eşleşir ("adresiniz" "Adres"i bulur); boşluksuz yazılan Japonca, Çince, Korece ve Tayca karakter çiftleriyle eşleşir; Arapça yazım farkları (hemzeli ya da hemzesiz, ة ya da ه, harekeli ya da harekesiz) aynı sayılır.

Anlamca uzak bir parça, ancak sorunun kelimelerinin en az yarısını içeriyorsa kullanılır — ilgisiz bir sayfayla tek ortak kelime artık yetmez. Her değerlendirme sizin sorularınızda %34 ve %67'yi de ölçer (yukarıda Anahtar kelime kanıtı).

Operatörler için

Kayıtlı bilgiyi değiştiren her komut varsayılan olarak kuru çalışır: ne yapacağını yazar ve --apply eklenene kadar hiçbir şeyi değiştirmez. Uzun işler arka plan işlemi olarak sıraya alınır; ilerlemeleri ve günlükleri panelde görünür.

php artisan knowledge:cleanup-failed-training [--tenant=acme] [--apply]
php artisan knowledge:dedupe [--tenant=acme] [--apply]
php artisan knowledge:reindex [--tenant=acme] [--source=<id>] [--apply]
php artisan knowledge:recontextualize [--tenant=acme] [--apply]
php artisan knowledge:index-lexical [--tenant=acme] [--apply] [--all]
php artisan knowledge:evaluate --tenant=acme [--questions=30] [--regenerate] [--apply]

• knowledge:evaluate, tek bir çalışma alanı için bulma değerlendirmesini çalıştırır. --apply olmadan tahmini yazar — soru yazılıp yazılmayacağı, AI çağrıları (yazım ve "bilgi tabanında yok" kontrolleri), aramalar, token, hangi anahtarın ödediği ve platform kredisinden maliyet. --tenant zorunludur.

• knowledge:index-lexical, kelime aramasının dizini kurulmadan önce kaydedilmiş parçaların dizinini kurar (o zamana kadar yalnız tam kelimeyle bulunurlar). Kaldığı yerden devam eder: istediğiniz an durdurup yeniden çalıştırın; --all bütün parçaları yeniden kurar.

• knowledge:cleanup-failed-training, AI kapalıyken otomatik yakalanıp hiç gömülemeyen (başarısız, parçasız) öğrenilmiş cevapları siler. Çalışma alanı başına sayıları listeler.

• knowledge:reindex --apply, kaynakları güncel boru hattıyla aynı güvenli yenilemeyle yeniden kurar: yeni sürüm tamamlanmadan hiçbir şey silinmez ve metni değişmeyen parçalar gömmesini korur.

Zamanlayıcı, kesilen işlemleri beş dakikada bir sürdürür (knowledge:resume-operations), 30 günden eski işlem günlüklerini temizler (knowledge:prune-operation-logs) ve haftalık sağlık kontrolünü sıraya alır (knowledge:schedule-quality-checks).