İstem, bağlam, harness
Üç katman: ne söylüyorsun, model ne görüyor, etrafında ne kurulu?
Üç katman bir arada
Üçü birbirinin yerine geçmez, iç içe geçer. Bir katmana dokun, ne anlattığını gör.
Bir katman seç.
Dıştaki katman içindekini kapsar: harness bağlamı da, istemi de içinde taşır.
İstem (prompt)
Soru: Talimatı nasıl yazıp düzenlerim?
Anthropic'e göre istem mühendisliği, modele verilen talimatları en iyi sonuç için yazma ve düzenleme yöntemleridir [1].
Bu sitede: 1.1 İstem formülü (sahne, görev, kurallar).
Bağlam (context)
Soru: Modelin her adımda gördüğü bilgi kümesi ne olmalı?
Anthropic bağlamı, modelden cevap üretilirken kullanılan token'ların (bilgi parçalarının) kümesi olarak tanımlıyor. Bağlam mühendisliği, istemin dışında bu kümeye girebilecek her şeyi de seçip düzenlemektir: sistem talimatları, araçlar, MCP, dış veri, mesaj geçmişi [1].
Bağlam sınırlı bir kaynak: içindeki bilgi arttıkça modelin içinden doğru bilgiyi hatırlama başarısı düşebiliyor (Anthropic buna "context rot" diyor) [1].
Bu sitede: 1.9 Memory ve talimat, 3.8 Bağlam yönetimi.
Harness (koşum düzeneği)
Soru: Modeli uzun ve gerçek bir işte çalıştıran düzenek nasıl kurulu?
Anthropic, Claude Agent SDK'yı "genel amaçlı bir agent harness" diye anıyor: modelin araçlarla bilgi toplayıp plan yaptığı ve işi yaptığı düzenek; bağlam yönetimi (ör. sıkıştırma) da bunun parçası [2]. Uzun işlerde buna ilerleme notları, git geçmişi, özellik listesi ve test araçları ekleniyor [2].
"Harness engineering" adı yeni ve tanımı kaynaklar arasında değişiyor; bu bir standart değil, oturmakta olan bir terim.
Bu sitede: 3.5 CLAUDE.md, 4.2 Subagents, 4.4 Hooks, 4.5 Uzun oturumlar.
Bir bakışta
| Katman | Sorusu | Neyi ayarlarsın |
|---|---|---|
| İstem | Ne söylüyorum? | Talimatın yazılışı ve düzeni |
| Bağlam | Model ne görüyor? | Her adımda modelin önüne gelen bilgi kümesi |
| Harness | Etrafında ne kurulu? | Araçlar, bağlam yönetimi, oturumlar arası notlar, testler |
Harness neden gerekiyor: dört örnek
Anthropic uzun işlerde modelin dört şekilde tökezlediğini ve her birine bir düzenek parçasıyla çözüm bulduğunu anlatıyor [2]. Hiçbiri "daha iyi yazılmış istem" meselesi değil:
| Sorun | Düzenek çözümü |
|---|---|
| Model işin tamamını erken bitmiş ilan ediyor | Özellik listesi dosyası; her oturum listeden tek bir özellik seçer |
| Ortam hatalı ya da belgesiz bırakılıyor | Git deposu ve ilerleme notu; oturum başında okunur, sonunda commit ve not yazılır |
| Özellik test edilmeden "bitti" işaretleniyor | Yalnız dikkatli testten sonra "geçti" işareti; tarayıcı otomasyonuyla gerçek kullanıcı gibi test |
| Uygulamayı çalıştırmayı bulmak zaman alıyor | Geliştirme sunucusunu başlatan bir init.sh betiği |
"Eski mi, yeni mi?" Bazı paylaşımlar istem ve bağlam mühendisliğini "çöpe atılmış" gibi gösteriyor. Okuduğumuz kaynaklarda öyle değil: Anthropic bağlam mühendisliğini istem mühendisliğinin "doğal ilerlemesi" olarak görüyor [1]. Katmanlar birbirini içeriyor.
Sen için ne anlama geliyor?
Bu bölüm bizim yorumumuz, kaynaklı bir olgu değil:
- Günlük kullanıyorsan: asıl işin istem ve bağlam. Net yaz, gerekli bilgiyi ver (Projects, Memory).
- Claude'a kod yazdırıyorsan: düzeneği de kurarsın: CLAUDE.md, izinler, hooks, test komutları.
Kaynak
- [1] Anthropic, "Effective context engineering for AI agents": anthropic.com/engineering/effective-context-engineering-for-ai-agents
- [2] Anthropic, "Effective harnesses for long-running agents": anthropic.com/engineering/effective-harnesses-for-long-running-agents
Bilinmeyenler: "Harness engineering" için tek bir resmî tanım bulamadık; OpenAI'nin aynı adlı yazısına erişemedik (sayfa açılmadı), bu yüzden o yazıdan bir cümle kullanmadık. "Harness" için yerleşik bir Türkçe karşılık bulamadık; "koşum düzeneği" bizim geçici çevirimiz. Diyagramdaki örnek istem uydurmadır.
Son doğrulama: 2026-10-23