Doküman Yükleme
Bir bilgi tabanına eklediğin her doküman, saniyeler içinde asistanının “hafızasına” dönüşür: metin küçük parçalara (chunk) bölünür, her parça bir embedding’e (anlam vektörü) çevrilir, arama sırasında asistan en ilgili parçayı bulup cevaba katar. Doğru formatta ve düzenli yazılmış bir doküman, asistanın doğru cevap verme ihtimalini doğrudan artırır — dağınık bir doküman ise chunk’lama sırasında bağlamını kaybedebilir.
Desteklenen formatlar
Panelden dosya yüklerken seçebileceğin formatlar:
| Format | Uzantı | Not |
|---|---|---|
| Düz metin | .txt | En güvenilir seçenek. |
| Markdown | .md | Başlıklar (#, ##) chunk sınırları için iyi bir işaret verir. |
| HTML | .html / .htm | Etiketler (<script>, <style> dahil) ayıklanır, sade metin kalır. |
| CSV | .csv | Satırlar okunabilir metne çevrilir (virgüller ` |
| JSON | .json | Anahtar-değer çiftleri düz metne dönüştürülür. |
Ayrıca Metin Yapıştır sekmesiyle dosya yüklemeden doğrudan metin de ekleyebilirsin — sık güncellenen kısa notlar (fiyat listesi, SSS) için pratik.
PDF dosyası şu an panelden yüklenemiyor — dosya seçim penceresi yalnızca TXT, MD, CSV, JSON ve HTML uzantılarını kabul ediyor. Bir PDF’in içeriğini kullanmak istiyorsan, metnini kopyalayıp Metin Yapıştır ile ekle.
Boyut sınırı
Doküman başına üst sınır 5 MB. Bu sınır hem dosya yüklemede hem de yapıştırılan metinde geçerli; aşarsan panel “Doküman boyutu 5 MB sınırını aşıyor” hatası döner. Çoğu ürün kataloğu veya SSS metni bunun çok altında kalır; sınıra yaklaşıyorsan dokümanı konu bazlı birden fazla dosyaya bölmek hem yükleme hem arama kalitesi açısından daha iyi sonuç verir.
Yükleme ve işleme
Bilgi tabanını aç
Bilgi Tabanı sayfasında ilgili bilgi tabanını seç, ardından Döküman Ekle’ye tıkla.
📸 [Ekran görüntüsü: Bilgi tabanı detay ekranı — “Döküman Ekle” butonu]
Yükleme türünü seç
Açılan pencerede iki sekme var:
- Metin Yapıştır — döküman adı ve içerik metnini doğrudan yaz/yapıştır.
- Dosya Yükle — bilgisayarından TXT, MD, CSV, JSON veya HTML dosyası seç.
📸 [Ekran görüntüsü: “Döküman Ekle” penceresi — Metin Yapıştır / Dosya Yükle sekmeleri]
Yükle & İşle’ye tıkla
Doküman kaydedilir ve durumu Bekliyor’a (pending) döner. Ayıklama (parse) → chunk’lama → embedding üretimi → vektör veritabanına yazım işi arka planda bir kuyrukta (BullMQ) yapılır — sayfa bunun bitmesini beklemez, tarayıcın kilitlenmez. Büyük bir dosya için bu adım birkaç saniyeden bir-iki dakikaya kadar sürebilir; süre metnin uzunluğuna ve o an kuyrukta bekleyen başka iş olup olmadığına bağlıdır.
Kuyruk altyapısı (Redis) bir sebeple erişilemezse Purvisor otomatik olarak senkron işlemeye düşer — doküman aynı istek içinde işlenir ve sonuç anında döner. Özellik kuyruksuz ortamda da çalışmaya devam eder, sadece büyük dosyalarda istek biraz daha uzun sürebilir.
İşleme durumunu kontrol et
Döküman listesinde her satırda bir durum rozeti görünür:
| Durum | Anlamı |
|---|---|
Bekliyor (pending) | Kuyruğa alındı, sıradaki işçinin (worker) sırası bekleniyor. |
İşleniyor… (processing) | Metin ayıklanıyor, chunk’lara bölünüyor, embedding üretiliyor. |
Hazır (completed) | Chunk’lar oluştu, asistan artık bu dokümandan arama yapabilir. |
Hata (failed) | İşleme başarısız oldu (bkz. Sorun giderme). |
Durum canlı olarak kendiliğinden yenilenmez — yükleme bittiğinde panel bir kez tazelenir, sonrasında güncel durumu görmek için bilgi tabanları sayfasını yenile veya bilgi tabanını tekrar aç. failed durumuna düşen bir doküman için bildirim merkezinde de bir uyarı belirir.
İyi bir kaynak doküman nasıl olur?
- Kısa paragraflar — chunk’lama önce paragraf sınırlarından böler (iki satır boşluk = yeni paragraf). Tek bir dev paragrafa sıkıştırılmış metin, cümle bazlı bölünmeye düşer ve bağlam kaybedebilir.
- Net başlıklar — Markdown’da
##gibi başlıklar konuyu ayırır, asistanın “hangi chunk hangi konu” ayrımını netleştirir. - Bir konu, bir doküman — “Fiyatlandırma”, “İade Politikası”, “SSS” gibi konuları ayrı dokümanlara böl; tek bir dev dosyada karışık konular arama isabetini düşürür.
- Güncel tut — fiyat/kampanya gibi sık değişen bilgiyi ayrı, kısa bir dokümanda tut ki güncellemesi tek tıkla (yeniden yükle) mümkün olsun.
- Gereksiz gürültüden kaçın — menü/navigasyon metni, tekrarlayan altbilgi gibi içerik chunk’ları şişirir; sadece asistanın bilmesi gereken bilgiyi bırak.
Sorun giderme
| Belirti | Olası neden / çözüm |
|---|---|
| Dosya seçim penceresinde dosyam görünmüyor | Format desteklenmiyor — sadece TXT, MD, CSV, JSON, HTML kabul edilir (PDF dahil değil). |
| ”Doküman boyutu 5 MB sınırını aşıyor” | Dosyayı/metni böl veya gereksiz kısımları (görsel, tekrar) çıkar. |
| Durum uzun süre Bekliyor’da kaldı | Kuyrukta yoğunluk olabilir; sayfayı yenileyip tekrar kontrol et. |
| Durum Hata’da | En sık neden: dosyadan anlamlı metin çıkarılamadı (örn. boş/bozuk içerik) veya embedding servisine geçici erişim sorunu — dokümanı sil, içeriği kontrol edip tekrar yükle. |
| Asistan dokümandaki bilgiyi bilmiyor | Durum Hazır mı kontrol et; ayrıca bilgi tabanının asistana bağlı olduğundan emin ol — bkz. Asistana Bağlama. |