11.5 Your document types

Policy → AI Classification → Your document types, öğretme döngüsünün tamamını barındıran tek bir karttır:

(Tür ekleyin → en az 5 örnek belge yükleyin → eğitin → türü seçip kural oluşturun. Yanlış eşleşmeleri karşı örnek olarak yükleyip yeniden eğitin.)

Kartın üstündeki bilgi şeritleri:

Bilgi şeridi Anlamı
The AI service (ada-ml) is not responding — uploads, training and test documents are unavailable. Hizmet geri gelene kadar yükleme ve eğitim devre dışıdır.
No AI model is installed on this server, so nothing can be trained. Sunucuda model paketi yoktur.
The AI model was upgraded since the last training — train again so agents receive your types. Bir ürün yükseltmesi yeni bir model getirmiştir. Eğitilmiş katmanınız eski modele aittir ve yeniden eğitene kadar ajanlara gönderilmez (bölüm 11.9.4).

11.5.1 Belge türleri tablosu

Sütun İçerik
(onay kutusu) Türü + Create rule from selected için seçer. Yalnızca eğitilmiş türlerde etkindir.
Document type Tür adı.
Suggested label Politika etiketlerinin açılır listesi (etiketin alt hassasiyetleri varsa alt etiketler için ikinci bir açılır liste). Değişiklikler hemen kaydedilir.
Examples Örnekler panelini açan N examples ▾ (veya Add examples ▾) bağlantısı. Ek ipuçları: N counter-examples; 5’in altındayken N more needed; 5 ile 19 arasında few examples rozeti.
Precision at 70% Eğitilmiş türün varsayılan eşikte ölçülen kesinliği; tür %70’te hiç tetiklenmediyse —.
Recall at 70% %70’te ölçülen duyarlılık (yakalama oranı). Eğitilmiş katmanda bulunmayan türler için her iki sütunda da not trained rozeti görünür.
Rules Türü kullanan kural sayısı (yayımlanmış veya geçerli taslaktaki).
(çöp kutusu simgesi) Silme. Bir kural türü kullandığı sürece devre dışıdır; araç ipucu kuralların adını verir (Used by: …).
AI Classification → Your document types.

11.5.2 Belge türü oluşturma

  1. Your document types sekmesini açın.
  2. Tablonun altındaki satırda New document type alanına bir ad girin; örneğin Board minutes (yönetim kurulu tutanağı).
  3. Suggested label seçin (isteğe bağlı) ve etiketin alt hassasiyetleri varsa bir Sub-label seçin.
  4. + Add type düğmesine tıklayın. Tür oluşturulur ve örnekler paneli açılır.
Alan İşlevi Varsayılan / izin verilen değerler
New document type Konsolda, kural düzenleyicisinde, kullanıcının etiket penceresinde (AI suggestion: Board minutes …) ve denetim kaydında görünen ad. Zorunlu, 2–60 karakter (birden çok boşluk teke indirilir). Büyük/küçük harf duyarsız olarak benzersiz olmalıdır. 2 karakterin altında + Add type devre dışı kalır.
Suggested label Bu türden kural oluşturulduğunda önceden doldurulan etiket. — none — veya politikadaki herhangi bir etiket.
Sub-label Etiketle birlikte önceden doldurulan alt hassasiyet. Yalnızca etiketin alt hassasiyetleri varsa görünür. — none — veya seçilen etiketin bir alt etiketi.

Sınırlar: 50 belge türü. Sunucu her türe kalıcı bir iç kimlik verir; kurallar bu kimliğe başvurduğundan türün etiketi kuralları bozmadan değiştirilebilir. Konsolda yeniden adlandırma yoktur — adı değiştirmek için yeni bir tür oluşturun.

11.5.3 Örnek yükleme

Panelini açmak için türün Examples bağlantısına tıklayın.

  1. Upload examples düğmesine tıklayıp bir veya daha fazla dosya seçin ya da dosyaları satırın üzerine sürükleyin (or drop files here).
  2. Her dosya bir ilerleme listesinde görünür: waiting → reading… → added (docx, 1,234 words) ya da kırmızı renkte hata.
  3. Dosyalar tek tek gönderilir; başarısız olan bir dosya diğerlerini durdurmaz.
  4. Tüm dosyalar bitince saklanan örneklerin listesi yenilenir.
Öğe Değer
Kabul edilen biçimler Word (.docx, .docm, .dotx), Excel (.xlsx, .xlsm), PowerPoint (.pptx, .pptm), PDF, Word/Excel/PowerPoint 97-2003 (.doc, .xls, .ppt), metin (.txt, .csv). Dosya türü yalnızca uzantıdan değil, içerikten de algılanır.
Boyut sınırı Dosya başına 64 MB. Daha büyük dosyalar tarayıcıda reddedilir (larger than 64 MB).
Tür başına en az 5 örnek (eğitim daha azına sahip türleri kabul etmez).
Tür başına önerilen 20 veya daha fazla, çeşitli belge.
En fazla Tür başına 500 örnek (örnek + karşı örnek), toplamda 3.000.
Yinelenenler Aynı metin, hangi türde olursa olsun iki kez saklanamaz: The same text was already uploaded as “file.docx” (Type).
Kabul edilmeyenler Okunabilir metni olmayan dosyalar (metin katmanı olmayan taranmış görüntüler, boş veya parola korumalı dosyalar), arşivler, yürütülebilir dosyalar: Unsupported file type… / No text could be read from this document…

Saklanan örnekler yükleme denetimlerinin altında listelenir:

Sütun İçerik
File Dosya adı; karşı örnekler not this type rozeti taşır (önce örnekler listelenir).
Kind Algılanan biçim (docx, pdf, xls, text …).
Words Belgeden okunan kelime sayısı.
Added Tarih, saat ve yükleyen yönetici.
(düğme) Remove saklanan örneği hemen siler.

İyi örnek seçmek

  • En önemli etken sayıdır. Yaklaşık 8 örnekle bir tür, farklı ifade edilmiş belgelerin tipik olarak üçte biri ile beşte dördü arasını yakalar; yaklaşık 25 örnekle üçte ikisinden neredeyse tamamına kadarını.
  • Dil önemlidir. Kullanıcılarınızın yazdığı her dilde örnek yükleyin; dengeli bir küme (örneğin 10 Türkçe + 10 İngilizce), tek dilde 20 örnekten çok daha iyi sonuç verir.
  • Çeşitlendirin. Farklı yazarlar, yıllar, şablonlar ve uzunluklar; kullanıcıların gerçekte yazdığı biçimde. Neredeyse aynı kopyalar (20 kişi için doldurulmuş aynı şablon) kalite ölçülürken tek belge sayılır.
  • Her anlam için bir tür. İki tür bir insan için zor ayırt ediliyorsa model için de zor olacaktır; bunları birleştirmeyi düşünün.

11.5.4 Karşı örnekler

Karşı örnek, o tür olmayan bir belgedir — genellikle türün test kipinde veya Test a document ekranında yanlışlıkla eşleştiği bir dosya.

  1. Türün örnekler panelini açın.
  2. Upload counter-examples düğmesine tıklayıp dosyaları seçin (documents that are NOT Board minutes — e.g. files it matched by mistake).
  3. Train düğmesine yeniden tıklayın. Karşı örnekler yalnızca eğitimden sonra etkili olur.

Kurallar:

  • Karşı örnekler kendi ağırlıklarıyla “türlerinizin hiçbiri” olarak eğitilir; bu nedenle 5–10 karşı örnek, bir türün örnekleri kadar ağırlık taşır.
  • Türün en az 5 örnek koşuluna sayılmazlar.
  • Dosya aslında diğer türlerinizden biriyse, onu o türe örnek olarak ekleyin.
  • Aynı metin hem örnek hem karşı örnek olamaz.
  • Bir türü silmek, karşı örneklerini de siler.
Bir belge türünün örnekler paneli: örnek ve karşı örnek yükleme.

11.5.5 Tür silme

  1. Türün çöp kutusu simgesine tıklayın (herhangi bir kural türü kullandığı sürece devre dışıdır — önce bu kurallardan YZ koşulunu kaldırın, kaydedin ve yayımlayın).
  2. Delete with N example(s) ile onaylayın ya da Cancel seçin.

Tür ve saklanan tüm örnekleri ile karşı örnekleri sunucudan silinir. Son tür buysa eğitilmiş katman kaldırılır ve politika yeniden imzalanır; ajanlar bir sonraki politika eşitlemesinde puanlamayı bırakır.

11.5.6 Örneklerin saklanması

Konu Davranış
Özgün dosya Hiçbir zaman saklanmaz. ada-api dosyayı bellekte ada-ml’ye iletir; ada-ml metni geçici bir bellek alanında çıkarır ve dosyayı atar.
Saklanan Çıkarılan metin ve vektörü; sıkıştırılmış ve AES-256-GCM ile şifrelenmiş olarak (örnek başına, kimliğine bağlı bir kayıt). Metin, model yükseltildiğinde örneklerin yeniden okunabilmesi için tutulur.
Anahtar İlk kullanımda üretilen rastgele 256 bitlik anahtar; sunucunun veri klasöründe yalnızca sahibin erişebileceği izinlerle saklanır.
Yinelenme denetimi Metnin anahtarlı karması (HMAC); böylece dizin, belirli bir metnin yüklenip yüklenmediğini sınamak için kullanılamaz.
Günlükleme ada-ml dosya adlarını veya metni hiçbir zaman günlüğe yazmaz. Yükleme, silme ve test olayları dosya adıyla denetim kaydına yazılır (bölüm 11.11).
Yedek Türler, şifreli örnekler, anahtar ve eğitilmiş katman Full yedeğe dahildir. Yapılandırma dışa aktarımına dahil değildir; dolayısıyla örnekler bu yolla hiçbir zaman başka bir sunucuya taşınmaz.