Analitik / Sorgu Ajanı

Sade bir dille sorulan bir soruyu güvenli, kısıtlanmış bir sorguya dönüştüren, gerçek verinize karşı çalıştıran ve ham veritabanı erişimini asla ifşa etmeden yanıtı döndüren backend ajanı.

Analitik / Sorgu Ajanı Nedir?

Analitik / Sorgu Ajanı, TotalApp'in Temel Ajanlarından biridir. Sade bir dille sorulan bir soruyu — "Geçen ay en riskli tedarikçilerimiz kimlerdi?" — güvenli, kısıtlanmış bir SQL veya GraphQL sorgusuna dönüştürür, gerçek verinize karşı çalıştırır ve yanıtı sade bir dille döndürür; hiçbir zaman ham, kısıtlanmamış veritabanı erişimini ifşa etmez.

Şirket verisinden bir yanıt almak genellikle ya SQL bilmeyi ya da bir veri ekibini beklemeyi gerektirir. Analitik / Sorgu Ajanı, doğal dil bir soruyu doğrudan bir sorguya çevirerek bu darboğazı ortadan kaldırır, ancak yalnızca tanımlanmış, politika ile kısıtlanmış bir sorgu yüzeyi içinde — isteği yapan kişinin şeması ve izinleri başka türlü izin vermeyeceği rastgele sorguları asla çalıştırmaz.

Tek cümlede

Sade bir dille bir soru sorun — ajan bunu kısıtlanmış bir sorguya çevirir, çalıştırır ve doğrulanabilmesi için tam sorgu ile ham sonucun yanında sade dilde bir yanıt döndürür.

Nasıl Çalışır — Çevir, Kısıtla, Açıkla

1. Sorgu Çevirisi → 2. Kısıtlanmış Yürütme → 3. Sade Dilde İçgörü

Aşama	Ne olur
1. Sorgu Çevirisi	Doğal dil soru, tanımlanmış güvenli bir sorgu yüzeyine karşı SQL veya GraphQL'e çevrilir. Belirsiz sorular tahmin edilerek yanıtlanmak yerine bir takip sorusuyla netleştirilir.
2. Kısıtlanmış Yürütme	Ajan, şemanızın ve politikalarınızın izin verdiğinin dışında hiçbir zaman rastgele sorgu üretmez — RBAC ve tenant kapsamlaması, TotalApp'teki diğer herhangi bir veri erişiminde olduğu gibi aynen uygulanır.
3. Sade Dilde İçgörü	Sorgu sonuçları yalnızca ham satırlar olarak değil, sade bir dille özetlenir. Hem temel sorgu hem de ham sonuç özetin yanında gösterilir, böylece yanıt körü körüne güvenilmez, doğrulanabilir olur.

Tasarım gereği doğrulanabilir

Üretilen sorgu ve ham sonucu hiçbir zaman özetin arkasına gizlenmez — her ikisini de göstermek, herkesin veritabanına gerçekte neyin sorulduğunu ve neyin döndüğünü, bir parafraza güvenmek yerine kontrol edebilmesi için bilinçli bir tercihtir.

Temel Yetenekler

Doğal Dilde Girdi

Bir soruyu bir meslektaşınıza sorar gibi sorun — verinizden gerçek bir yanıt almak için SQL bilgisi gerekmez.

Kısıtlanmış Sorgu Yüzeyi

Asla rastgele veritabanı erişimi değil — yalnızca şemanızın ve politikalarınızın açıkça izin verdiği, her seferinde aynı şekilde uygulanır.

Sade Dilde Yanıtlar

Sonuçlar yalnızca ham bir tablo dökümü olarak değil, kelimelerle özetlenir — "verim var" ile "yanıtım var" arasındaki boşluğu kapatır.

Her Seferinde Doğrulanabilir

Temel sorgu ve ham sonuç her zaman özetin yanında gösterilir — hiçbir şey bir kara kutu değildir.

2 Katmanlı Mimari ile İlişkisi

Analitik / Sorgu Ajanı, TotalApp'in 2 Katmanlı Mimarisi'nin tam eşleşme erişim yarısıdır — bilinen şemalara karşı deterministik, yapılandırılmış sorgular — ve RAG / Bilgi Ajanı'nın yapılandırılmamış belgeler üzerindeki bulanık, anlam tabanlı erişimini tamamlar. Birlikte, hem "veri tam olarak ne diyor" hem de "belgelerimiz bu konuda ne diyor" sorularını kapsarlar.

Sıkça Sorulan Sorular

Bu ajan teorik olarak sorduğum herhangi bir sorguyu çalıştırabilir mi?

Hayır — yalnızca tanımlanmış, politika ile kısıtlanmış bir sorgu yüzeyi içinde sorgular üretir. Soru nasıl ifade edilirse edilsin, ham, kısıtlanmamış veritabanı erişimini asla ifşa etmeyecek şekilde açıkça inşa edilmiştir.

Sorum belirsizse ne olur?

Ajan, amacı tahmin edip kendinden emin bir şekilde ifade edilmiş potansiyel olarak yanlış bir yanıt döndürmek yerine netleştirici bir takip sorusu sorar.

Sade dille bir soru sorduğumda RBAC hâlâ geçerli mi?

Evet — RBAC ve tenant kapsamlaması, TotalApp'teki diğer herhangi bir veri erişim yolunda olduğu gibi aynen uygulanır. Doğal dilde sormak hiçbir yetki kontrolünü atlamaz.

Sorularım ve sonuçları kaydediliyor mu?

Evet — her sorgu, neyin sorulduğunun ve neyin döndürüldüğünün incelenmesi için kaydedilir; bu, ajanın nasıl kullanıldığına dair sonraki denetimi destekler.