WAI Rapor Asistanı
Genel bakış
WAI Rapor Asistanı, kullanıcının sohbette yazarak ya da konuşarak sorduğu soruya en uygun hazır raporu veya dashboard'u bulur. Raporu isteğe göre filtreleyerek açar, gerekirse periyodik çalıştıracak bir robot kurar. Uygun rapor yoksa soruyu veriyle cevaplar; bu cevap tek tıkla özel rapora dönüştürülebilir.
- Nereden kullanılır: Herhangi bir sayfadan WAI sohbet paneli açılır. Rapor ana sayfasındaki eski sesli asistan (Luna) kaldırılmıştır; sesli kullanım da WAI sohbetinden yapılır.
- Kapsam: Standart raporlar, dashboard'lar ve aktif özel raporlar.
- Örnek istekler: "Benim için geçerli kanban raporunu göster", "fatura bazında satış analiz raporu, bu ayın faturaları", "satınalma dashboard'unu aç", "stoklarla ilgili hangi raporlar var?"
Çalışma prensibi
- İsteğin türü belirlenir. WAI, kullanıcının hazır bir rapor mu istediğine ("X raporunu aç", "X dashboard'unu göster") yoksa doğrudan bir sayı/liste mi sorduğuna ("geçen ay kaç fatura kesildi") karar verir. Rapor isteği rapor aramasına, veri sorusu veri sorgusuna gider.
- Rapor kataloğunda aranır. Tüm raporlar ve dashboard'lar adı, modülü, kategorisi ve açıklamasıyla bir katalogda tutulur. Arama iki koldan yapılır ve sonuçlar birleştirilir:
- Anlamsal arama: Soru ile rapor açıklamaları anlam olarak karşılaştırılır. "Personel giriş çıkış takibi" sorusu, adında bu kelimeler geçmese de "Çalışan Devam Raporu"nu bulur.
- Kelime araması: Rapor adı ve açıklamasındaki kelimelerle eşleştirilir; nadir geçen kelimeler daha ağır basar. Veritabanında MS SQL Full-Text Search ya da PostgreSQL metin araması varsa otomatik kullanılır, yoksa WAI'nin kendi kelime araması çalışır.
- Güven ölçülür. Her adaya güven derecesi verilir. Düşük güvenli eşleşmeler gösterilmez; böylece alakasız sorularda ("bugün hava nasıl") rapor önerilmez.
- Yetki süzülür. Kullanıcıya yalnızca açma yetkisi olduğu raporlar gösterilir:
- Standart rapor ve dashboard: sayfa yetkisi ve modül yetkisi (Rapor Yetkileri dahil).
- Özel rapor: rapordaki erişim tanımları (pozisyon / pozisyon tipi). Yöneticiler tüm aktif raporları görür.
- En uygun en fazla 3 rapor listelenir. Her rapor için "Aç ve filtrele", "Robot ekle" ve 👍 / 👎 butonları gösterilir. Uygun ve yetkili rapor yoksa soru veri sorgusuyla cevaplanır.
Aç ve filtrele
Rapor adına tıklamak raporu filtresiz açar. Aç ve filtrele ise isteğin içindeki kısıtları raporun filtre formuna uygular:
- WAI raporun filtre formunu okur ve her alanın türünü çıkarır: serbest metin, seçim listesi, tarih, işaret kutusu, kişi ya da kayıt (proje, firma, iş) seçimi, zorunlu olup olmadığı.
- İstekteki kısıtlar bu alanlara eşlenir ve her değer alanın türüne göre doğrulanır:
- Seçim listelerinde yalnızca listede olan değerler kullanılır. Listesi veritabanından gelen alanlara WAI değer vermez.
- Tarihler kullanıcının tarih biçimine göre yazılır ve geçerliliği kontrol edilir.
- "Benim için", "bana ait" gibi ifadeler oturumdaki kullanıcı olarak yorumlanır.
- Kişi, proje ve firma adları veritabanında aranır; alana gerçek kaydın kimliği yazılır. Forma uymayan hiçbir değer rapora gönderilmez.
- Belirsizlikte sorulur: Bir isim birden fazla kayda uyuyorsa ("Ahmet" → birden fazla çalışan), bulunamıyorsa ya da zorunlu bir alan eksikse WAI seçenekli bir soru sorar. Kullanıcı seçeneklerden birini seçebilir, kendisi yazabilir ya da raporu filtresiz açabilir.
- Uygulanan filtreler butonun altında gösterilir (ör. "Görevli: Alper Çitmen", "Tarih Aralığı: 01/10/2026 – 31/10/2026") ve rapor bu filtrelerle açılır. Sohbet küçültülür; rapor sayfasından kaldığı yerden devam edilebilir.
Robot ekle
Bir raporu periyodik çalıştırmak için kullanılır.
- WAI raporun filtrelerini "Aç ve filtrele" ile aynı yöntemle çıkarır; bu adımda hiçbir kayıt açılmaz.
- Kullanıcıdan onay istenir: "Kanban raporunu Görevli: Alper Çitmen filtresiyle periyodik çalıştıracak bir robot oluşturulsun mu?"
- Onaylanırsa robot kaydı açılır (ör. "WAI: Kanban (Alper Çitmen)").
- Robotik Görevler ekleme ekranı açılır: robot seçili; Görev Adı, URL, Açıklama ve Başlangıç tarihi/saati dolu gelir. Kullanıcı periyodu seçip kaydeder.
- Görev her çalıştığında rapor, robotu oluşturan kullanıcı adına ve kayıtlı filtrelerle üretilir. Sonuç Arşivlenmiş Raporlar'a yazılır ve kullanıcının e-posta adresi varsa gönderilir.
Ön koşul: Robotik Görevler ekranında kayıt ekleme yetkisi. Yetkisi olmayan kullanıcıya "Robot ekle" butonu gösterilmez.
Rapor oluştur
Uygun hazır rapor olmayan sorularda WAI veriyi doğrudan sorgular ve sonucu tablo olarak gösterir. Sonucun altındaki Rapor oluştur rozetiyle bu sorgu özel rapor olarak kaydedilir:
- Rapor adı sorulur (varsayılan: isteğin kendisi).
- Özel rapor, raporu oluşturan kullanıcıya erişim verilerek açılır ve aktif dönemin verisiyle çalışır.
- Kaydedilen rapor hemen rapor kataloğuna eklenir; sonraki aramalarda bulunur ve robota bağlanabilir.
- Yalnızca salt okunur sorgular rapora dönüştürülebilir. Ön koşul: Özel Raporlar ekranında kayıt ekleme yetkisi.
Öğrenme (👍 / 👎)
- 👍 "Bu soruya bu rapor doğru" bilgisini kaydeder. Aynı ya da benzer bir soru geldiğinde bu rapor öne çıkar.
- 👎 Aynı soru için o raporu geri plana iter.
- Bir kullanıcı aynı soru-rapor eşleşmesine oturum başına bir kez oy verebilir ve yalnızca açabildiği raporlara oy verebilir.
Kataloğun güncelliği
- Özel rapor eklendiğinde, güncellendiğinde ya da silindiğinde katalog hemen güncellenir.
- Katalog ayrıca 24 saatte bir kendiliğinden tam güncellenir; değişmeyen kayıtlar atlanır.
- İsteyen kurulumlar Robotik Görevler ekranından "WAI Rapor Kataloğu Senkronu" robotunu gece çalışacak şekilde zamanlayabilir.
- Pasife alınan ya da silinen raporlar önerilerde görünmez.
Gereksinimler
- Gemini API anahtarı: Anlamsal arama ve filtre çıkarımı için.
- ChromaDB: Rapor kataloğunun anlamsal arama veritabanı. Erişilemezse arama kelime aramasıyla çalışmaya devam eder.
- Veritabanı güncellemesi (WRO): Öğrenme kayıtları ve gece robotu tanımı için. Uygulanmamışsa sistem çalışır; 👍 / 👎 kayıtları yalnızca anlamsal arama veritabanında tutulur.
- İsteğe bağlı: MS SQL Full-Text Search. Kurulu değilse WAI'nin kendi kelime araması kullanılır.
Sık sorulanlar
- Raporu bildiğim halde önerilmiyor. Rapor pasif olabilir, ya da raporu açma yetkiniz yoktur. Yeni kaydedilmiş bir özel rapor birkaç saniye içinde kataloğa eklenir.
- Filtre uygulanmadı. İstekteki ifade raporun formundaki bir alana güvenle eşlenemediyse WAI o alanı boş bırakır; yanlış değer göndermek yerine raporu filtresiz açmayı tercih eder. İsteği alan adıyla netleştirmek ("görevli Ahmet Arslan olsun") eşlemeyi kolaylaştırır.
- Sayı sordum, rapor listesi geldi (ya da tersi). İsteği netleştirin: "X raporunu aç" rapor arar, "X kaç tane / ne kadar" veriyi sorgular.
Geri Bildirim
Workcube hakkında konuşalım mı?
Görüşme süresi doldu.