Audit Agent
Bir PPTX veya PDF belgesini ayrıştıran, deterministik marka uyumluluğu kurallarını ve kendi kılavuzlarınıza göre bir yapay zeka incelemesi çalıştıran ve incelenebilir, notlandırılabilir bir bulgu raporu üreten backend ajanı. Bugün PPTX Denetçisi ve PDF Denetleyici'yi besliyor; paylaşılan hatta hiç dokunmadan yeni belge/medya formatlarını denetçi olarak eklemek üzere tasarlandı.
Audit Agent Nedir?
Audit Agent, TotalApp'in Temel Ajanlarından biridir. Tek sorumluluğu, yüklenen bir dosyayı — bir belge, tablo, görsel veya tasarım varlığını — bir dizi marka/uyumluluk kılavuzuna göre kontrol etmektir; bunu iki tamamlayıcı inceleme geçişini birleştirerek yapar: hızlı bir deterministik kural geçişi ve daha yavaş bir yapay zeka anlamsal inceleme geçişi.
PPTX Denetçisi ve PDF Denetleyici, bugün canlı olan iki denetçidir ve her ikisi de tam olarak aynı ajan üzerine inşa edilmiş ince ekranlardır — ayrıştırma/kural/inceleme hattı, iş kuyruğu ve tenant bazlı rapor depolama hepsi paylaşılır. Yalnızca dosya ayrıştırıcı format bazında farklılık gösterir (PPTX kendi XML'ini bir ZIP okuyucusu üzerinden okur; PDF metin çıkarımı kullanır), çünkü her format "bir dosyayı" ajanın geri kalanının anladığı aynı normalize edilmiş iç şekle dönüştürmek için farklı koda ihtiyaç duyar. Bu yalnızca-ayrıştırıcı sınırı bilinçlidir — aynı deseni izlemesi planlanan denetçiler için aşağıdaki Format Yol Haritası'na bakın.
Tek cümlede
Bir dosya ve marka kılavuzlarınızı yükleyin — Audit Agent, bir insanın kabul edip reddedebileceği ve notlandırabileceği, sayfa/slayt/öğe bazında bir bulgu listesi (taslak işaretleri, eksik gizlilik beyanları, ton/terminoloji sorunları, stil ihlalleri) döndürür, rapor kaydedilmeden önce.
Nasıl Çalışır — Ayrıştırma, Deterministik Kurallar, Yapay Zeka İncelemesi
Her Audit Agent analizi, hangi format tetiklediğinden bağımsız olarak aynı üç aşamalı hattı çalıştırır:
| Aşama | Ne olur |
|---|---|
| 1. Ayrıştırma | Yüklenen dosya ortak bir iç şekle normalize edilir — her biri bir başlığa ve bir veya daha fazla metin öğesine sahip slayt/sayfa listesi. PPTX ayrıştırması sunumun kendi XML'ini okur (şekil adları, yer tutucu tipleri, font boyutları, renkler ve konum, hepsi dosyanın ZIP yapısından çıkarılır). PDF ayrıştırması her sayfanın metnini bir metin çıkarım kütüphanesi üzerinden çıkarır — PDF'ler bir PPTX dosyasının sağladığı aynı run-bazlı stil meta verisini sunmaz, bu yüzden PDF bulguları yalnızca metin bazlıdır (aşağıdaki sınırlama notuna bakın). |
| 2. Deterministik Kurallar | Her slayt veya sayfada, hiç yapay zeka çağrısı olmadan, sabit bir regex/sezgisel kontrol seti anında çalışır. Kontroller şunları içerir: "DRAFT" işareti, yasaklı kısaltmalar, standart dışı fontlar/renkler (yalnızca PPTX), başlık noktalama/büyük harf/uzunluk, eksik gizlilik beyanı, madde işareti noktalama ve boş slaytlar/sayfalar. Tam kural tablosuna aşağıda bakın. |
| 3. Yapay Zeka Anlamsal İnceleme | Ayrıştırılan içerik artı kılavuzlarınız (yapıştırılmış veya bir `.md` dosyası olarak yüklenmiş), tenant'ın Writer Engine ayarına bağlı olarak yapılandırılmış yapay zeka sağlayıcısına (Anthropic API veya Claude CLI) yalnızca yapılandırılmış JSON ihlalleri döndürmesi için katı bir talimatla gönderilir — regex kurallarının yakalayamadığı ton, terminoloji ve kılavuza özgü sorunlar. |
Neden her iki geçiş de çalıştırılıyor?
Deterministik kurallar anlık, ücretsiz ve kapsadıkları mekanik kontroller için %100 güvenilirdir (yapay zeka halüsinasyon riski yok), ancak ton, terminoloji veya kılavuza özgü nüansı değerlendiremezler. Yapay zeka geçişi bu boşluğu doldurur. Her ikisini de çalıştırmak, hızlı ve ucuz kontrollerin asla bir ağ round-trip'i beklememesi anlamına gelirken, niteliksel kontroller de yine de yapılır.
Tek Ajan, Çok Sayıda Denetçi
PPTX Denetçisi ve PDF Denetleyici, birbirine benzeyen iki ayrı uygulama değildir — tek bir paylaşılan sunucu modülü üzerinde iki ince ön yüzdür, ve ajan bilinçli olarak, yepyeni bir denetçinin (yeni bir format, yeni bir varlık kategorisi) hattı çatallamak yerine aynı hatta eklenebileceği şekilde yapılandırılmıştır. Yükleme/iş kuyruğu-durumu/kalıcılık altyapısı, deterministik-kural çalıştırıcısı ve yapay zeka inceleme çağrısı bir kez yazılır ve her denetçi tarafından yeniden kullanılır; yalnızca dosya ayrıştırıcı ve kural seti format bazında değişir.
| Bileşen | Denetçiler arasında paylaşılıyor mu? | Notlar |
|---|---|---|
| Dosya ayrıştırıcı | Hayır — format bazında | Her format kendi ayrıştırıcısını alır (PPTX kendi XML'ini okur; PDF metin çıkarımı kullanır), her ikisi de aynı normalize edilmiş iç şekli üretir — içerik ve mevcutsa stil meta verisi bulunan sayfa/slayt/öğe listesi. Yeni bir denetçi eklemek, yeni bir hat değil, yeni bir ayrıştırıcı yazmak demektir. |
| Deterministik kural seti | Kısmen — format bilinçli | Metin bazlı kurallar (yasaklı kelimeler, eksik beyanlar, noktalama, büyük harf) her format genelinde aynı şekilde çalışır. Bir formatın sunmadığı meta veriye bağlı kurallar (PDF için font/renk, görseller için hücre formülleri, vb.) o formata basitçe uygulanmaz — beklenen bir sınırlama, bir hata değil; bugün PPTX ile PDF arasında zaten uygulanan aynı desen. |
| Yapay zeka inceleme çağrısı | Evet | Her denetçi için aynı prompt oluşturma mantığı, aynı sağlayıcı yönlendirmesi, aynı yanıt ayrıştırması — yalnızca prompta aktarılan kılavuzlar ve ayrıştırılan içerik değişir. |
| Yükleme / iş-durumu / kalıcılık işleyicileri | Evet | Küçük bir format bazında yapılandırma nesnesiyle (dosya uzantısı, depolama dosya adı) parametrelendirilmiş tek bir genel işleyici seti — asla denetçi bazında çoğaltılmaz. |
| İnceleme arayüzü (3 panelli workstation) | Desen paylaşılır, kod çoğaltılır | Her denetçi ekranı, Kabul Et/Reddet ve bulgu bazında notlarla aynı 3 panelli düzeni (öğe listesi, içerik görünümü, bulgu paneli) kullanır — paylaşılan tek bir bileşen yerine paralel ekranlar olarak inşa edilir, böylece her biri kendi format bazında terminolojisini geliştirebilir (ör. "slayt" ile "sayfa" ile "hücre"). |
"Yeni bir denetçi eklemek" gerçekte ne anlama gelir
İş kuyruğu, yapay zeka çağrısı ve kalıcılık katmanı zaten genel olduğundan, yeni bir denetçi göndermek şunlara indirgenir: (1) formatı paylaşılan iç şekle normalize eden yeni bir dosya ayrıştırıcı, (2) o format için mantıklı olan format bazında deterministik kurallar, ve (3) mevcut 3 panelli deseni izleyen yeni bir inceleme ekranı. Paylaşılan ajanda hiçbir şeyin değişmesi gerekmez.
Format Yol Haritası
PPTX Denetçisi ve PDF Denetleyici bugün canlı. Aynı ajan, her biri yukarıdaki paylaşılan hattı yeniden kullanıp yalnızca kendi ayrıştırıcısını ve kural setini ekleyecek şekilde, aşağıdaki denetçilere genişleyecek şekilde tasarlandı:
| Denetçi | Girdi Formatı | Ne İnceler? | Durum |
|---|---|---|---|
| PPTX Denetçisi | .pptx |
Marka fontları/renkleri, başlık biçimlendirmesi, gizlilik beyanları, terminoloji, ton. | Canlı |
| PDF Denetleyici | .pdf |
Terminoloji, gizlilik beyanları, başlık biçimlendirmesi, ton (yalnızca metin bazlı kurallar). | Canlı |
| DOCX / Word Denetçisi | .docx |
Kurumsal kurallar, font stilleri, yasaklı kelimeler, hiyerarşik başlıklar, tablo ve yapı uyumluluğu. | Planlandı |
| XLSX / Tablo Denetçisi | .xlsx, .csv |
Finansal raporlama kuralları, kırık formüller, boş bırakılmaması gereken hücreler, marka renklerine uygun tablo tasarımı. | Planlandı |
| Marka & Görsel Denetçisi | .png, .jpg |
Kurumsal logonun doğru kullanımı, kontrast oranları, görselin text-to-image (yapay zeka) olup olmadığı, watermark kontrolü. | Planlandı |
| Sosyal Medya / Reklam Banner Denetçisi | Figma linki, .psd, .png |
Reklam görselindeki metin yoğunluğu (örn. eski %20 kuralı gibi), call-to-action (CTA) butonunun varlığı. | Planlandı |
| Erişilebilirlik (a11y) Denetçisi | .pdf, .html |
Görme engelliler için ekran okuyucu uyumluluğu, alt-text eksikleri, hiyerarşik başlık (H1, H2) düzeni. |
Planlandı |
| Hukuki & Uyumluluk Denetçisi | Tüm metinler | Gizlilik sözleşmesi (NDA) uyumluluğu, yasaklı kelimeler, güncel regülasyon maddelerinin varlığı. | Planlandı |
Yol haritası, taahhüt edilmiş bir tarih değil
"Planlandı" olarak işaretlenen denetçiler, Audit Agent'in format kapsamının yöneldiği yönü tanımlar, planlanmış bir sürüm değil. Her biri, öncelik verildiğinde basit bir ekleme haline gelir — çünkü paylaşılan hat (iş kuyruğu, yapay zeka incelemesi, kalıcılık, inceleme arayüzü deseni) zaten mevcuttur ve format başına yeniden inşa edilmesi gerekmez.
Deterministik Kural Seti (PPTX & PDF)
Bu kontroller, bugün canlı olan iki denetçi için her slaytta veya sayfada, hiç yapay zeka çağrısı olmadan anında çalışır. Gelecekteki denetçiler (yukarıdaki yol haritasına bakın) her biri kendi formatına uygun kendi kural setini tanımlayacak — bir tablo denetçisinin formül/boş hücre kontrollerine, bir görsel denetçisinin kontrast/logo kontrollerine ihtiyacı vardır vb. — aynı kural çalıştırma mekanizmasını yeniden kullanarak, bu belirli kural listesini değil.
| Kural | Önem | Ne yakalar | PDF ile uyumlu mu? |
|---|---|---|---|
| Taslak işareti | Yüksek | İçerikte herhangi bir yerde "DRAFT" kelimesi. | Evet |
| Yasaklı kısaltma | Yüksek | Tam olarak yazılması gereken izin verilmeyen kısaltma. | Evet |
| Standart dışı font | Orta | Onaylı marka listesi dışında bir font. | Hayır — PDF metin çıkarımının run bazlı font meta verisi yok |
| Renk paleti | Orta | Onaylı marka paleti dışında bir renk hex değeri. | Hayır — fontlarla aynı sınırlama |
| Başlık font boyutu | Orta | Gerekli punto boyutuna ayarlanmamış başlık metni. | Hayır |
| Başlık konumu | Orta | Yanlış düzenin kullanıldığını gösteren, beklenen konumundan yer değiştirmiş başlık kutusu. | Hayır — PDF'de şekil-konum verisi yok |
| Başlık noktalaması | Orta | Nokta, ünlem veya soru işaretiyle biten başlık. | Evet |
| Başlık BÜYÜK HARF | Orta | Tamamen büyük harfle yazılmış başlık. | Evet |
| Başlık çok uzun | Düşük | Beklenen satır sayısını aşması muhtemel başlık uzunluğu. | Evet |
| Eksik gizlilik beyanı | Düşük | Slaytta/sayfada hiçbir yerde gizlilik/mülkiyet beyanı bulunamadı. | Evet |
| Madde işareti noktalaması | Düşük | Sonlandırıcı noktalamayla biten bir gövde madde işareti satırı. | Evet |
| "Percentile" yerine "%ile" | Düşük | Kurumsal stilin "%ile" kısaltmasını gerektirdiği yerde "Percentile" kelimesinin kullanılması. | Evet |
| Boş slayt/sayfa | Orta | Slaytta/sayfada hiç çıkarılabilir metin içeriği yok. | Evet |
PDF girdisinin PPTX'ten daha az uygulanabilir kuralı var
PDF metin çıkarımı, bir PPTX dosyasının kendi XML yapısının sağladığı run bazlı stil meta verisini (font adı, font boyutu, renk, şekil konumu) sunmaz. Sonuç olarak, yukarıdaki dört stil/konum kuralı PDF girdisinde hiç tetiklenmez — bu formatın beklenen bir sınırlamasıdır, bir hata değil. Diğer dokuz metin bazlı kural her iki formatta da aynı şekilde uygulanır.
İnsan İncelemesi — Kabul Et, Reddet, Notla
Hiçbir bulgu otomatik olarak uygulanmaz. Her deterministik ve yapay zeka kaynaklı bulgu, incelemeciye 3 panelli bir workstation'da (solda öğe listesi, ortada belge içeriği, sağda bulgu paneli) sunulur; her biri şu şekilde işaretlenebilir:
Kabul Edildi
Kaynak belgede düzeltilmesi gereken doğrulanmış, gerçek bir sorun olarak işaretlenir.
Reddedildi
Yanlış pozitif veya kasıtlı bir istisna olarak işaretlenir ve nihai raporun aktif bulgularından çıkarılır.
Notlandırıldı
Herhangi bir bulguya serbest metin bir not eklenebilir — neden kabul/reddedildiğine dair bağlam veya kaynak belgeyi düzeltecek kişiye talimatlar. Notlar, her export'a (JSON, PDF raporu, kaydedilmiş sunucu raporu) bulguyla birlikte taşınır.
İnceleme tamamlandıktan sonra, bulgular (Kabul Et/Reddet durumları ve notlarıyla birlikte) bir JSON dosyası olarak indirilebilir, biçimlendirilmiş bir PDF raporu olarak export edilebilir (yalnızca kabul edilen sorunların özeti veya bekleyen öğeler dahil tam rapor) veya sonra başvurmak üzere tenant bazlı sunucu depolamasına kaydedilebilir.
Audit Agent Bugün Nerede Kullanılıyor
| Ekran | Girdi formatı | Kategori |
|---|---|---|
| PPTX Denetçisi | PowerPoint (.pptx) |
Denetim |
| PDF Denetleyici | PDF (.pdf) |
Denetim |
Bu tabloya katılması planlanan denetçiler için yukarıdaki Format Yol Haritası'na bakın.
PPTX Denetçisi
Bir PowerPoint sunumu ve marka kılavuzlarınızı yükleyin, her slaytta fontları, renkleri, başlık biçimlendirmesini, gizlilik beyanlarını ve terminolojiyi kontrol edin. Bkz. PPTX Denetçisi.
PDF Denetleyici
Bir PDF belgesi ve marka kılavuzlarınızı yükleyin, her sayfada aynı terminoloji, başlık ve gizlilik kurallarını kontrol edin — font veya düzen meta verisi gerektiren stil/konum kuralları bu formata uygulanmaz. Bkz. PDF Denetleyici.
Sıkça Sorulan Sorular
.md) dosyası yüklemenize izin verir — bu, belge içeriğinin yanında yapay zeka inceleme geçişine aktarılır ve birden fazla adlandırılmış kılavuz setini yan yana tutabilirsiniz.