Skip to main content

> tpl_air_001

RAG Mimarisi Dokümanı ve Üretim Şartnamesi

Veri alım boru hatları, parçalama, hibrit erişim, çapraz kodlayıcı yeniden sıralama, dayanak politikaları ve RAG Üçlüsü değerlendirme çerçevesini kapsayan Geri Alım Destekli Üretim (RAG) mimari şartnamesi.

TEMPLATE // INSPECT: TPL-AIR-001MODIFIED: 2026-09-17
KATEGORİÜretken Yapay Zekâ, RAG ve Ajanlar
SÜRÜMv1.0.0
RİSK SEVİYESİCRITICAL
ARTEFAKT SINIFIDOC
FORMATLARdocx, pdf, md, mermaid
YAPAY ZEKÂ VE YÖNETİCİ ÖZETİ (AI SUMMARY)

Kurumsal RAG ve Ajanlı sistemler için kapsamlı teknik mimari şartnamesi. Üretim ortamındaki halüsinasyonları engellemek için veri alım CDC'sini, parçalama stratejilerini, yoğun/leksikal hibrit arama algoritmalarını, katı atıf/dayanak eşiklerini ve otomatik değerlendirme metriklerini tanımlar.

Önemli Teknik Doküman Şablonu ve Hukuki Uyarı

TinyCTO.tv Teknik Doküman Şablon Bildirimi: Bu şablon genel eğitim ve operasyon amaçlı bir başlangıç materyalidir. Hukuki, vergisel, muhasebesel, yatırım, satın alma, mevzuat, güvenlik veya sertifikasyon danışmanlığı değildir. Gereklilikler ülkeye, kuruma, sözleşmeye ve riske göre değişir. Kullanmadan önce yetkin uzmanlarla gözden geçirip uyarlayın.

Çözülen Üretim Problemi

Canlı üretken yapay zekâ sistemlerinde ortaya çıkan yıkıcı halüsinasyonları, güncel olmayan bilgiye dayandırmayı, vektör alanlarındaki yetkisiz erişim sızıntılarını, fırlayan token maliyetlerini ve ölçülemeyen arama performans kayıplarını önler.

Ne Zaman Kullanılmalı?

  • Kurumsal sohbet ajanı, teknik dokümantasyon asistanı veya anlamsal arama motoru tasarlarken.
  • Basit bir kavram kanıtlama (POC) RAG kodundan ölçeklenebilir kurumsal üretim mimarisine geçerken.
  • LLM çıktılarının kaynak gerçeklikle doğrulanabilir olması gereken yasal uyum projelerinde.
  • Vektör veritabanı güvenliğini, kiracı veri yalıtımını ve erişim gecikme bütçelerini denetlerken.

Ne Zaman Kullanılmamalı?

  • Harici bilgi gerektirmeyen basit durumsuz LLM sınıflandırma veya duygu analizi görevlerinde.
  • Tüm içeriğin erişim gerektirmeden modern 128k+ bağlam penceresine sığdığı küçük bellek içi istemlerde.
  • Metinden SQL'e veya doğrudan ilişkisel raporlamanın daha deterministik olduğu saf yapılandırılmış SQL sorgularında.

7 Şablon Bölümü ve Yapısal İskelet

1. Yönetici Özeti ve Sistem Hedeflerilean, standard, enterprise, regulated

İş motivasyonu, bilgi külliyatı kapsamı ve beklenen operasyonel ROI.

Yönerge:Hedef kitleyi, günlük sorgu hacmini ve doğru bilginin sağlayacağı iş etkisini tanımlayın.
2. Bilgi Kaynağı Envanteri ve Veri Alım Boru Hatlarılean, standard, enterprise, regulated

Bağlayıcılar, Değişiklik Verisi Yakalama (CDC), dosya ayrıştırma ve mükerrer kayıt temizliği.

Yönerge:Taranmış PDF'ler için OCR motorlarını, HTML temizleyicileri ve artımlı senkronizasyonu belirtin.
3. Parçalama Stratejisi ve Doküman Hiyerarşisilean, standard, enterprise, regulated

Parça boyutları, örtüşme pencereleri, özyinelemeli markdown bölme ve anlamsal sınırların korunması.

Yönerge:Hedef parça boyutunu (ör. 64 token örtüşmeli 512 token) ve ebeveyn-çocuk bağlarını belgeleyin.
4. Gömme Modelleri ve Vektör Veritabanı Topolojisistandard, enterprise, regulated

Yoğun gömme seçimi, boyut ödünleşimleri, indeks türü (HNSW vs IVFFlat) ve küme parçalama.

Yönerge:MTEB puanını, kosinüs vs iç çarpım metriğini, bellek ayak izini ve skalar kuantizasyonu değerlendirin.
5. Hibrit Erişim ve Yeniden Sıralama Mimarisistandard, enterprise, regulated

Yoğun vektör aramasını seyrek BM25 anahtar kelime eşleşmesiyle Karşılıklı Sıra Füzyonu (RRF) ile birleştirme.

Yönerge:Çapraz kodlayıcı yeniden sıralama modellerini (ör. BGE-Reranker) ve ilk K kesme eşiklerini belirtin.
6. Dayanak, Atıf ve Yanıt Vermeme Politikalarıstandard, enterprise, regulated

Zorunlu kanıt atıf kuralları, kaynak referans çıpaları ve bağlam yetersizken kibar ret mekanizması.

Yönerge:Sistem istemi kısıtlarını belirleyin: 'Eğer kanıt bağlamda yer almıyorsa: Bilmiyorum yanıtını ver.'.
7. RAG Üçlüsü Değerlendirmesi ve Sürekli Gözlemlenebilirlikenterprise, regulated

Bağlam Uyumu, Dayanaklılık (Sadakat) ve Yanıt Uyumu otomatik kıyaslama testleri.

Yönerge:Sentetik altın test veri setlerini, CI/CD değerlendirme kapılarını ve OpenTelemetry izleme metriklerini tanımlayın.

Doldurma ve Uygulama Yönergeleri

1. Tercih ettiğiniz DOCX veya Markdown formatındaki boş şablonu kopyalayın. 2. Bölüm 1'i ölçülebilir iş hedefleri ve kabul edilebilir halüsinasyon risk iştahı ile doldurun. 3. Bölüm 2'de tüm kaynak depoları listeleyin, güncelleme sıklıklarını ve erişim sınırlarını sınıflandırın. 4. Bölüm 3'te sorgu niyetine ve doküman hiyerarşisine göre parçalama parametrelerini tasarlayın. 5. Bölüm 4'te bellek ve maliyet ödünleşimlerini gerekçelendirerek gömme modellerini ve indeks parametrelerini seçin. 6. Bölüm 5'te hibrit arama boru hattını (Yoğun Vektör + BM25 + Çapraz Kodlayıcı) yapılandırın. 7. Bölüm 6'da uyum sorumlusuyla birlikte atıf kurallarını ve yanıtsız bırakma eşiklerini resmileştirin. 8. Canlı dağıtım öncesinde Bölüm 7'de RAG Üçlüsü otomatik değerlendirme eşiğini (> 0.90) oluşturun.

Bağımsız İnceleme ve Onay Kontrol Listesi

  • Doküman alımı otomatik dosya temizliğini, OCR doğrulamasını ve üstveri etiketlemesini içeriyor mu?
  • Parçalama sınırları rastgele token kesintisi yapmadan anlamsal başlıkları ve tablo yapılarını koruyor mu?
  • Vektör veritabanı erişimi çok kiracılı satır düzeyinde güvenliği (RLS) ve durağan şifrelemeyi uyguluyor mu?
  • Hibrit arama, özel kısaltmaları ve ürün kodlarını yakalamak için yoğun gömmeleri BM25 ile birleştiriyor mu?
  • Yeniden sıralama modelinin gecikmesi ayrılan sorgu yanıt bütçesine (< 300ms) sığıyor mu?
  • Sistem istemi doğrulanabilir doküman referanslarıyla kanıt atfını tavizsiz zorunlu kılıyor mu?
  • Erişilen bağlam benzerliği güven eşiğinin altına düştüğünde yanıtsız bırakma güvenilir şekilde tetikleniyor mu?
  • RAG Üçlüsü değerlendirme puanı sürümlenmiş bir altın test veri setine karşı sürekli ölçülüyor mu?
İŞLENMİŞ SENARYO ÖRNEĞİ

Çalışılmış Örnek: FinGuard Mevzuat Uyumluluk Zekâsı RAG Motoru

Örnek Organizasyon: FinGuard Uyum Yapay Zekâsı Teknolojileri A.Ş. (Kurgusal Kurum)

Risk yöneticilerinin katı madde düzeyinde yasal atıf ve sıfır halüsinasyon toleransı ile karmaşık gereksinimleri sorgulamasını sağlayan, 2.8 milyon sayfalık Avrupa bankacılık mevzuatını (EBA, ECB, GDPR, DORA) dizinleyen üretim mimarisi.

Öne Çıkan Bulgular ve Çıktılar:
  • Doküman farkındalıklı hiyerarşik parçalama, yasal madde numaralandırmasını ve çapraz referansları korur.
  • Hibrit arama (BGE-M3 yoğun vektörler + BM25), maddeye özel sorgularda %96.4 hatırlama oranına ulaşır.
  • Otomatik çapraz kodlayıcı yeniden sıralama, token bütçesi sınırlarıyla gecikmeyi 1.4sn'den 420ms'ye düşürür.

Sıkça Sorulan Sorular

Neden saf vektör araması yerine hibrit arama (Yoğun + BM25) önerilir?

Yoğun vektör araması kavramsal ve anlamsal benzerlikte mükemmeldir, ancak ürün kodları, hata kodları, kanun madde numaraları ve benzersiz kısaltmalar gibi tam anahtar kelime aramalarında sıklıkla yetersiz kalır. Karşılıklı Sıra Füzyonu (RRF) ile birleştirilen hibrit arama her ikisinin de üstün yönlerini sunar.

RAG Üçlüsü (RAG Triad) değerlendirme çerçevesi nedir?

Yapay zekâ araştırma topluluğu (TruLens) tarafından geliştirilen RAG Üçlüsü şunları ölçer: 1. Bağlam Uyumu (erişilen dokümanlar sorguyla alakalı mı?), 2. Dayanaklılık (LLM yanıtı tamamen erişilen bağlama dayanıyor mu?), ve 3. Yanıt Uyumu (üretilen yanıt kullanıcının gerçek sorusunu cevaplıyor mu?).

Vektör veritabanında kiracılar arası veri sızıntısını nasıl önleriz?

Veri yalıtımı için asla yalnızca vektör uzayı ayrımına güvenmeyin. Vektör mesafesi hesaplanmadan önce veritabanı indeks katmanında her sorguya zorunlu üstveri filtrelemesi (örneğin tenant_id == user.tenant_id) uygulayın.

Teknik Doküman Şablon Paketi

Giriş Gerekli
Ücretsiz ve güvenli indirmeler için tek seferlik giriş veya kayıt gereklidir.
Eksiksiz Teknik Doküman Paketi (.zip)
8 Dosya

Tüm boş şablonları, işlenmiş senaryoları ve doğrulama manifestolarını tek bir arşivde indirin.

Münferit Belgeler (.zip)
TPL-AIR-001-RAG-Architecture-Document-Blank-EN.docxdocx
all17.0 KB
TPL-AIR-001-RAG-Architecture-Document-Blank-EN.pdfpdf
all283.0 KB
TPL-AIR-001-RAG-Architecture-Document-Example-EN.docxdocx
all17.0 KB
TPL-AIR-001-RAG-Architecture-Document-Example-EN.pdfpdf
all285.2 KB
TPL-AIR-001-RAG-Mimarisi-Dokumani-Bos-TR.docxdocx
all17.2 KB
TPL-AIR-001-RAG-Mimarisi-Dokumani-Bos-TR.pdfpdf
all292.7 KB
TPL-AIR-001-RAG-Mimarisi-Dokumani-Ornek-TR.docxdocx
all17.2 KB
TPL-AIR-001-RAG-Mimarisi-Dokumani-Ornek-TR.pdfpdf
all293.7 KB
Doğrulanmış SHA-256 · Makrosuz Güvenli Arşiv
Her indirme dinamik MANIFEST.json içerir

Yetkili Standartlar ve Kaynaklar