Bilgi tabanı oluşturma

Widget'ınızın cevapları yalnızca bilgi tabanınızdan gelir. Bu rehber, bir bilgi tabanını sıfırdan nasıl kuracağınızı gösterir: web sitenizi tarayarak, forum ve dosya kaynakları ekleyerek, güncel tutarak ve kaliteyi yükselterek.

1. Web sitenizi ekleyin (crawl)

En hızlı yol: site adresinizi verip taramayı başlatmak. SemAgent iki yolla sayfa keşfeder:

• Sitemap — sitenizde sitemap.xml varsa, listelenen tüm URL'ler alınır (en temiz yöntem).
• BFS link takibi — sitemap yoksa, verdiğiniz adresten başlayıp iç linkleri genişleyerek (breadth-first) sayfaları keşfeder.

Bilgi tabanı panelinden Kaynak ekle → Web sitesi deyip başlangıç URL'sini girin. Kapsamı daraltmak için url_include desenleri kullanın — örneğin yalnız yardım merkezini taramak:

Başlangıç URL:  https://ornek.com/
Yalnız şu yolları dahil et (url_include):
  /yardim/
  /sss/
  /blog/

2. Forum kaynağı ekleyin (opsiyonel)

Topluluk forumunuz varsa, SemAgent 5 forum motorunu otomatik algılar: phpBB, inSided, Discourse, XenForo, vBulletin. Forum URL'sini kaynak olarak ekleyin; motor tanınır ve konular ayrıştırılır.

• Yalnız cevaplanmış konular (only_answered) filtresini açık tutun — çözülmemiş/spam başlıklar bilgi tabanını kirletmesin.
• Forum içeriği çoğu zaman en değerli kaynaktır: gerçek müşteri sorularının gerçek çözümleri.

3. Dosya yükleyin

Web'de olmayan içerik için — ürün kılavuzları, politika belgeleri, fiyat listeleri — dosyaları doğrudan yükleyin. Desteklenen türler: PDF, Word (.docx), Excel (.xlsx), CSV, JSON, Markdown, düz metin ve görseller (PNG, JPG, WebP; içindeki yazı okunur). Dosya başına en çok 10 MB. Yüklenen dosyalar diğer kaynaklarla aynı şekilde parçalanıp indexlenir. Her dosya yüklendikten sonra virüs taramasından geçer; zararlı çıkan dosya kaldırılır ve Denetim Kaydı'na yazılır. Metni çıkarıldıktan sonra dosyanın kendisi saklanmaz; bilgi tabanında metni kalır.

4. Taramayı başlatın ve izleyin

Kaynakları ekledikten sonra taramayı başlatın. Tarama sırasında ve sonrasında crawl log'u izleyebilirsiniz — her satır bir sayfayı ve sebebini gösterir:

"Neden bu sayfa indexlenmedi?" sorusunun cevabı her zaman bu logdadır. Uzun taramalar kesilirse checkpoint/resume sayesinde kaldığı yerden devam eder — baştan başlamaz.

5. Bot-korumalı siteler (stealth)

Kendi siteniz Cloudflare gibi bir bot korumasının arkasındaysa, standart tarama 403 alabilir. Bu durumda SemAgent stealth taramaya geçer: gerçek tarayıcı parmak iziyle (camoufox) ve proxy havuzu üzerinden erişir.

6. Güncel tutun (zamanlanmış re-crawl)

İçeriğiniz değiştikçe bilgi tabanı bayatlar. Zamanlanmış yeniden tarama ile kaynakları belirli aralıklarla otomatik tazeleyin (ör. haftalık). Böylece widget her zaman güncel fiyat/politika/ürün bilgisini verir.

7. Kaliteyi yükseltin (döngü)

Bilgi tabanı bir kez kurulup bırakılan değil, beslenen bir şeydir. İki araç bu döngüyü kolaylaştırır:

• Cevap test hattı — yayına almadan örnek soruları çalıştırın; hangi cevabın hangi kaynaktan geldiğini görün.
• Cevapsız-soru raporu — widget'ın cevaplayamadığı gerçek müşteri soruları panelde birikir. Bu liste, bilgi tabanınızın yol haritasıdır: her cevapsız soru için bir kaynak ekleyin.

8. Düzenleyin (KB klasörleri)

Çok sayıda kaynak biriktiğinde, bunları klasörlerle gruplayabilirsiniz (ör. "Ürünler", "İade politikası", "SSS"). Klasörler organizasyoneldir — arama/retrieval davranışını değiştirmez, yalnızca yönetimi kolaylaştırır.

Sonraki adımlar

• Widget kurulum & persona — bilgi tabanınızı canlı widget'a bağlama.
• Cevap kalitesi & grounding — chunk'lama, hibrit arama ve strict-KB'nin iç işleyişi.