
*Yukarıdaki butona tıkla ve ekle. Yapay zeka gelişmelerini Google’da her zaman üstte gör.
RAGFlow ile sözleşme, kılavuz ve prosedür gibi kendi belgelerine soru soran, cevabın kaynağını gösteren bir yapay zeka asistanını adım adım kur.
ChatGPT'ye bayi sözleşmendeki iade süresini sorsan cevap veremez, çünkü o sözleşmeyi hiç görmedi. Belgeyi sohbete yapıştırırsan bu sefer de sayfa sayısı arttıkça tabloları karıştırmaya ve kendinden bilgi eklemeye başlar. RAGFlow bu sorunu çözmek için yapılmış açık kaynak bir araç. Belgelerini bir kez yüklüyorsun, sonra onlara soru soruyorsun. Gelen her cevabın altında, bilginin hangi belgenin hangi parçasından alındığı görünüyor.
RAGFlow'u InfiniFlow adlı şirket geliştiriyor, kod Apache-2.0 lisanslı. 6 Kasım 2026'da çıkan 1.0 sürümüyle "üretime hazır" etiketini aldı. Bu sürümle birlikte RAGFlow'un çekirdeği Go diliyle baştan yazıldı.
RAGi
yapay zekanın cevap vermeden önce senin belgelerinden ilgili parçaları bulup okuması en kolay açık kitap sınavıyla anlaşılır. Kapalı kitap sınavında öğrenci aklında kalanı yazar. Hatırlamadığı yerde boşluğu tahminle doldurur. Açık kitap sınavında ise önce kitaptaki ilgili sayfayı bulur, sonra cevabı oradan yazar.
Normal bir sohbet botu kapalı kitap sınavına giriyor gibi çalışır. RAG ise modele açık kitap verir. Soru gelince sistem önce belgelerinde en ilgili parçaları arar. Sonra bu parçaları modele verir ve "cevabı bunlara dayanarak yaz" der. Bu yöntem uydurma (halüsinasyon) riskini sıfırlamaz ama ciddi biçimde azaltır. Asıl kazancın şu: cevabın nereden geldiğini görüp kontrol edebiliyorsun.
Çoğu RAG aracının zayıf noktası belgeyi okuma biçimi. Bu araçlar bir PDF'i düz metne çeviriyor ve sabit uzunlukta parçalara bölüyor. Bu sırada tablonun satırları birbirine karışıyor, bir başlık ait olduğu paragraftan kopuyor.
RAGFlow belgeyi DeepDoci
sayfa düzenini, tabloları ve taranmış görüntüleri tanıyan belge okuma katmanı ile okuyor. Taranmış bir sözleşmedeki yazıyı tanıyor, tablonun hangi satırının hangi sütuna ait olduğunu koruyor, başlıkları altındaki metinle birlikte tutuyor. Word, PowerPoint, Excel, PDF, görsel, düz metin ve web sayfalarını içeri alabiliyor.
Belgeyi nasıl parçalayacağını da sen seçiyorsun. Genel belgeler, tablolar, soru-cevap listeleri, kılavuzlar, akademik makaleler, kitaplar, sunumlar ve yasal metinler için ayrı hazır şablonlar var. Parçaların nasıl bölündüğünü ekranda görüp elle düzeltebiliyorsun.
Belgeleri tek tek yüklemek zorunda da değilsin. RAGFlow Google Drive, OneDrive, SharePoint, Dropbox, Notion, Confluence ve Amazon S3 gibi kaynaklara bağlanıp oradaki dosyaları otomatik olarak eşitleyebiliyor. Eylül 2026'dan beri bir sitenin site haritasını verip o sitenin içeriğini de okutabiliyorsun.
RAGFlow'u iki şekilde kullanabilirsin. Birincisi RAGFlow'un kendi bulut hizmeti (cloud.ragflow.io): kurulum gerekmiyor, hesap açıp başlıyorsun. İkincisi yazılımı kendi sunucuna kurmak. Yazılım ücretsiz ama sunucu ve yapay zeka modeli masrafı sana ait.
| Durumun | Hangisi | Neden |
|---|---|---|
| Önce nasıl çalıştığını görmek istiyorsun | Bulut, ücretsiz plan | Kurulum yok, 10 dakikada ilk sorunu sorarsın |
| Ekibin küçük, belgelerin hassas değil | Bulut, ücretli plan | Sunucu bakımıyla uğraşmazsın |
| Sözleşme, müşteri verisi, hukuki belge | Kendi sunucun | Belgeler şirketin dışına çıkmaz |
| Asistanı kendi sitene ya da uygulamana bağlayacaksın | Ücretli bulut ya da kendi sunucun | Ücretsiz bulut planında API anahtarı yok |
| Mac'te denemek istiyorsun | Bulut | Docker kurulumu şu an macOS'u desteklemiyor |
Ücretsiz bulut planında ayda 500 kredi, 5 uygulama, 1 kişilik kullanım ve 100 MB veri alanı var. Ücretli planlarda (Starter ve Pro) kredi, kişi ve depolama sınırları yükseliyor ve APIi
başka bir yazılımın RAGFlow'a bağlanmasını sağlayan erişim kapısı anahtarı açılıyor. Starter planın liste fiyatı aylık 59 dolar, Pro planınki 259 dolar. Faturalama şu an beta aşamasında olduğu için ikisi de geçici indirimle 29 ve 129 dolardan satılıyor. Ücret şimdilik sadece DeepDoc ile yapılan PDF okumasına uygulanıyor, diğer okuma özellikleri geçici olarak ücretsiz. Kurumsal kullanım için ayrıca teklif usulü bir plan var.
[mindi_yorum]
💰 Kendi sunucunda yazılım ücretsiz. Bulutta ücretsiz plan 500 kredi ve 100 MB veriyle sınırlı, API anahtarı ise ancak ücretli planda açılıyor.
🟢 Tablolu ve taranmış belgelerde parçalama kalitesi RAGFlow'un en güçlü yanı. Cevabın hangi parçadan geldiğini tek tıkla görmek de ekibin araca güvenmesini kolaylaştırıyor.
🟡 29 ve 129 dolarlık fiyatlar beta dönemine ait geçici indirim. Bütçeni 59 ve 259 dolarlık liste fiyatına göre yap.
🔵 İlk denemeyi gerçek bir belgeyle yap: 10-15 sayfalık, içinde tablo olan bir sözleşme ya da fiyat listesi RAGFlow'un farkını en hızlı gösteren test.
Örnek olarak bir mobilya üreticisini düşünelim. Elinde bayilerle yapılmış sözleşmeler, bir iade prosedürü ve bir fiyat listesi var. Satış ekibi gün içinde "Bu bayinin ödeme vadesi kaç gün?", "Hasarlı ürün iadesinde süre ne?" gibi soruları sürekli soruyor. Amaç bu belgeleri bir asistana bağlamak.
Hesabını açtıktan sonra üst menüdeki veri seti (Dataset) bölümüne gir ve yeni bir veri seti oluştur. Ona "Bayi Sözleşmeleri" gibi anlaşılır bir ad ver. Bu ekranda iki önemli seçim yapacaksın: belgelerin nasıl parçalanacağı ve hangi embeddingi
metni anlamına göre sayılara çeviren, aramayı mümkün kılan model modelinin kullanılacağı.
Sözleşmeler ve prosedür metinleri için genel şablon (General) iyi bir başlangıç. Fiyat listesi gibi tablo ağırlıklı Excel dosyaları için tablo şablonunu (Table), yönetmelik ya da madde madde ilerleyen yasal metinler için yasa şablonunu (Laws) seç. Tek bir veri setinde farklı türde belgeler varsa, şablonu dosya bazında da değiştirebilirsin.
Dosyalarını yükle ve ayrıştırmayı başlat. Durum tamamlandı olarak görününce bir belgeye tıkla ve RAGFlow'un onu nasıl parçaladığına bak. Bir tablonun ortadan bölündüğünü ya da bir maddenin başlığından koptuğunu görürsen parçayı elle düzeltebilirsin. Bu adımı atlama, çünkü cevap kalitesi en çok burada belirleniyor.
Üst menüdeki Chat sekmesine geç ve "Create an assistant" (asistan oluştur) düğmesine tıkla. Açılan pencerede üç grup ayar var:
Asistan ayarları: Asistana ad ver ve az önce oluşturduğun veri setini seç. Burada "Empty response" (boş cevap) diye bir alan var. Bu alan, belgelerde cevap bulunamadığında asistanın ne diyeceğini belirliyor. Buraya "Bu bilgi yüklenen belgelerde yok" gibi bir cümle yaz. Alanı boş bırakırsan asistan cevabı kendisi uydurmaya çalışabilir. Kaynakları gösterme seçeneği (Show quote) varsayılan olarak açık, öyle kalsın.
Prompt ayarları: Burada system prompti
yapay zekaya rolünü ve sınırlarını anlatan ana talimat yazılıyor. "Sadece verilen belgelere dayanarak cevap ver, emin değilsen belgede olmadığını söyle" gibi net bir kural ekle. Benzerlik eşiği de bu bölümde. Varsayılan değeri 0.2 ve bu değerin altında kalan parçalar cevaba alınmıyor.
Model ayarları: Cevabı yazacak modeli seç. Burada hazır ön ayarlar var. Belge tabanlı işlerde hassas (Precise) ayarını seç. Bu ayar temperaturei
modelin cevaplarındaki rastgelelik derecesi değerini düşük tutuyor ve modelin belgeden sapmasını azaltıyor.
Asistanı kaydedince sohbet ekranı açılıyor. Şunları sorabilirsin: "Ankara bayisinin ödeme vadesi kaç gün?", "Hasarlı ürün iadesi için müşterinin kaç gün içinde bildirim yapması gerekiyor?", "Hangi bayilerin sözleşmesinde bölgesel münhasırlık maddesi var?" Cevaptaki küçük numaralara tıkladığında bilginin alındığı parçayı görürsün. Bir cevaptan şüphelenirsen önce oraya bak.
Belgelerin şirket dışına çıkmaması gerekiyorsa RAGFlow'u kendi sunucuna kurabilirsin. Bunun için Dockeri
bir yazılımı ihtiyaç duyduğu her şeyle birlikte paketleyip tek komutla çalıştıran araç kullanılıyor. Kendi sunucun yoksa bir VPS kiralayabilirsin; nasıl yapılacağını VPS rehberimizde anlattık.
Önerilen başlangıç donanımı 4 işlemci çekirdeği, 16 GB RAM ve 50 GB boş disk. Docker 24.0.0 ya da üstü ve Docker Compose v2.26.1 ya da üstü gerekiyor. Hem x86 hem ARM işlemcili sunucular için hazır paket var. macOS ise şu an desteklenmiyor, o yüzden kurulumu bir Linux sunucuda yap.
RAGFlow belge arama motoru olarak Elasticsearch ya da Infinity kullanabiliyor. Elasticsearch kullanacaksan önce sunucuda bir sistem ayarını yükseltmen gerekiyor. Infinity ile bu adım genelde gerekmiyor.
sudo sysctl -w vm.max_map_count=262144
Bu ayar sunucu yeniden başlayınca sıfırlanıyor. Kalıcı olsun istiyorsan aynı satırı /etc/sysctl.conf dosyasına ekle. Ardından RAGFlow'u indirip 1.0 sürümüyle başlat:
git clone https://github.com/infiniflow/ragflow.git
cd ragflow/docker
git checkout v1.0.0
docker compose -f docker-compose.yml up -d
Paketlerin inmesi internet hızına göre birkaç dakika sürüyor. Servisler açılınca tarayıcıdan sunucunun IP adresine gir. Port numarası yazmana gerek yok. İlk girişte hesabını oluşturuyorsun.
RAGFlow'un içinde hazır bir yapay zeka modeli gelmiyor. Sağ üstteki profil resmine tıkla ve model sağlayıcıları (Model providers) sayfasına gir. Burada üç model tanımlıyorsun: cevabı yazacak sohbet modeli, belgeleri aranabilir hale getiren embedding modeli ve bulunan parçaları alakaya göre yeniden sıralayan rerank modeli. Sonra aynı sayfadan bunları varsayılan model olarak ayarla.
Bulut sağlayıcıların (OpenAI, Anthropic, Google gibi) API anahtarını girebilirsin. Ama belgelerin hiçbir şekilde dışarı çıkmasın istiyorsan modelleri de yerelde çalıştırman gerekiyor. Bunun en kolay yolu Ollama. Burada bir tuzak var: RAGFlow Docker içinde çalıştığı için Ollama adresine "localhost" yazarsan bağlanamaz. Ollama aynı makinedeyse adres olarak http://host.docker.internal:11434 yaz. Ollama başka bir makinedeyse o makinenin IP adresini kullan. Ollama'nın 11434 portunu internete açık bırakma, sadece kendi ağından erişilebilsin. Embedding modeli olarak çok dilli bir model seç, örneğin Türkçeyi de destekleyen bge-m3.
RAGFlow'u kendi sitene ya da başka bir uygulamaya bağlamak için API anahtarı gerekiyor. Anahtar asistan ayarlarında değil. Sağ üstteki profil resmine tıklayıp API sayfasına girerek oluşturuyorsun. RAGFlow'un kendi MCPi
yapay zeka araçlarının birbirine bağlanmasını sağlayan ortak dil sunucusu da var. Claude gibi bir asistandan veri setlerini doğrudan sorgulayabiliyorsun. MCP'yi ilk kez duyuyorsan MCP rehberimize bakabilirsin.
RAGFlow Türkçe belgeleri okuyabiliyor ama cevap kalitesi büyük ölçüde senin ayarlarına bağlı. Şu beş alışkanlık farkı en çok hissettiren adımlar.
Taranmış belgenin kalitesine dikkat et. Eğik çekilmiş, gölgeli ya da düşük çözünürlüklü bir tarama DeepDoc'u da zorlar. Önemli sözleşmeleri düz ve net taratmak, sonradan çıkacak hataları baştan önler.
Embedding modelini çok dilli seç. Sadece İngilizce için eğitilmiş bir embedding modeli Türkçe soruyla Türkçe paragrafı eşleştirmekte zorlanır. Model seçerken Türkçeyi desteklediğinden emin ol.
Parçaları kontrol etmeden asistanı ekibe açma. RAGFlow'da bir getirme testi (Retrieval testing) ekranı var. Buraya en sık sorulacak 5-10 soruyu yaz ve hangi parçaların geldiğine bak. Doğru paragraf üst sıralarda gelmiyorsa parçalama şablonunu ya da benzerlik eşiğini değiştir.
Soruyu belgenin diliyle sor. Sözleşmede "vade" yazıyorsa "ne zaman ödeyecek" yerine "ödeme vadesi" diye sormak isabeti artırır. Ekip arkadaşlarına da bu alışkanlığı kazandır.
Kaynağa bakmayı alışkanlık haline getir. Asistan kaynak gösteriyor diye her cevap doğru değildir. Özellikle rakam, tarih ve tutar içeren cevaplarda numaraya tıklayıp orijinal parçayı oku.
Kurulum ağır. 16 GB RAM önerilen başlangıç değeri. Belge sayısı ve aynı anda soru soran kişi sayısı arttıkça ihtiyaç büyüyor. Eski bir dizüstünde denemek yerine bulut sürümüyle başla.
macOS desteklenmiyor. Docker kurulumu şu an Mac'te çalışmıyor. Mac kullanıyorsan bulut sürümünü ya da bir Linux sunucuyu düşün.
Belge okuma ekran kartını kullanmıyor. Açık kaynak 1.0 sürümünde DeepDoc sadece işlemciyle çalışıyor. Yüzlerce sayfalık taranmış belgeyi yüklediğinde işlemin uzun sürmesine hazırlıklı ol.
1.0'a yükseltme tek yönlü. Eski 0.x sürümünü kullanıyorsan 1.0'a geçtikten sonra eski sürüme kendiliğinden dönemiyorsun. Yükseltmeden önce verinin tam yedeğini al.
Ücretsiz bulut planında API yok. Asistanı kendi uygulamana bağlayacaksan ya ücretli plana geçmen ya da kendi sunucuna kurman gerekiyor.
Şirket yurt dışında kayıtlı. RAGFlow'un bulut hizmetini işleten InfiniFlow Inc. Cayman Adaları'nda kayıtlı. Şirket belgelerini bulut sürümüne yükleyeceksen önce veri işleme sözleşmesini (DPA) incele.
[mindi_yorum]
💰 Kendi sunucunda kurulum ücretsiz ama 16 GB RAM'li bir sunucunun aylık maliyetini ve kullandığın modelin ücretini hesaba kat.
🟢 Kaynağı gösteren cevaplar sayesinde "yapay zeka uydurdu mu?" sorusunu tek tıkla cevaplayabiliyorsun. Hukuk ve satış ekipleri için asıl değer bu.
🟡 Mac'te kurulmuyor, belge okuma ekran kartı kullanmıyor ve 1.0'a geçiş tek yönlü. Kurulum kararından önce bu üçünü bil.
🔵 "Empty response" alanını mutlaka doldur. Boş bırakırsan asistan bilmediği soruya da cevap yazmaya çalışır.
Sadece birkaç PDF'ten hızlıca özet çıkarmak istiyorsan RAGFlow fazla ağır kalabilir. Bu iş için PDF ve doküman işleme araçları rehberimizdeki hazır araçlar daha pratik.