Doküman Depoları
Doküman deposu, akışların arayabileceği adlandırılmış bir içerik koleksiyonudur. Her bilgi gövdesi için bir depo: bir ürün kılavuzu, bir politika el kitabı, bir destek arşivi.
Doküman deposu nedir
Bir depo üst üste binmiş üç şeydir:
- Yükleyiciler — içeriğin nereden geldiği ve nasıl bölündüğü.
- Parçalar — yükleyicilerin ürettiği pasajlar.
- Bir vektör indeksi — bu parçaların aranabilir hâli.
Depo üçünü birden tutar ve Bilgi Getirici node'u onu adıyla arar. Alttaki dokümanları değiştirin; depoyu kullanan her akış yeni içeriği alır — akışta hiçbir düzenleme gerekmez.
Depo oluşturma
Dokümanlar sayfasında Yeni Ekle düğmesine basın, sonra depoya bir ad ve açıklama verin.
Adı dosyaya değil bilgiye göre koyun: İade politikası, dok_v3_son.pdf değil. Bir
Agent node'unun birden fazla deposu olduğunda hangisini
arayacağına ad üzerinden karar verir.
Açıklama da aynı nedenle önemlidir. İçinde ne olduğunu ve ne zaman kullanılacağını yazın.
Bir deponun içi nasıl görünür
Bir depoyu açtığınızda yükleyicilerini görürsünüz; her biri kullandığı ayırıcı, geldiği kaynak ve ürettiği parça ile karakter sayısıyla birlikte.
Buradan: Document Loader Ekle daha fazla içerik getirir; Diğer İşlemler ise deponun yönetim seçeneklerini barındırır — Parçaları Görüntüle ve Düzenle, Tüm Parçaları Upsert Et, Getirme Sorgusu, Yenile ve Sil.
İki şey başka yerdedir: Yükleme Geçmişi, Tüm Parçaları Upsert Et ekranındaki bir geçmiş simgesidir; Upsert API bilgileri ise tek bir yükleyici satırının Seçenekler → API'yi Görüntüle menüsündedir.
Depo durumları
Depodaki rozet, aranmaya hazır olup olmadığını söyler:
| Durum | Anlamı | Ne yapmalı |
|---|---|---|
| Boş | Henüz içerik yok | Bir doküman yükleyici ekleyin |
| Bayat | En az bir yükleyici dosyalarını hâlâ işliyor | Bekleyin, sonra Yenile |
| Senkronlanıyor | Yükleyiciler şu anda işleniyor | Bekleyin |
| Senkron | Her yükleyici işlendi — parçalar hazır ama henüz indekslenmedi | Tüm Parçaları Upsert Et'i çalıştırın |
| Yükleniyor | Parçalar gömülüyor ve indeksleniyor | Bekleyin — büyük bir depo dakikalar alır |
| Upsert Edildi | İndekslenmiş ve aranabilir | Bir şey yok. Sağlıklı durum budur |
Karışan ikili Senkron ile Upsert Edildi'dir. Senkron yalnızca dosyaların işlenmeyi bitirdiği anlamına gelir; içerik henüz vector store'da değildir ve depoya bağlı bir Bilgi Getirici hiçbir şey bulamaz. Upsert Edildi aranabilir durumdur ve Getirme Sorgusu'nun seçilebildiği tek durumdur — o menü öğesi soluksa depo upsert edilmemiştir.
Bayat, indeksle değil işlemeyle ilgilidir: bir yükleyici bitmemiştir, dolayısıyla deponun parça sayıları eksiktir. Yenileyin, Senkron'u bekleyin, sonra upsert edin.
Bir yükleyici eklemek ya da parça düzenlemek içeriği değiştirir ama vector store'u değiştirmez; rozeti de geri almaz. Siz Tüm Parçaları Upsert Et'i tekrar çalıştırana kadar akış, daha önce indekslenmiş sürümden yanıtlamayı sürdürür. Bir bot geçen hafta güncellediğiniz bir politikayı hâlâ eskisiyle aktarıyorsa önce upsert edin.
Depo düzenleme ve silme
Depoyu kendi başlığından yeniden adlandırın ya da açıklamasını değiştirin. İkisi de güvenlidir: akışlar depoya adıyla değil kimliğiyle başvurur.
Silmek güvenli değildir. Parçaları ve indeksi kaldırır; depoyu gösteren her Bilgi Getirici hiçbir şey döndürmemeye başlar — genellikle belirgin bir hata olmadan, çünkü hiç pasaj bulamayan bir getirme işlemi teknik olarak hata değildir. Akış yalnızca daha kötü yanıt verir.
Silmeden önce akışlarınızda deponun adını arayın. Bir Bilgi Getirici onu kullanıyorsa önce node'u başka bir depoya yöneltin.
İlgili
- Doküman yükleyiciler — depoya içerik getirme
- Vector store — embeddings, indeksleme ve "upsert" ne demek
- Bilgi Getirici node — depoyu akıştan arama