Ajanlara Genel Bakış
TotalApp, tek bir monolitik backend yerine, her biri tek bir sorumluluğu üstlenen — veri modelleme, iş akışı yürütme, entegrasyonlar, YZ orkestrasyonu, arayüz render'ı veya gözlemlenebilirlik — bir dizi uzmanlaşmış ajandan inşa edilir; bu sayede her biri bağımsız olarak akıl yürütülebilir, ölçeklenebilir ve geliştirilebilir. Ajanlar iki gruba ayrılır: sunucu tarafında çalışıp ağır işi yapan Temel Ajanlar ve temel katmanın ürettiğini bir dikey sektöre özgü yargı kararlarına dönüştüren Sektöre Özgü Ajanlar.
TotalApp'te Ajan Nedir?
Bir ajan, içerik üzerinde akıl yürüten ve sabit bir hesaplama yerine bir yargı üreten backend birimidir — bir puan, bir sınıflandırma, bir risk değerlendirmesi, yazılı bir analiz. TotalApp'teki bir motor her seferinde aynı şekilde çalışan deterministik bir algoritma yürütürken (bir iş akışı grafiği, bir veritabanı şeması dönüşümü, bir webhook teslimatı), bir ajana bağlam ve bir hedef verilir ve yorumlaması, kanıtları tartması ve akıl yürütmesini açıklaması beklenir.
Ajanlar, TotalApp'in backend'inde motorlarla yan yana durur ve bu iki kategori birbiriyle yarışan değil, birbirini tamamlayan kategorilerdir: motorlar veriyi taşır ve deterministik mantığı yürütür; ajanlar ise yalnızca mantığın tek başına veremeyeceği yargı kararlarını verir.
Tek cümleyle
Motorlar yürütür; ajanlar akıl yürütür. TotalApp ikisini de kullanır ve özellikle sektöre özgü ajanlar için, her seferinde paylaşılan altyapıyı yeniden inşa etmeden yeni ajanlar eklemeye olanak tanıyan modüler bir desende standartlaşıyor.
Temel Ajanlar ve Sektöre Özgü Ajanlar
TotalApp'in ajanları iki geniş kategoriye ayrılır:
Temel Ajanlar
Platformun temel altyapısına sahiptir — veri modelleme, orkestrasyon ve iş akışı mantığı — ve herhangi bir modül veya add-on tarafından kullanılabilir. Matris Ajanı (yapılandırılabilir ağırlıklara ve geçitlere göre kural tabanlı puanlama) ve Denetim Ajanı (belge/marka uyumluluk incelemesi), hangi ekran veya sektör tarafından çağrıldığından bağımsız olarak hattının, girdi sözleşmesinin ve çıktı şeklinin aynı kaldığı anlamında Temel Ajanlardır — yalnızca kurallar ve promptlar ekrana göre değişir.
Sektöre Özgü Ajanlar (Sektörel İcra Ajanları)
Temel katmanın ürettiğini, tek bir dikey add-on'un kendine özgü operasyonel gerçekliğine göre şekillenen bir yargıya dönüştürür — inşaat sahası icrası, lojistik sevkiyat, sağlık hizmeti kabulü ve benzeri sektöre özgü iş akışları gibi — burada akıl yürütme, çağırması gereken araçlar ve etrafındaki onay akışının tamamı o tek sektörün kuralları ve terminolojisi tarafından şekillendirilir. Platformdaki ilk Sektöre Özgü Ajan Patent Ajanı'dır.
Sektörel İcra Ajanları — Hedeflenen Mimari
TotalApp, her dikey add-on'a Sektörel İcra Ajanları'nı (Domain Execution Agents) entegre etmek için modüler, üç katmanlı bir desende standartlaşıyor. Amaç, bir inşaat ruhsatını incelemek, bir lojistik istisnasını triyaj etmek veya bir uyumluluk boşluğunu işaretlemek olsun, her sektöre özgü ajanın platforma aynı şekilde entegre olması — her dikeyin kendi özel entegrasyonunu icat etmesi yerine.
Gidilecek yön, henüz teslim edilmiş bir özellik değil
Aşağıda anlatılan üç katmanlı ayrım, TotalApp'in Sektörel İcra Ajanları'nın tasarlanmakta olduğu mimaridir. Bugün sektörel add-on'lar, ajan mantıklarını bu tam üç dosyalı ayrım üzerinden değil, doğrudan çağırıyor — bu bölüm, yeni ajan çalışmalarının başından itibaren bu desen göz önünde bulundurularak inşa edilebilmesi için desenin gittiği yönü anlatır.
Her dikeyin Sektörel İcra Ajanı'nın üç katmana temiz bir şekilde ayrılması hedeflenir:
| Katman | Amaç |
|---|---|
Uzmanlık Promptuprompt.md | Ajanın alan uzmanlığı, uygulama kodunun içine gömülmek yerine yapılandırılmış bir prompt olarak yazılır — o tek sektöre özgü kelime dağarcığı, değerlendirme kriterleri ve yargı tarzı (ör. bir inşaat ruhsatı için "uyumlu" ne anlama gelir, bir gümrük beyanı için ne anlama gelir). Bunu kendi dosyasında tutmak, bir alan uzmanının bilgisini onu çağıran koddan bağımsız olarak incelenebilir ve sürümlenebilir kılar. |
Sektörel Araç/API Kutusutools.ts | Bir dikeyin ajanının çağırmasına izin verilen belirli araçlar ve dahili API'ler — bir tedarikçi kaydını sorgulamak, bir ruhsat sicilini kontrol etmek, bir uyumluluk kural setini sorgulamak gibi — platformun tüm API yüzeyini her ajana açmak yerine, o sektörün ihtiyacına sıkı şekilde ölçeklenmiştir. |
| Human-in-the-Loop Onay Ekranları Onay ekranları | Bir insanın, ajanın yargısı kesinleşmeden önce onu doğruladığı veya geçersiz kıldığı, incelenebilir ve notlandırılabilir bir ekran — Denetim Ajanı'nın bulgu raporlarında zaten kullanılan aynı "YZ önerir, insan karar verir" desenini yansıtır. Hiçbir Sektörel İcra Ajanı'nın gözetimsiz nihai bir eylem alması hedeflenmez. |
Neden bu şekilde ayrılıyor
Uzmanlığı (prompt.md), yeteneği (tools.ts) ve gözetimi (onay ekranları) birbirinden ayırmak, yeni bir dikeyin, her add-on'un kendi tek seferlik YZ entegrasyonunu göndermesi yerine, diğer her sektör ajanının zaten kullandığı aynı temel ajan çalışma zamanını, iş kuyruğunu ve inceleme-ekranı desenini yeniden kullanarak, yalnızca kendi alan bilgisini ve araç bağlamalarını yazarak devreye alınabilmesi anlamına gelir.