FormaFit-Asistan-1.5B

Proje özeti

FormaFit Spor Kulübü için hazırlanmış Türkçe bir üye asistanı prototipidir.

Asistanın amacı üyelik rehberindeki bilgileri bulmak, grup ders programını CSV tablosundan sorgulamak ve gerektiğinde basit sayısal hesaplamalar yapmaktır.

Kullanılan kaynaklar

• Rehber.pdf: Üyelik ve tesis kurallarına ilişkin PDF rehberi.
• ders_programi.csv: Grup derslerinin gün, saat, süre, eğitmen, seviye ve salon bilgileri.
• test_sorulari.csv: Değerlendirme için ayrılmış soru ve beklenen cevaplar.

Kaynak dosyalardaki bilgiler projenin kapsamını belirler. Rehberde bulunmayan bilgilerin kesin bilgi gibi sunulmaması hedeflenmiştir.

Teknik yaklaşım

• Taban model: Qwen/Qwen2.5-0.5B-Instruct
• İnce ayar yaklaşımı: 4-bit yükleme ve LoRA/QLoRA
• Belge erişimi: RAG, metin parçaları ve Chroma vektör veritabanı
• Ders verisi: CSV üzerinden doğrudan sorgulama
• Araçlar: rehber arama, ders programı arama ve güvenli aritmetik
• Kullanıcı arayüzü: Gradio
• İsteğe bağlı dışa aktarma: GGUF

Eğitim ve değerlendirme

• Sentetik eğitim örneği: 248
• Sentetik test örneği: 27
• Gerçek test dosyasındaki soru sayısı: 13
• Eğitim öncesi kimlik adı oranı: 0.000
• Eğitim sonrası kimlik adı oranı: 0.000
• Eğitim öncesi işaret oranı: 0.000
• Eğitim sonrası işaret oranı: 0.900
• Basit metin eşleşme oranı: 0.000

Basit metin eşleşme oranı, anlamsal doğrulukla aynı değildir. Ücret, tarih, saat ve kural içeren cevaplar kaynaklarla ayrıca karşılaştırılmalıdır.

Sınırlamalar

• Sentetik eğitim örnekleri otomatik oluşturulmuştur; insan denetimi gerekir.
• PDF metin çıkarımı taranmış sayfalarda başarısız olabilir.
• RAG yanlış veya eksik bir bölüm getirebilir.
• Model, araçları yanlış seçebilir veya geçersiz JSON üretebilir.
• Test sonuçları kullanılan model, veri ve çalışma ortamına bağlıdır.
• Bu prototip resmi üyelik, ödeme veya rezervasyon işlemlerini gerçekleştirmez.

Güvenlik ve kullanım

Bu proje prototip ve eğitim amacıyla geliştirilmiştir. Gerçek üye kişisel verileri bu depoya yüklenmemelidir. Yayın öncesinde taban modelin lisansı ve dağıtım koşulları kontrol edilmelidir.