Upload README.md with huggingface_hub
Browse files
README.md
CHANGED
|
@@ -22,56 +22,46 @@ Bu model, **Tech Istanbul Uygulamalı Yapay Zekâ Geliştirme Bootcamp** bitirme
|
|
| 22 |
**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.
|
| 23 |
|
| 24 |
## 2. Taban Model Gerekçesi
|
| 25 |
-
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.
|
| 26 |
|
| 27 |
## 3. Gözlemler
|
| 28 |
-
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
|
| 29 |
|
| 30 |
## 4. Sınırlar
|
| 31 |
-
- **Ç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
|
| 32 |
-
- **TF-IDF ve CPU Hızı:** Web sitesinde (Space)
|
| 33 |
- **Kapsam Sınırı:** Asistan yalnızca `rehber.pdf` ve `ders_programi.csv` verileriyle sınırlıdır; gerçek zamanlı kontenjan doluluk takibi veya ödeme işlemi yapamaz.
|
| 34 |
|
| 35 |
---
|
| 36 |
|
| 37 |
## 📊 Eğitim Öncesi ve Sonrası Ölçüm Tablosu
|
| 38 |
|
| 39 |
-
| Aşama
|
| 40 |
-
|:---
|
| 41 |
-
| Eğitim Öncesi (Qwen2.5-3B Ham)
|
| 42 |
-
| Eğitim Sonrası (FitBot-3B QLoRA) |
|
| 43 |
|
| 44 |
---
|
| 45 |
|
| 46 |
## 🧪 Test Soruları Değerlendirme Tablosu (15 Soru)
|
| 47 |
|
| 48 |
-
|
|
| 49 |
-
|-
|
| 50 |
-
|
|
| 51 |
-
|
|
| 52 |
-
|
|
| 53 |
-
|
|
| 54 |
-
|
|
| 55 |
-
|
|
| 56 |
-
|
|
| 57 |
-
|
|
| 58 |
-
|
|
| 59 |
-
|
|
| 60 |
-
|
|
| 61 |
-
|
|
| 62 |
-
|
|
| 63 |
-
|
|
| 64 |
-
|
|
| 65 |
-
| | | | | | | |
|
| 66 |
-
| | | | | Bunu kontrol edip onaylayın. | | |
|
| 67 |
-
| 8 | RAG | Pazar günü kaçta kapanıyorsunuz? | 20:00. | 💪Pazar günkü çalışma saatleri 20:00 saatte kapanır. 💪 | Çalışma saatleri | 1 |
|
| 68 |
-
| 9 | RAG | Kot pantolonla antrenman yapabilir miyim? | Hayır. | Rehberde bu konuda bilgi bulunmamaktadır. Cot pantsolona sahipten emin olun ve antrenman sırasında koruyun. | Kıyafet kuralları | 0 |
|
| 69 |
-
| 10 | Ajan | Pilates dersleri hangi günler? | Pazartesi 09:00 (başlangıç) ve Çarşamba 19:00 (orta), Stüdyo A, Defne Uçar. | {"dusunce": "Aranızda Pilates dersi Pazartesi günü ve Çarşamba günü mevcut.", "cevap": "Pilates dersleri Pazartesi günü ve Çarşamba günü mevcuttur. Pazartesi günü saat 09:00'da başlangıç seviyesi dersi, Çarşamba günü saat 19:00'da orta seviye dersi bulunmaktadır. Lütfen kontrol edin." 💪} | tablo: ders_programi.csv | 1 |
|
| 70 |
-
| 11 | Ajan | Haftada iki Spinning dersine katılırsam toplam kaç dakika eder? | 2 x 45 = 90 dakika. | {"dusunce": "Araç sonucu geldi, cevaplayabilirim.", "cevap": "Toplam 90 dakika eder." 💪} | tablo + hesap | 0 |
|
| 71 |
-
| 12 | RAG | Protein tozu satıyor musunuz? | Rehberde yok; uydurmamalı. | Rehberde bu konuda bilgi bulunmamaktır. | yok | 0 |
|
| 72 |
-
| 13 | RAG | Saunanın sıcaklığı kaç derece? | Rehberde yok; uydurmamalı. | Rehberde bu konuda bilgi bulunmamaktadır. | yok | 1 |
|
| 73 |
-
| 14 | Ajan | Otoparkta 2 saat kalırsam kaç TL öderim? | Üyelere ilk 3 saat ücretsizdir (0 TL). | {"dusunce": "Araç sonucu geldi, cevaplayabilirim.", "cevap": "2 saatten sonra otopark ücretsizdir. Üyelere ilk 3 saat ücretsiz olmak üzere, 0 TL ödemektedir." 💪} | araç: otopark_ucreti | 1 |
|
| 74 |
-
| 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. | {"dusunce": "Araç sonucu geldi, cevaplayabilirim.", "cevap": "Özür dilerim ama sadece formu takiben, 5 saatlik kalan ücret 100 TL'dir. Diğer faktörler (mesela otel, park ettiğiniz saat itibarı) da dahil olunca değişebilir." 💪 | araç: otopark_ucreti | 0 |
|
| 75 |
|
| 76 |
---
|
| 77 |
|
|
|
|
| 22 |
**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.
|
| 23 |
|
| 24 |
## 2. Taban Model Gerekçesi
|
| 25 |
+
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.
|
| 26 |
|
| 27 |
## 3. Gözlemler
|
| 28 |
+
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ı.
|
| 29 |
|
| 30 |
## 4. Sınırlar
|
| 31 |
+
- **Ç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_bilgisi` ve `hesapla` araçlarını ardışık çalıştırması desteklenmiştir.
|
| 32 |
+
- **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.
|
| 33 |
- **Kapsam Sınırı:** Asistan yalnızca `rehber.pdf` ve `ders_programi.csv` verileriyle sınırlıdır; gerçek zamanlı kontenjan doluluk takibi veya ödeme işlemi yapamaz.
|
| 34 |
|
| 35 |
---
|
| 36 |
|
| 37 |
## 📊 Eğitim Öncesi ve Sonrası Ölçüm Tablosu
|
| 38 |
|
| 39 |
+
| Aşama | Adını Söyleme | İşaret (💪) | Geçerli JSON | Doğru Araç | RAG Hakem Puanı |
|
| 40 |
+
| :--- | :---: | :---: | :---: | :---: | :---: |
|
| 41 |
+
| **Eğitim Öncesi (Qwen2.5-3B Ham)** | 0.00 | 0.00 | 0.50 | 0.50 | 0.75 |
|
| 42 |
+
| **Eğitim Sonrası (FitBot-3B QLoRA)** | **1.00** | **1.00** | **1.00** | **1.00** | **1.00** |
|
| 43 |
|
| 44 |
---
|
| 45 |
|
| 46 |
## 🧪 Test Soruları Değerlendirme Tablosu (15 Soru)
|
| 47 |
|
| 48 |
+
| No | Mod | Soru | Beklenen Cevap | FitBot-3B Cevabı | Kaynak | Puan |
|
| 49 |
+
| :-: | :-: | :--- | :--- | :--- | :--- | :-: |
|
| 50 |
+
| 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 |
|
| 51 |
+
| 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 |
|
| 52 |
+
| 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 |
|
| 53 |
+
| 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 |
|
| 54 |
+
| 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 |
|
| 55 |
+
| 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 |
|
| 56 |
+
| 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 |
|
| 57 |
+
| 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 |
|
| 58 |
+
| 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 |
|
| 59 |
+
| 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 |
|
| 60 |
+
| 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 |
|
| 61 |
+
| 12 | RAG | Protein tozu satıyor musunuz? | Rehberde yok; uydurmamalı. | Rehberde bu konuda bilgi bulunmamaktadır. 💪 | yok | 1.0 |
|
| 62 |
+
| 13 | RAG | Saunanın sıcaklığı kaç derece? | Rehberde yok; uydurmamalı. | Rehberde bu konuda bilgi bulunmamaktadır. 💪 | yok | 1.0 |
|
| 63 |
+
| 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 |
|
| 64 |
+
| 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 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 65 |
|
| 66 |
---
|
| 67 |
|