TotalApp Docs

Matrix Agent

Yapılandırılmamış metni objektif, ağırlıklı bir 0–100 puana dönüştüren backend ajanı. TotalApp'teki "bunu kurallarıma göre değerlendir" mantığına ihtiyaç duyan her ekranı besler.

Matrix Agent Nedir?

Matrix Agent, TotalApp'in Temel Ajanlarından biridir. Tek sorumluluğu, yapılandırılmamış veya yarı yapılandırılmış metni — bir tedarikçinin şirket profili, bir satış lead'inin notları, bir uyumluluk politika belgesi, bir CV — 0 ile 100 arasında objektif, tekrarlanabilir bir puana ve bu puanın nedenini açıklayan yazılı bir özete dönüştürmektir.

Amacı, tekrarlayan değerlendirme işlerinden insan önyargısını ve tutarsızlığını ortadan kaldırmaktır. Aynı tedarikçiyi iki farklı değerlendiricinin farklı günlerde farklı puanlaması yerine, her öğe aynı deterministik kural setinden ve aynı yapay zeka değerlendirme prompt'undan geçirilir; böylece sonuç tekrarlanabilir ve denetlenebilir olur.

Tek cümlede

Matrix Agent'e bir metin parçası ve bir kural seti (olmazsa olmazlar, ağırlıklı kategoriler, bir geçme/kalma eşiği) verin — geriye bir geçme/kalma kapı sonucu, ağırlıklı bir puan ve gerekçeleriyle birlikte kategori bazlı bir döküm döner.

Nasıl Çalışır — Linter/Critic Hattı

Her Matrix Agent analizi, hangi ekranın tetiklediğinden bağımsız olarak aynı üç aşamalı hattı çalıştırır:

1. Linter (Kapı Kontrolü) 2. Critic (Kategori Puanlama) 3. Ağırlıklı Hesaplama
AşamaNe olur
1. Linter — Kapı BekçisiOlmazsa Olmaz listesindeki her madde içerikle karşılaştırılarak kontrol edilir. Gerekli maddelerden bir tanesi bile eksikse, passed_gate false olarak ayarlanır ve nihai puan zorla 0'a çekilir — kalan iki aşama hiç çalışmaz. Bu, gerçek bir işe alım/tedarikçi/uyumluluk kapısını modeller: eksik bir zorunlu gereksinimi hiçbir ek güçlü yön telafi edemez.
2. Critic — Kategori PuanlamaYalnızca kapı geçildiyse çalışır. Yapılandırılan her puanlama kategorisi (ör. "Fiyat Avantajı", "Teslimat Hızı") metinde bulunan kanıtlara dayanarak bağımsız olarak 0–100 arasında puanlanır. Bir kategori için kanıt yoksa her zaman o kategori için puan 0'dır — ajan asla varsaymamaya veya çıkarım yapmamaya yönlendirilir.
3. Ağırlıklı HesaplamaHer kategorinin ham puanı, kendi yapılandırılmış ağırlığıyla (ağırlıklar ekran bazında ayarlanır ve toplamda %100 eder) çarpılır, ardından 0 ile 100 arasında tek bir total_score'da toplanır.

Neden "Linter/Critic"?

Bu isimlendirme, bir kod linter'ı ile bir kod incelemecisinin sorumlulukları nasıl paylaştığını yansıtır: Linter aşaması, zorunlu gereksinimler üzerinde katı, ikili bir geçme/kalma kontrolüdür (derlenmeyen kodu reddeden bir linter gibi); Critic aşaması ise kapıyı geçen her şey üzerinde niteliksel, ağırlıklı yargı çağrıları yapar (kod stilini ve tasarımı puanlayan bir incelemeci gibi). İkisini ayırmak, güçlü bir "Olsa İyi Olur"un eksik bir "Olmazsa Olmaz"ı maskelemesini önler.

Girdi — Her Ekranın Yapılandırdığı Şey

Alan fark etmeksizin (tedarikçiler, lead'ler, uyumluluk öğeleri veya CV'ler), her Matrix Agent çağrısı aynı dört bilgi parçasıyla yapılandırılır:

Ham İçerik

Değerlendirilecek serbest metin — bir tedarikçi profili, bir lead'in notları, bir politika belgesi, bir CV. Ajanın "kanıt" olarak okuduğu tek alan budur.

Olmazsa Olmaz Kurallar

Zorunlu gereksinimlerin listesi. Bir tanesinin bile eksik olması, geri kalan her şey ne kadar iyi puanlanırsa puanlansın toplam puanı 0'a zorlar.

Puanlama Ağırlıkları

Her biri yüzde ağırlığa sahip, toplamda %100 eden adlandırılmış bir kategori seti. Her ekran kendi kategorilerini tanımlar — ör. Tedarikçi Matrisi "Fiyat Avantajı / Teslimat Hızı / Kalite Belgeleri" kullanır, Satış İstihbaratı "Bütçe Uyumu / Teknoloji Altyapısı / Karar Verici Erişimi" kullanır.

Geçme Eşiği

O ekran için geçer sayılan minimum toplam puan (ör. tedarikçiler için 70, lead'ler için 65, uyumluluk için 75). Yalnızca arayüzün renk kodlaması için kullanılır — geçti/sınırda/kaldı — ajanın kendi kapı mantığı tarafından kullanılmaz.

Çıktı — Geriye Ne Döner

Her analiz aynı sonuç şeklini döner, böylece her ekran onu aynı arayüz bileşenleriyle çizebilir:

AlanAnlamı
passed_gateBoolean — öğe her Olmazsa Olmaz kuralını sağladı mı?
total_score0–100 ağırlıklı puan. passed_gate false ise 0'a zorlanır.
summaryGenel sonucu açıklayan kısa bir yönetici özeti.
missing_must_havesHangi belirli Olmazsa Olmaz maddelerin karşılanmadığı (kapı geçildiyse boş).
breakdownHer puanlama kategorisi için bir girdi: ham puanı, ağırlıklı katkısı ve puanı açıklayan kısa bir gerekçe notu.

Bilinçli olarak katı, cömert değil

Ajan, asla kanıt uydurmaması veya şüpheden yararlanma payı tanımaması için açıkça yönlendirilir. Bir gereksinim içerikte açıkça belirtilmemişse, yok olarak puanlanır. Bu bilinçli bir tasarım tercihidir — Matrix Agent boşlukları örtmek değil, yakalamak için tasarlanmıştır.

Matrix Agent Nerede Kullanılıyor?

Matrix Agent alan bağımsızdır — aynı hat ve aynı paylaşılan workstation arayüzü (MatrixWorkstation) aşağıdaki her ekranı besler. Yalnızca kurallar (ağırlıklar, olmazsa olmazlar, eşik) ve veri şekli ekran bazında farklılık gösterir.

EkranModülNe puanlanıyorÖrnek puanlama ağırlıkları
Tedarikçi Matrisi (Satın Alma) vendor Tedarikçi profilleri ve notları Fiyat Avantajı %40, Teslimat Hızı %30, Kalite Belgeleri %30
Satış İstihbaratı (Satış) lead Satış lead notları ve şirket bilgisi Bütçe/Ciro Uyumu %40, Teknolojik Altyapı %30, Karar Verici Teması %30
Uyumluluk Radar (Güvenlik) compliance Politika ve kontrol dokümantasyonu Veri Güvenliği %50, Erişim Kontrolleri %30, Loglama Altyapısı %20
CV Tarama (İK) screening Aday özgeçmiş metni Beceri Uyumu, Deneyim Seviyesi, Eğitim (kendine ait özel mantık)

Tedarikçi Matrisi (Satın Alma)

Yapılandırılabilir satın alma kurallarına göre tedarikçi profillerini ve notlarını puanlar. Varsayılan ağırlıklar: Fiyat Avantajı %40, Teslimat Hızı %30, Kalite Belgeleri %30. Varsayılan Olmazsa Olmazlar: ISO belgesi, referans listesi. Bkz. Satın Alma.

Satış İstihbaratı (Satış)

Lead'leri nitelendirmek veya elemek için satış lead notlarını ve şirket bilgilerini puanlar. Varsayılan ağırlıklar: Bütçe/Ciro Uyumu %40, Teknolojik Altyapı %30, Karar Verici Teması %30. Varsayılan Olmazsa Olmaz: karar verici iletişim bilgisi. Bkz. Satış İstihbaratı.

Uyumluluk Radar (Güvenlik)

Politika ve kontrol dokümantasyonunu düzenleyici/güvenlik gereksinimlerine göre puanlar. Varsayılan ağırlıklar: Veri Güvenliği %50, Erişim Kontrolleri %30, Loglama Altyapısı %20. Varsayılan Olmazsa Olmazlar: şifreleme politikası, erişim kontrol belgesi. Bkz. Uyumluluk Radar.

CV Tarama (İK)

Aday havuzundaki CV leri analiz ederek inceleyip olmazsa Olmaz gereksinimlere (bir kapı) göre kontrol edilir, ardından ağırlıklı kategoriler üzerinden puanlanır (beceri uyumu, deneyim seviyesi, eğitim), aynı türden bir geçme/kalma-artı-puan sonucu üretir. Bkz. CV Tarama.

Matrix Puanları Başka Nerede Görünür?

Kendi ekranlarının ötesinde, Matrix Agent sonuçları (tedarikçi puanları, lead puanları, uyumluluk puanları) diğer CRM/satış metrikleriyle birlikte Analitik gösterge panellerinde özet widget'lar olarak da görünür — hangi tedarikçilerin, lead'lerin ve uyumluluk öğelerinin geçme eşiklerinin üzerinde veya altında seyrettiğini tek bakışta gösterir.

Sıkça Sorulan Sorular

Matrix Agent'e yeni bir alan (yeni bir modül tipi) ekleyebilir miyim?
Evet. Ajanın kendisi alan bağımsızdır — yeni bir ekran eklemek, kendi varsayılan ağırlıklarına, olmazsa olmazlarına ve eşiğine sahip yeni bir modül tipi tanımlamak, ardından aynı paylaşılan workstation arayüzünü ve analiz uç noktasını yeniden kullanmak anlamına gelir. Puanlama hattının kendisinde herhangi bir değişiklik gerekmez.
Neden eksik bir Olmazsa Olmaz tüm puanı sıfırlıyor?
Bu, gerçek dünyada kapı bekçiliğinin nasıl işlediğini modeller — gerekli bir ISO belgesi eksik olan bir tedarikçi veya hiç şifreleme politikası olmayan bir uyumluluk kontrolü, başka her yerde ne kadar iyi puanlanırsa puanlansın diskalifiye edicidir. Bunu ağırlıklı bir şekilde ortalamaya katmak, güçlü "olsa iyi olur" puanlarının sert bir başarısızlığı maskelemesine izin verir.
Matrix Agent yapay zeka sağlayıcısını doğrudan mı çağırıyor, yoksa başka bir ajan üzerinden mi geçiyor?
Matrix Agent bu analiz için kendi katı değerlendirme prompt'unu oluşturur ve yapılandırılmış yapay zeka sağlayıcısını (tenant'ın Writer Engine ayarına bağlı olarak Cohere veya Anthropic'in API/CLI'si) doğrudan çağırır — şu anda Agentic Routing Engine üzerinden yönlendirme yapmıyor. Bu, gelecekteki bir konsolidasyon için adaydır.
Puanlama gerekçesi son kullanıcıya gösteriliyor mu?
Evet. Dökümdeki her kategori, o puanın neden verildiğini açıklayan kısa bir gerekçe metni içerir ve genel özet de döndürülür — her ikisi de doğrudan workstation arayüzünde puanın yanında çizilir.
Matrix Agent verisi tenant bazlı mı?
Evet. Tedarikçiler, lead'ler ve uyumluluk öğeleri her biri kendi tenant bazlı JSON deposunda (standart sunucu tabanlı kalıcılık deseni üzerinden) saklanır, böylece bir tenant'ın değerlendirme verisi başka bir tenant'a asla görünmez.