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: …). |
11.5.2 Belge türü oluşturma
- Your document types sekmesini açın.
- Tablonun altındaki satırda New document type alanına bir ad girin; örneğin Board minutes (yönetim kurulu tutanağı).
- Suggested label seçin (isteğe bağlı) ve etiketin alt hassasiyetleri varsa bir Sub-label seçin.
- + 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.
- 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).
- Her dosya bir ilerleme listesinde görünür: waiting → reading… → added (docx, 1,234 words) ya da kırmızı renkte hata.
- Dosyalar tek tek gönderilir; başarısız olan bir dosya diğerlerini durdurmaz.
- 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.
- Türün örnekler panelini açın.
- Upload counter-examples düğmesine tıklayıp dosyaları seçin (documents that are NOT Board minutes — e.g. files it matched by mistake).
- 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.
11.5.5 Tür silme
- 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).
- 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. |