Model Kartı

Hangi modeli, neden, nerede.

ÖğreTio kapalı kaynaklı yapay zeka modellerini bir hizmet olarak kullanır. Bu sayfa hangi akışta hangi modeli neden seçtiğimizi, hangi guardrail'leri uyguladığımızı ve halüsinasyon riskini nasıl yönettiğimizi açıklar.

Son güncelleme: 30 Nisan 2026 · Belge sürümü: 2026.04

Genel Mimari

Tek bir “büyük model” kullanmıyoruz. Her akış için: akademik karar etkisi, maliyet ve gecikme üçgenine göre seçim yapıyoruz. Akademik karar etkisi yüksekse (öğretmen, validator, kavrama kontrolü), pahalı ama tutarlı modeli + ikinci görüş (cross-check) zorunlu kılıyoruz.

Birincil sağlayıcı: OpenAI (GPT-4o, GPT-4o-mini)
Cross-check: Google Gemini 2.0 Flash (farklı aile → bağımsız hata kalıbı)
PDF cache: OpenAI text-embedding-3-small + cosine similarity (lokal arama)

Akış × Model Matrisi

AI Öğretmen — Sokratik diyalog

ai-teacher · ana akış

gpt-4o

Türkçe akademik dil + çok adımlı çıkarım. Mini sürümler matematik çözümlerinde tutarlılık kaybediyor.

Guardrail

›Sistem prompt: kazanım koduna kilitli
›Sıcaklık: 0.3
›Önce qa-cache (PDF) sorgulanır
›ai-validator + Gemini cross-check
›Konu dışı çıkış → kibarca redirect

Cevap Doğrulayıcı (Validator)

ai-validator · arka plan

gpt-4o

Hesap, formül, tarih ve sınıf seviyesi uygunluk kontrolü. Birincil cevabı bağımsız değerlendirir.

Guardrail

›JSON-only response_format
›max_tokens: 512 (kısa karar)
›Gemini 2.0 ile zorunlu cross-check
›İki model çelişirse cevap kullanıcıya gösterilmez

Cross-Check (İkinci Görüş)

ai-validator · ikinci görüş

gemini-2.0-flash

OpenAI farklı bir aileden bağımsız modelle çelişki tespiti. Tek aile içinde aynı hata kalıbı riskini düşürür.

Guardrail

›Token başına maliyet düşük → her cevapta çalışır
›İsValid + correctedResponse JSON
›Başarısızlıkta primary cevap kabul edilir (degradation)

Kavrama Kontrolü

comprehension · değerlendirme

gpt-4o

Öğrenci yanıtının kazanım göre puanlanması. Hata DNA'sına yönlendirme.

Guardrail

›Sınıf + kazanım kodu sistem prompt'a kilitli
›Sıcaklık: 0.2 (deterministik)
›Öğrenci-yanıltıcı mizah filtresi

Konu Testi Üretimi

topic-test · soru üretimi

gpt-4o

Yeni nesil LGS formatına uygun, kazanım kodlu soru üretimi.

Guardrail

›Üretilen her soru validateQuestion() ile çözülür
›Doğru cevap eşleşmezse soru atılır
›PDF kaynaktan few-shot örneklerle stil tutarlılığı

Fotoğraftan Soru Çözme

photo · vision

gpt-4o

OCR + matematiksel çıkarım birleşik. Vision yeteneği gerekli.

Guardrail

›Görsel telif uyarısı (kullanıcının kendi defteri/sorusu varsayılır)
›Sonuç ai-validator'dan geçer

Hata DNA Analizi

mistake-dna · pedagoji

gpt-4o

Yanlış cevabın kavramsal kökeni — sıradan ezber yerine hangi kazanım eksik?

Guardrail

›Sınıflandırma kategorileri sabit liste
›Çocuk-utandırmaz dil zorunluluğu

Ders Slaytları (Lesson Slides)

lesson-slides · içerik üretimi

gpt-4o

Mini sürümler 4-6 slaytta bitiriyor; içerik derinliği için tam GPT-4o.

Guardrail

›Min 8 slayt zorunluluğu
›Her slayta görsel/grafik etiketi
›Kazanım koduna kilitli outline

Türkçe NLP (yazım/morfoloji)

turkish-nlp · yardımcı

gemini-2.0-flash

Türkçe morfoloji + yazım denetimi. Zemberek/VNLP'den daha güncel; maliyet düşük.

Guardrail

›Token bütçesi sıkı
›Akademik karar etkisi yok

Flashcard / Mini Oyun / Video

yardımcı akışlar

gpt-4o-mini

Hız ve maliyet öncelikli; akademik karar etkisi düşük.

Guardrail

›Yanlış cevap kazanım ilerlemesine sayılmaz
›Validator opsiyonel

Veri ve Yönetim Politikaları

Veri minimizasyonu

Hiçbir LLM çağrısında öğrencinin adı, e-postası veya doğum tarihi gönderilmez. Soru içeriği + kazanım kodu + sınıf seviyesi yeterli.

Eğitim kullanımı yok

OpenAI ve Google API çağrılarında 'do not train' ayarları aktif. ÖğreTio öğrenci verisi modellerin eğitiminde kullanılmaz.

Türkiye veri yerleşimi

Veritabanı (kullanıcı + AILog) Türkiye veya AB bölgesinde tutulur. LLM çağrıları sırasında veri OpenAI/Google sunucularından geçer; bunlar şifreli kanaldan iletilir ve cache'lenmez.

Halüsinasyon ölçümü

Her ay /guven/halusinasyon-raporu sayfasında: cache hit oranı, validator yakalama oranı, kullanıcı flag oranı ve çözüm süresi yayınlanır.

İnsan denetimi

Pedagojik QA ekibi flag'lenen tüm cevapları 72 saat içinde inceler. Tekrarlayan hata kalıpları sistem promptlarına ek guardrail olarak eklenir.

Sürüm takibi

Model sürümü değiştiğinde (gpt-4o → gpt-4o-2026, vb.) bu sayfa güncellenir + AILog'a yeni sürüm bayrağı düşer. Kurumsal abonelere e-posta bildirimi gider.

Bilinen Sınırlar

Çok adımlı geometri/olasılık: 5+ adımlı çözümlerde hata oranı tek-adımlı sorulara göre 2.4× daha yüksek. Bu yüzden bu konularda öğretmen rolü Sokratik (vermeyen) modda kalır; doğrudan cevap yerine yönlendirme yapar.
Yeni format LGS soruları: ÖDSGM örnek havuzu güncel; ancak Mayıs 2026 LGS'sinde tamamen yeni bir format çıkarsa cache adaptasyonu 2-3 hafta sürer.
Görselli paragraf yorumu: Tablo/grafik içeren Türkçe paragraf yorumunda vision performansı düşük metinlere göre %8-12 daha zayıf.
Türkçe atasözü/deyim: Yöresel deyimlerde halüsinasyon riski. Bu kategori cache-zorunlu olarak işaretlendi.

Bu belgenin teknik denetlenmesi için guven@ogretio.ai üzerinden iletişime geçilebilir.

Genel Mimari

Birincil sağlayıcı: OpenAI (GPT-4o, GPT-4o-mini)

Cross-check: Google Gemini 2.0 Flash (farklı aile → bağımsız hata kalıbı)

PDF cache: OpenAI text-embedding-3-small + cosine similarity (lokal arama)

Akış × Model Matrisi

AI Öğretmen — Sokratik diyalog

ai-teacher · ana akış

gpt-4o

Türkçe akademik dil + çok adımlı çıkarım. Mini sürümler matematik çözümlerinde tutarlılık kaybediyor.

Guardrail

›Sistem prompt: kazanım koduna kilitli
›Sıcaklık: 0.3
›Önce qa-cache (PDF) sorgulanır
›ai-validator + Gemini cross-check
›Konu dışı çıkış → kibarca redirect

Cevap Doğrulayıcı (Validator)

ai-validator · arka plan

gpt-4o

Hesap, formül, tarih ve sınıf seviyesi uygunluk kontrolü. Birincil cevabı bağımsız değerlendirir.

Guardrail

›JSON-only response_format
›max_tokens: 512 (kısa karar)
›Gemini 2.0 ile zorunlu cross-check
›İki model çelişirse cevap kullanıcıya gösterilmez

Cross-Check (İkinci Görüş)

ai-validator · ikinci görüş

gemini-2.0-flash

OpenAI farklı bir aileden bağımsız modelle çelişki tespiti. Tek aile içinde aynı hata kalıbı riskini düşürür.

Guardrail

›Token başına maliyet düşük → her cevapta çalışır
›İsValid + correctedResponse JSON
›Başarısızlıkta primary cevap kabul edilir (degradation)

Kavrama Kontrolü

comprehension · değerlendirme

gpt-4o

Öğrenci yanıtının kazanım göre puanlanması. Hata DNA'sına yönlendirme.

Guardrail

›Sınıf + kazanım kodu sistem prompt'a kilitli
›Sıcaklık: 0.2 (deterministik)
›Öğrenci-yanıltıcı mizah filtresi

Konu Testi Üretimi

topic-test · soru üretimi

gpt-4o

Yeni nesil LGS formatına uygun, kazanım kodlu soru üretimi.

Guardrail

›Üretilen her soru validateQuestion() ile çözülür
›Doğru cevap eşleşmezse soru atılır
›PDF kaynaktan few-shot örneklerle stil tutarlılığı

Fotoğraftan Soru Çözme

photo · vision

gpt-4o

OCR + matematiksel çıkarım birleşik. Vision yeteneği gerekli.

Guardrail

›Görsel telif uyarısı (kullanıcının kendi defteri/sorusu varsayılır)
›Sonuç ai-validator'dan geçer

Hata DNA Analizi

mistake-dna · pedagoji

gpt-4o

Yanlış cevabın kavramsal kökeni — sıradan ezber yerine hangi kazanım eksik?

Guardrail

›Sınıflandırma kategorileri sabit liste
›Çocuk-utandırmaz dil zorunluluğu

Ders Slaytları (Lesson Slides)

lesson-slides · içerik üretimi

gpt-4o

Mini sürümler 4-6 slaytta bitiriyor; içerik derinliği için tam GPT-4o.

Guardrail

›Min 8 slayt zorunluluğu
›Her slayta görsel/grafik etiketi
›Kazanım koduna kilitli outline

Türkçe NLP (yazım/morfoloji)

turkish-nlp · yardımcı

gemini-2.0-flash

Türkçe morfoloji + yazım denetimi. Zemberek/VNLP'den daha güncel; maliyet düşük.

Guardrail

›Token bütçesi sıkı
›Akademik karar etkisi yok

Flashcard / Mini Oyun / Video

yardımcı akışlar

gpt-4o-mini

Hız ve maliyet öncelikli; akademik karar etkisi düşük.

Guardrail

›Yanlış cevap kazanım ilerlemesine sayılmaz
›Validator opsiyonel

Veri ve Yönetim Politikaları

Veri minimizasyonu

Hiçbir LLM çağrısında öğrencinin adı, e-postası veya doğum tarihi gönderilmez. Soru içeriği + kazanım kodu + sınıf seviyesi yeterli.

Eğitim kullanımı yok

OpenAI ve Google API çağrılarında 'do not train' ayarları aktif. ÖğreTio öğrenci verisi modellerin eğitiminde kullanılmaz.

Türkiye veri yerleşimi

Veritabanı (kullanıcı + AILog) Türkiye veya AB bölgesinde tutulur. LLM çağrıları sırasında veri OpenAI/Google sunucularından geçer; bunlar şifreli kanaldan iletilir ve cache'lenmez.

Halüsinasyon ölçümü

Her ay /guven/halusinasyon-raporu sayfasında: cache hit oranı, validator yakalama oranı, kullanıcı flag oranı ve çözüm süresi yayınlanır.

İnsan denetimi

Pedagojik QA ekibi flag'lenen tüm cevapları 72 saat içinde inceler. Tekrarlayan hata kalıpları sistem promptlarına ek guardrail olarak eklenir.

Sürüm takibi

Model sürümü değiştiğinde (gpt-4o → gpt-4o-2026, vb.) bu sayfa güncellenir + AILog'a yeni sürüm bayrağı düşer. Kurumsal abonelere e-posta bildirimi gider.

Bilinen Sınırlar

Çok adımlı geometri/olasılık: 5+ adımlı çözümlerde hata oranı tek-adımlı sorulara göre 2.4× daha yüksek. Bu yüzden bu konularda öğretmen rolü Sokratik (vermeyen) modda kalır; doğrudan cevap yerine yönlendirme yapar.

Yeni format LGS soruları: ÖDSGM örnek havuzu güncel; ancak Mayıs 2026 LGS'sinde tamamen yeni bir format çıkarsa cache adaptasyonu 2-3 hafta sürer.

Görselli paragraf yorumu: Tablo/grafik içeren Türkçe paragraf yorumunda vision performansı düşük metinlere göre %8-12 daha zayıf.

Türkçe atasözü/deyim: Yöresel deyimlerde halüsinasyon riski. Bu kategori cache-zorunlu olarak işaretlendi.