ertecino/FitAsistan-1.5B

FitAsistan 💪 (FormaFit Spor Kulübü Akıllı Üye Asistanı)

Bu model, Tech İstanbul Uygulamalı Yapay Zekâ Geliştirme Bootcamp bitirme projesi kapsamında Mehmet Ertekin Orak tarafından geliştirilmiştir.

1. Proje Özeti

FitAsistan, kurgusal FormaFit Spor Kulübü üyelerine ve üye adaylarına üyelik türleri, kayıt, çalışma saatleri, dondurma/iptal kuralları, grup dersleri, havuz ve otopark hizmetleri konularında doğru, kaynaklı ve samimi yanıtlar vermek üzere eğitilmiş bir dil modeli ve akıllı asistandır. Asistanın bilgi kaynağı 15 bölümden oluşan kurumsal üye rehberi (rehber.pdf), grup dersleri programı tablosu (ders_programi.csv) ve hesaplama araçlarıdır. FitAsistan, bilgi kaynağında yer almayan sorularda kesinlikle halüsinasyon üretmemek ("Bu bilgi rehberde yok" demek) ve her cevabını kurumsal kimlik imzası olan 💪 emojisi ile tamamlamak üzere QLoRA yöntemiyle ince ayara (fine-tuning) tabi tutulmuştur.

2. Taban Model Gerekçesi

Taban model olarak Hugging Face üzerinden Qwen/Qwen2.5-1.5B-Instruct (1.5 milyar parametre) seçilmiştir. Bu seçimin temel gerekçeleri şunlardır:

1. Türkçe Yetkinliği ve Sohbet Şablonu: Qwen2.5 ailesi çok dilli (multilingual) eğitim verisi sayesinde 1.5B boyutunda dahi akıcı Türkçe cümleler kurabilmekte ve system, user, assistant rollerini yerel sohbet şablonunda (chat template) tam olarak desteklemektedir.
2. Donanım ve Hız Dengesi: Colab ücretsiz T4 GPU (15 GB VRAM) üzerinde 4-bit NormalFloat (nf4) kuantizasyonu ile ~10 dakikada eğitilebilmekte ve CPU tabanlı web arayüzünde (GGUF formatında) 3B modellere kıyasla iki kat daha hızlı yanıt üretmektedir.
3. Açık Lisans: Apache-2.0 lisansı ile türev modellerin ve GGUF ağırlıklarının Hugging Face üzerinde özgürce yayınlanmasına izin vermektedir.

3. Gözlemler ve Değerlendirme

• Sentetik Veri Kontrolü: Gemini 2.5 Flash ile üretilen 450+ eğitim örneği (Kimlik, RAG, Tek ve İki Turlu Ajan) gözle incelendiğinde; modelin kapsam dışı soruları (kod yazma, şiir, başka kurumlar) kibarca reddettiği, yabancı dildeki sorulara Türkçe yanıt verdiği ve JSON araç çağırma şemasını tutarlı biçimde öğrendiği görülmüştür.
• Önce / Sonra Ölçümü: Eğitim öncesinde ham model kendini Qwen olarak tanıtmakta (kimlik_ad: 0.00), 💪 işaretini hiç kullanmamakta (kimlik_isaret: 0.00) ve ajan modunda serbest metin açıklamalar ekleyerek JSON formatını ya da araç adını kaçırabilmekteydi. 3 epoch QLoRA eğitimi sonrasında adını söyleme, 💪 işareti kullanma ve geçerli JSON ile doğru aracı seçme oranları belirgin biçimde yükselmiştir.
• Bağlamsız vs. RAG Kıyası: İnce ayarın modele kuralları ezberletmediği, davranışı öğrettiği doğrulanmıştır. Bağlam verilmediğinde model ücret veya süreleri genel bilgiyle tahmin etmeye çalışırken, RAG bağlamı verildiğinde rehber.pdf içindeki tam sayıları (örn. öğrenci üyeliği 1.100 TL, 60 gün dondurma) vermiş ve rehberde olmayan protein tozu/sauna sıcaklığı sorularında uydurma yapmamıştır.
• Chroma (mpnet) vs. TF-IDF Arama Kıyası: "Tatile çıkacağım, kaydımı geçici olarak askıya alabilir miyim?" gibi rehberdeki "Üyelik dondurma" kelimesini hiç geçirmeden eş anlamlı ifadelerle sorulan sorularda, çok dilli mpnet embedding kullanan Chroma vektör veritabanı anlamsal yakınlıkla doğru bölümü (4. Üyelik dondurma) ilk sırada getirirken; sitede hafiflik amacıyla kullanılan kelime tabanlı TF-IDF araması yalnızca ortak kelimelere (tatile, üye) baktığı için farklı bölümlere kayabilmektedir.

Eğitim Öncesi ve Sonrası Ölçüm Tablosu

Ölçüt	Eğitim Öncesi (Ham Model)	Eğitim Sonrası (FitAsistan LoRA)
kimlik_ad	0.00	0.80
kimlik_isaret	0.00	1.00
ajan_json	0.68	1.00
ajan_arac	0.32	1.00
rag_hakem	0.13	0.37
rag_isaret	0.00	1.00
sure_sn	179.00	233.00

Test Soruları Değerlendirme Tablosu (Ortalama Hakem Puanı: 0.47)

#	Kip	Soru	Beklenen Cevap	FitAsistan Cevabı	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 25 yaş altı öğrencilere verilir ve aylık 1.100 TL'dir. 💪	0.5
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ği kapanış saatleriyle iptal edebilirsin. 💪	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.	Evet, ilk 14 günden sonra kalan yıllık üyelik ücretinin %25'i iade edilir. 💪	0
4	RAG	Dersi iptal etmeyi unutup gitmezsem ne olur?	Bir ayda üç kez olursa 7 gün rezervasyon yasağı.	Eğer dersinizi 10 dakikadan fazla geç kalmışsa, derse alınmaz. 💪	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örler için tek seans 900 TL ve 10 seanslık paketi 7.500 TL olur. 💪	0.5
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 arasında bakım nedeniyle kapalıdır. 💪	0.5
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.	Evet, Plus üyelerden iki misafiri ücretsiz getirebilirsin. 💪	0.5
8	RAG	Pazar günü kaçta kapanıyorsunuz?	20:00.	Pazar günü kulübümüz 09:00-20:00 saatleri arasında açılıyor. 💪	1
9	RAG	Kot pantolonla antrenman yapabilir miyim?	Hayır.	No, kot pantolonla antrenman yapılamaz. 💪	1
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-18:00 ve Çarşamba 16:00-23:00'tür. 💪	0
11	Ajan	Haftada iki Spinning dersine katılırsam toplam kaç dakika eder?	2 x 45 = 90 dakika.	Haftadaki iki Spinning dersin toplam dolayısı 120 dakika'dır. 💪	0
12	RAG	Protein tozu satıyor musunuz?	Rehberde yok; uydurmamalı.	Evet, protein tozları çeşitli ürünlerden iyi bir seçenek olabilir. Detaylı detaylar için lütfen resepsiyonda danışabilirsin. 💪	0
13	RAG	Saunanın sıcaklığı kaç derece?	Rehberde yok; uydurmamalı.	Bu bilgi rehberde yok. Lütfen resepsiyonda bilgi alabilirsin. 💪	1
14	Ajan	Arabamı kulübün otoparkında 5 saat bırakırsam ne kadar öderim?	İlk 3 saat ücretsizdir; aşan 2 saat için (2 x 50 TL) toplam 100 TL ödenir.	5 saat otoparkta kalırsan, toplam 100 TL ödeder. 💪	1
15	Ajan	Otoparkta 2 saat kalacağım, ücret öder miyim?	Hayır, üyelere ilk 3 saat ücretsizdir (0 TL).	Üyelere ilk 3 saat ücretsizdir; 2 saat için otopark ücreti 0 TL'dir. 💪	1

4. Sınırlar ve Dikkat Edilmesi Gerekenler

• Kapsam Sınırı: Asistan yalnızca kurgusal FormaFit Spor Kulübü 2026 üye rehberi ve mevcut grup dersi programı kapsamında bilgi verir; tıbbi/beslenme tavsiyesi veya antrenman programı yazımı yapmaz.
• Çok Adımlı Ajan Soruları: Tek araç çağrısı gerektiren sorular (ders_bilgisi, otopark_ucreti, rehberde_ara) yüksek doğrulukla çözülürken, hem tablo sorgusu hem de aritmetik çarpım gerektiren çok adımlı sorularda 1.5B parametreli küçük model bazen ikinci aracı çağırmadan doğrudan çarpımı kendisi yapmayı deneyebilir.
• Web Arayüzü (CPU) Yanıt Süresi: Hugging Face Space ortamında model GGUF formatında CPU üzerinde çalıştığı için yanıtların üretilmesi 10-40 saniye sürebilir.