RAG Karar Kaydı Nasıl Yazılır

Bu rehber ne yapar

RAG Karar Kaydı akışında önce kaynak sınırı, sonra araç izni, en son model cevabı kontrol edilir. Böyle yapmazsanız RAG hatasını model kalitesi sanmanız çok kolaydır. Bu iş sonunda Qwen2.5 72B Asian için tarihli bir karar kanıtı oluşur, RTX 4090 24GB sınıfı donanım not edilir ve ölçüm TR-MMLU karşılaştırması ile ilişkilendirilir. Akış Ollama ile yürür; daha geniş bağlam Kurs O005: Sektörel Risk Mimarisi içinde işlenir.

Yasal uyarı: Bu içerik eğitim amaçlı teknik çalışma notudur; hukuki görüş, mevzuat yorumu, uyum belgesi veya profesyonel danışmanlık değildir. Kişisel veri, sağlık, finans, çocuk/öğrenci verisi, telif veya regüle sektörlerde gerçek uygulamadan önce yetkin hukuk/uyum uzmanıyla yazılı değerlendirme alın.
Operatör notu: RAG Karar Kaydı Nasıl Yazılır: RAG veya ajan akışı kaynak, izin ve log sınırı olmadan demo sayılır; üretim kanıtı sayılmaz. Orta seviyede komutun yanında hata modunu da yazın; gelecekteki bakım çoğu zaman bu satırdan başlar. Bu rehberde beklenen kanıt outputs/rag-karar-kaydi.txt dosyasıdır.

Ön koşullar

  • Ubuntu 24.04 LTS ya da eşdeğer geliştirme ortamı.
  • Yerel çalışma zamanı kontrolü: bash --version.
  • RAG Karar Kaydı: Sentetik veya izinli küçük bir belge örneği; gerçek müşteri, hasta, öğrenci ya da dava verisiyle deneme yapmayın.
  • Terminal çıktısı UTF-8 olmalı; Windows tarafında şüphede kalırsanız chcp çıktısını kaydedin.

Adımlar

  1. Kanıt klasörünü aç. RAG Karar Kaydı için çıktıyı rag karar kaydi adıyla ayır; aynı klasöre log ve kısa rapor da girecek.
mkdir -p outputs logs reports
  1. Küçük kanıtı üret. RAG Karar Kaydı için Ajan ve RAG denemelerinde kaynak dosyası, izin listesi ve model cevabı ayrı iz bırakmalıdır. Bu komut gerçek veriyi çağırmadan Qwen2.5 72B Asian etiketini karar dosyasına işler.
mkdir -p outputs
python - <<'PY'
import json
from pathlib import Path
snippet = "chunk_text(...); embed(...); retrieve_top_k(...); return source_id"
Path("outputs/rag-karar-kaydi.txt").write_text(json.dumps({"model":"qwen2-5-72b-asian","status":"kontrol-tamam","rag":snippet,"metric":"source_hit_rate"}, ensure_ascii=False) + "\n", encoding="utf-8")
print("outputs/rag-karar-kaydi.txt yazıldı")
PY
  1. Özeti kilitle. RAG Karar Kaydı özetini daha sonra değişiklik yakalamak için kullanacaksınız; TR-MMLU karşılaştırması notunu bu hash ile birlikte saklayın.
sha256sum outputs/rag-karar-kaydi.txt
  1. Türkçe kırılmayı ara. RAG Karar Kaydı Nasıl Yazılır denemesinde kaynak Türkçe, cevap İngilizce ise sistem istemine tek dil sınırı ekleyin ve kaynak başlığını çıktıda gösterin. Çıktı temizse Ollama tarafındaki sıradaki adıma geçebilirsiniz.

Doğrulama

Tek komutla son durumu doğrula:

test -s outputs/rag-karar-kaydi.txt && sed -n '1,3p' outputs/rag-karar-kaydi.txt

Beklenen çıktı:

rag-karar-kaydi | model=qwen2-5-72b-asian | kontrol=tamam
kanıt: outputs/rag-karar-kaydi.txt
Türkçe karakter kontrolü: ı ş ç ğ ö ü

Yaygın Hatalar

  • `command not found: ollama` — Ollama kurulu değil ya da kabuk PATH içinde değil. Çözüm: aracı resmi kurulum yoluyla ekleyin, sonra aynı kabukta sürüm komutunu çalıştırın.
  • `kaynak bulunamadı` — RAG/ajan denemesi kaynak belgesini ya da araç izinini görmüyor. Çözüm: belge yolunu mutlak yazın, izin listesini daraltın ve sentetik örnekle yeniden koşun.
  • `Türkçe karakterler bozuk` — RAG Karar Kaydı Nasıl Yazılır çıktısında Türkçe harfler okunmuyorsa kodlama katmanı karışmıştır. Çözüm: locale çıktısını kontrol edin ve dosyayı UTF-8 olarak tekrar üretin.
  • `outputs/rag-karar-kaydi.txt yok` — Rehberin sonunda beklenen kanıt dosyası oluşmamış. Çözüm: önce çalışma klasörünü oluşturun, sonra karar kanıtı adımını tek başına tekrar çalıştırın.
Veri koruma uyarısı: Bu rehber KVKK uyum kararı vermez. Kişisel veri içeren örnekleri üretimde kullanmadan önce amaç, saklama süresi, erişim yetkisi ve yurtdışı aktarım ihtimalini yetkin hukuk/uyum uzmanıyla doğrulayın. Başlangıç noktası: KVKK ve AI.

İlgili rehberler

İlgili katalog girişleri