Application Foundation · HRAG
Tek sorgu, doğru arama yöntemi.
Vector, BM25, hibrit ve GraphRAG yöntemlerini tek bir API altında toplayan çok-kiracılı bir RAG servisidir. Hangi yöntemin kullanılacağına bir routing katmanı, sorgunun kendisine bakarak karar verir.
- Durum
- Prototip
- Doğrulanan sürüm
- 2026-07-18
- Erişim
- TODO_CONTENT_CONFIRMATION
Çözdüğü problem
Tek bir arama yöntemi (yalnızca vector gibi) her sorgu tipine uymaz: tam terim araması, ilişki sorguları ve genel özetleme farklı retrieval stratejileri gerektirir.
HRAG, sorgu tipine göre uygun stratejiyi seçen bir routing katmanı sunarak bu kararı uygulama tarafında tekrar tekrar almaya gerek bırakmamayı hedefler.
Nasıl çalışır
Belgelerinizi workspace koleksiyonunuza gönderin — senkron veya asenkron.
Sorgu geldiğinde routing katmanı sorgu metnine bakar.
Uygun şerit — vector, BM25, hibrit veya graf — çalıştırılır.
Cevap, hangi yöntemin kullanıldığı bilgisiyle birlikte döner.
Doğrulanmış yetenekler
Sorgu tipine göre yönlendirme
Tam terim arayan sorgular BM25'e, ilişki soruları entity-merkezli grafa, genel özet istekleri topluluk-merkezli grafa yönlendirilir.
Yerleşik ölçüm katmanı
Hit-rate, MRR ve nDCG gibi LLM'siz metrikler CI'da regresyon kapısı olarak koşacak şekilde tasarlanmıştır; gecelik bir RAGAS LLM-jüri koşusu da kalite trendini ayrıca izler.
Kiracı bazlı izolasyon
Her kiracı kendi workspace'inde çalışır: Postgres'te satır seviyesi güvenlik, Neo4j'de tekil erişim geçidi, Redis ve MinIO'da ayrık ön ekler ile ayrıştırma hedeflenir.
Çift katmanlı tekrar koruması
Idempotency-Key ile iş seviyesinde, içerik hash'iyle belge seviyesinde olmak üzere iki bağımsız tekrar-önleme katmanı bulunur.
Mimari ve entegrasyon
HRAG; Vector + Graph (Neo4j) + BM25 hibrit retrieval, routing ve reranking katmanlarını tek bir çok-kiracılı (multi-tenant) M2M API arkasında sunar.
Asenkron ingest, mesaj kuyruğu üzerinden en-az-bir-kez teslim ilkesiyle çalışır; ekosistemdeki kardeş projeler HRAG'a tek bir API anahtarıyla bağlanır.
Güven ve kontrol modeli
Kiracı izolasyonu; satır seviyesi güvenlik, tekil erişim geçidi ve ayrık önek stratejileriyle tasarlanmıştır — başka bir kiracının verisine erişim denemesinin kaynağın varlığını dahi açık etmeyecek şekilde ele alınması hedeflenir.
Otomatik ölçüm (hit-rate/MRR/nDCG regresyon kapısı ve RAGAS koşuları) geliştirme sürecinin bir parçasıdır; test setinin tamamının gerçek altyapıya karşı güncel durumu bu sayfada sabit bir rakamla iddia edilmiyor, kapsam genişlemeye devam ediyor.
Bilinen sınırlar / geliştirme alanları
Erişim modeli netleşmedi
Erişim biçimi henüz proje sahibi tarafından teyit edilmedi.
Güncel test raporu yayımlanmadı
Test sayısı ve kapsamı zaman içinde değiştiği için sabit bir rakam bu sayfada verilmiyor; güncel ve bağımsız doğrulanmış bir rapor henüz yayımlanmadı.
Prototip olgunluk seviyesi
Servis prototip aşamasındadır; çok-kiracılı ölçek testleri sürmektedir.
Kanıtlar
CI regresyon kapısı ve gecelik RAGAS koşuları iç geliştirme sürecinin parçasıdır; kamuya açık, güncel bir test raporu veya kanıt bağlantısı henüz yayımlanmadı. Yayımlandığında bu bölüm güncellenecektir.