FitBot 💪 — FormaFit Spor Kulübü Akıllı Üye Asistanı (FitBot-3B)
Bu model, Tech Istanbul Uygulamalı Yapay Zekâ Geliştirme Bootcamp bitirme projesi kapsamında Qwen/Qwen2.5-3B-Instruct taban modeli üzerine 3 epoch QLoRA (r=16, tüm doğrusal katmanlar) yöntemiyle ince ayar (fine-tuning) yapılarak geliştirilmiştir.
1. Proje Özeti
FitBot, kurgusal FormaFit Spor Kulübü üyelerine yardımcı olmak üzere geliştirilmiş Türkçe bir yapay zekâ asistanıdır. Üyelere üyelik türleri, kayıt, çalışma saatleri, üyelik dondurma, iptal ve iade, grup dersi rezervasyonu, kişisel antrenör, havuz/sauna/dolap/misafir kuralları, otopark ve grup dersi programı konularında resmi kaynaklara dayanarak bilgi verir, kaynakta olmayan bilgileri uydurmaz ve her cevabını 💪 işareti ile bitirir. Asistanın bilgi kaynakları iki katmandan oluşur: Üyelik ücretleri, çalışma saatleri ve kulüp kuralları 15 bölümlü rehber.pdf dosyasından Chroma vektör veritabanı (paraphrase-multilingual-mpnet-base-v2) ile çekilirken; grup derslerinin gün, saat, süre, eğitmen ve salon bilgileri ders_programi.csv tablosundan ajan araçları (ders_bilgisi, hesapla, rehberde_ara ve kendi geliştirdiğimiz otopark_ucreti aracı) üzerinden alınır.
2. Taban Model Gerekçesi
Taban model olarak Hugging Face üzerinden Qwen/Qwen2.5-3B-Instruct (3 milyar parametre) seçilmiştir. 1.5B boyutundaki modele kıyasla 3B parametreli modelin seçilme gerekçesi; Türkçe dilbilgisi akıcılığının, RAG bağlamındaki çoklu sayısal kuralları (ör. yıllık iptal kesinti oranları ve üyelik dondurma şartları) ayırt etme başarısının ve iki turlu ajan döngüsünde geçerli JSON üretme kararlılığının belirgin biçimde daha yüksek olmasıdır. Ücretsiz Google Colab T4 GPU'da (15 GB VRAM) 4-bit NF4 niceleme ve gradient_checkpointing kullanılarak bellek taşması olmadan eğitilebilmiştir.
3. Gözlemler
Sentetik veri kontrolünde kimlik, rag ve iki turlu ajan örneklerinin rehber.pdf ve ders_programi.csv içindeki gerçek sayılarla (Standart 1.650 TL, Plus 2.300 TL, Öğrenci 1.100 TL, ilk 3 saat ücretsiz otopark vb.) tam uyumlu olması sağlandı. Eğitimden önce taban model kendi adını (FitBot) ve 💪 işaretini hiç kullanmazken ve JSON araç protokolünü kısmen uygularken; 3 epoch QLoRA ince ayarı sonrasında adını söyleme, 💪 işareti kullanımı, geçerli JSON üretimi ve doğru araç seçim oranları tam puana ulaştı. Bağlamsız ve RAG'lı cevap kıyasında, modelin bağlam verilmediğinde üyelik ücretlerini tahmin ederek uydurduğu, ancak RAG bağlamı (k=2) verildiğinde rehberdeki tam sayıları söylediği ve rehberde yer almayan protein tozu satışı ile sauna sıcaklığı sorularında uydurma yapmayarak "Rehberde bu konuda bilgi bulunmamaktadır." yanıtını verdiği doğrulandı.
4. Sınırlar
- Çok Adımlı Ajan Zincirleri: Tek araçla çözülen tablo veya otopark ücreti soruları yüksek doğrulukla yanıtlanırken, aynı anda hem tablo araması hem matematiksel çarpma gerektiren çok adımlı sorularda 3B boyutundaki modelin
ders_bilgisivehesaplaaraçlarını ardışık çalıştırması desteklenmiştir. - TF-IDF ve CPU Hızı: Web sitesinde (Space) ücretsiz CPU ortamında çalışırken yanıt süresi birkaç saniye sürebilmektedir; ayrıca sitedeki TF-IDF araması rehberde hiç geçmeyen eş anlamlı kelimelerde farklı bölümleri getirebilir.
- Kapsam Sınırı: Asistan yalnızca
rehber.pdfveders_programi.csvverileriyle sınırlıdır; gerçek zamanlı kontenjan doluluk takibi veya ödeme işlemi yapamaz.
📊 Eğitim Öncesi ve Sonrası Ölçüm Tablosu
| Aşama | Adını Söyleme | İşaret (💪) | Geçerli JSON | Doğru Araç | RAG Hakem Puanı |
|---|---|---|---|---|---|
| Eğitim Öncesi (Qwen2.5-3B Ham) | 0.00 | 0.00 | 0.50 | 0.50 | 0.75 |
| Eğitim Sonrası (FitBot-3B QLoRA) | 1.00 | 1.00 | 1.00 | 1.00 | 1.00 |
🧪 Test Soruları Değerlendirme Tablosu (15 Soru)
| No | Mod | Soru | Beklenen Cevap | FitBot-3B Cevabı | Kaynak | Puan |
|---|---|---|---|---|---|---|
| 1 | RAG | Öğrenci üyeliği ne kadar? | Aylık 1.100 TL; 25 yaş altı, öğrenci belgesiyle, hafta içi 07:00-16:00. | Öğrenci üyeliği aylık 1.100 TL'dir; 25 yaş altı öğrencilere öğrenci belgesiyle verilir ve hafta içi 07:00-16:00 saatleri arasında geçerlidir. 💪 | Üyelik türleri | 1.0 |
| 2 | RAG | Tatile gideceğim, üyeliğimi durdurabilir miyim? | Evet; yılda toplam 60 gün, her seferinde en az 15 gün, en az bir gün önceden. | Evet, üyeliğinizi yılda toplam en fazla 60 gün, her seferinde en az 15 gün olmak üzere başlangıçtan en az 1 gün önce başvurarak dondurabilirsiniz. 💪 | Üyelik dondurma | 1.0 |
| 3 | RAG | Yıllık üyeliğimi iptal edersem paramı geri alır mıyım? | İlk 14 gün tamamı; sonrasında kalan aylar yüzde 25 kesintiyle. | İlk 14 gün içinde yapılan iptallerde ücretin tamamı iade edilir; 14 günden sonra kalan ayların ücreti yüzde 25 kesintiyle iade edilir. 💪 | İptal ve iade | 1.0 |
| 4 | RAG | Dersi iptal etmeyi unutup gitmezsem ne olur? | Bir ayda üç kez olursa 7 gün rezervasyon yasağı. | Bir ay içinde 3 kez rezervasyon yapıp derse gelmeyen üyenin rezervasyon hakkı 7 gün boyunca askıya alınır. 💪 | Grup dersi rezervasyonu | 1.0 |
| 5 | RAG | Kişisel antrenör ücretleri ne kadar? | Tek seans 900 TL, 10 seans 7.500 TL (3 ay geçerli). | Kişisel antrenör tek seans ücreti 900 TL, 10 seanslık paket ücreti 7.500 TL'dir (3 ay geçerlidir). 💪 | Kişisel antrenör | 1.0 |
| 6 | RAG | Havuz hangi saatlerde kapalı? | Her gün 12:00-13:00 bakım; ayrıca kulüp kapanışından bir saat önce kapanır. | Havuz her gün 12:00-13:00 saatleri arasında bakım nedeniyle kapalıdır ve kulüp kapanışından 1 saat önce kapanır. 💪 | Havuz kuralları | 1.0 |
| 7 | RAG | Arkadaşımı getirebilir miyim? | Plus üyeler ayda iki misafir ücretsiz; diğerleri için günlük 400 TL; 18 yaş üstü ve kimlik. | Plus üyeler ayda 2 misafiri ücretsiz getirebilir. Diğer üyelerin misafirleri için günlük giriş ücreti 400 TL'dir; 18 yaş sınırı ve kimlik zorunludur. 💪 | Misafir girişi | 1.0 |
| 8 | RAG | Pazar günü kaçta kapanıyorsunuz? | 20:00. | Pazar günleri kulübümüz saat 09:00-20:00 arasında açıktır, saat 20:00'de kapanmaktadır. 💪 | Çalışma saatleri | 1.0 |
| 9 | RAG | Kot pantolonla antrenman yapabilir miyim? | Hayır. | Hayır, kot pantolon ve sokak ayakkabısıyla antrenman yapılamaz; spor kıyafeti, temiz spor ayakkabısı ve havlu zorunludur. 💪 | Kıyafet kuralları | 1.0 |
| 10 | Ajan | Pilates dersleri hangi günler? | Pazartesi 09:00 (başlangıç) ve Çarşamba 19:00 (orta), Stüdyo A, Defne Uçar. | Pilates dersleri Pazartesi 09:00 (başlangıç) ve Çarşamba 19:00 (orta) saatlerinde, 50 dk süreyle Stüdyo A'da Defne Uçar tarafından verilmektedir. 💪 | tablo: ders_programi.csv | 1.0 |
| 11 | Ajan | Haftada iki Spinning dersine katılırsam toplam kaç dakika eder? | 2 x 45 = 90 dakika. | Spinning dersi 45 dakikadır. Haftada 2 Spinning dersine katılırsanız toplam 2 x 45 = 90 dakika eder. 💪 | tablo + hesap | 1.0 |
| 12 | RAG | Protein tozu satıyor musunuz? | Rehberde yok; uydurmamalı. | Rehberde bu konuda bilgi bulunmamaktadır. 💪 | yok | 1.0 |
| 13 | RAG | Saunanın sıcaklığı kaç derece? | Rehberde yok; uydurmamalı. | Rehberde bu konuda bilgi bulunmamaktadır. 💪 | yok | 1.0 |
| 14 | Ajan | Otoparkta 2 saat kalırsam kaç TL öderim? | Üyelere ilk 3 saat ücretsizdir (0 TL). | 2 saat için otopark ücretsizdir (Üyelere ilk 3 saat ücretsiz, 0 TL). 💪 | araç: otopark_ucreti | 1.0 |
| 15 | Ajan | Aracım kulüp otoparkında 5 saat kaldı, ne kadar ücret ödeyeceğim? | İlk 3 saat ücretsiz, aşan 2 saat için 2 x 50 = 100 TL. | İlk 3 saat ücretsizdir; aşan 2 saat için 2 x 50 = 100 TL otopark ücreti alınır. 💪 | araç: otopark_ucreti | 1.0 |
🔗 Proje Bağlantıları
- Model Deposu: https://huggingface.co/Ozzycan/FitBot-3B
- GGUF ve Space Dosyaları Deposu: https://huggingface.co/Ozzycan/FitBot-3B-GGUF
- Eğitim Veri Seti Deposu: https://huggingface.co/datasets/Ozzycan/fitbot-3b-veri
- Downloads last month
- 34