Modül 5 · Domain 4 — Eval & tuning (%15-20) · ⏱ 18 dakika

Domain 4 özeti — Başarı kriteri, otomatik tarama, root cause, tuning

Domain 4 — Success criteria, automated scanning, root cause, tuning

Bu derste neler öğreneceksin

  • Başarı kriteri ve eval sinyallerini (nicel + nitel) tanımlamak
  • CodeQL / secret scanning / dependency review'ı eval sinyali olarak kullanmak
  • Root cause üçlüsünü (reasoning / tool misuse / context-env) ezbere bilmek
  • Tuning kararını (instruction / tool izni / memory) doğru yere uygulamak

Ağırlık: %15-20 · Mock’ta ~9 soru. Kavramları biliyorsan rahat; GitHub-spesifik tarama araçları için extra çalışma şart.

1. Başarı kriteri ve eval sinyalleri

4 bullet:

  • Specify expected outcomes + operational constraints
  • Identify qualitative and quantitative signals
  • Align evaluation criteria with development intent
  • Generate evaluation signals by using automated scanning tools

Sinyal türleri

TürÖrnek
NicelTest pass rate, lint error count, CodeQL finding count, dependency vulnerability count
NitelCode review yorumları, kullanıcı feedback, “bu PR mantıklı mı” insan değerlendirmesi

İkisi birlikte kullanılır. Sadece nicel yeterli değil (test geçer ama mantık yanlış olabilir); sadece nitel ölçeklemez.

2. Otomatik tarama = eval sinyali (GitHub-spesifik)

GH-600’ün GitHub-yerli araçları:

AraçNe tararEval sinyali
CodeQLKod güvenlik açığıFinding count + severity
Secret scanningPush edilen secret’larSızıntı sayısı
Dependency reviewPR’daki yeni bağımlılık vulnerability’leriVulnerability count
Actions test/lint job’larıTest pass/fail, lint hataPass rate, error count

Bu çıktılar otomatik eval sinyali üretir — agent’ın çıktısı bu tarama’lardan geçmediyse iyi değil (kalite gate).

3. Root cause sınıflandırması — sınavın imza üçlüsü

Domain 4.2 birebir bullet: “Classify root causes, including reasoning errors, tool misuse, and context or environment issues”.

Üçlü kategori

KategoriTipik belirtiDüzeltme
Reasoning errorsYanlış mantık, hatalı plan, gereksiz adımInstructions revize (Domain 4.3)
Tool misuseYanlış parametre, yanlış API, yanlış tool seçimiTool izinleri daralt + tool seçimi netleştir
Context / environmentStaging ↔ prod farkı, missing secret, networkEnv constraint yapılandır + context refresh

Community pattern (jingchang0623): Reasoning hatası ilk akla gelen ama genelde değil. Tool misuse ve context issue’lar daha sık ve daha tehlikeli.

Logdan teşhis

Bakılacak artifact’lar (Domain 4.2 bullet’ı):

  • Workflow run logs
  • Agent plan dosyası (varsa)
  • Trace (tool çağrı zinciri)
  • Output
  • Workflow artifact’ları

❌ Geliştirici özel notları — paylaşılmaz, audit-uygun değil.

4. Tuning — kök nedene göre hedefli müdahale

Domain 4.3 üç bullet:

Kök nedenHedefli tuning
Reasoning errorCustom instructions / system prompt / workflow constraint revize
Tool misuseTool kullanımını + tool erişimini daralt; gerekirse tool kaldır
Context issueMemory scope’u daralt, environment constraint ayarla

Trap: Hata reasoning gibi gözüküyor diye direkt modeli değiştirmek. Doğru sıra: log’dan kategori tespit → ilgili tuning kanalını kullan.

Mini quiz — Domain 4 (3 soru)

GH-600'ün agent başarısızlıkları için tanımladığı üç ana kök neden kategorisi hangisidir?

GitHub'da agent çıktılarını otomatik değerlendirmek için kullanılan tarama araçları hangileridir? (En kapsamlı yanıt)

Aynı tool misuse hatası 3 farklı agent'ta tekrar ediyor. Sınavın önerdiği ilk müdahale nedir?

Sırada ne var?

Domain 5 — Multi-agent koordinasyon. Birden çok agent çalıştırırken isolation, çakışma çözümü, recovery pattern’leri ve lifecycle yönetimi.