Bağlam mühendisliği, bir dil modelinin bir görevin her adımında hangi bilgiyi, araçları ve belleği, hangi biçimde ve hangi sırayla göreceğine karar verme pratiğidir. İstem mühendisliği talimatı cilalar. Bağlam mühendisliği onun çevresindeki her şeyi tasarlar ve bu çevre malzemesi çoğunlukla cevabın doğru olup olmadığını belirler.
- Aynı modele aynı soruyu farklı bağlamla ver, farklı cevaplar alırsın. Aradaki fark genellikle ifadede değil, eksik bilgidedir.
- Bağlam sınırlı bir bütçedir. Anthropic, modellerin her ek token'ın tükettiği bir “dikkat bütçesi”ne sahip olduğunu anlatıyor.
- Konum önemlidir: araştırmalar, modellerin uzun bir girdinin başındaki ya da sonundaki bilgiyi, ortasındakinden daha iyi kullandığını buldu.
- Gerektiğinde malzemeyi getir ve tüm geçmişleri değil, kısa notları sonraki adıma taşı.
- İstem mühendisliği ölmedi. Bağlam mühendisliğinin bir katmanı.
- Bir yapay zeka oluşturucu kullanan herkes için bağlam mühendisliği, doğru dosyaları eklemek ve modelin tahmin edemeyeceği olguları söylemek demektir.
Bağlam mühendisliği nedir?
Bağlam mühendisliği, bir model görevi yürütürken görebildiği her şeyin bilinçli tasarımıdır. Bu, tek bir istemden çok daha fazlası. Talimatları, içeri alınan belgeleri, o ana kadarki konuşmayı, sunulan araçları, bu araçların döndürdüğü sonuçları ve önceki adımlardan taşınan notları kapsar. Hep birlikte modelin o andaki bütün dünyasını oluştururlar ve bu dünyanın sınırlarını çizen kişi sonucun büyük kısmına karar verir.
Bir destek asistanı katmanların nasıl birleştiğini gösterir. “Bu ayakkabıları hâlâ iade edebilir miyim?” sorusunu cevaplamak için asistanın sipariş sisteminden müşterinin sipariş tarihine, geçen yılın değil güncel iade politikasına, iadeyi başlatacak bir araca ve aynı müşterinin dün de sorduğuna dair bir nota ihtiyacı vardır. Soru altı sözcük. Doğru bir cevabı mümkün kılan bağlam ise geri kalan her şey.
Terim, modeller uzun, çok adımlı görevler yürütmeye başlayınca hızla yayıldı. Anthropic'in mühendislik ekibi bağlam mühendisliğine “istem mühendisliğinin doğal ilerleyişi” diyor ve onu, bir modelin çalıştığı “en uygun token kümesini seçme ve sürdürme stratejileri kümesi” olarak tanımlıyor; buna, istemin dışında bağlamına giren her şey dahil (Effective context engineering for AI agents, Eylül 2025, İngilizce; çeviri bize ait).
İstem yalnızca en görünür katman. Görünürlük etkiyle aynı şey değil. Sonucu çoğu zaman kullanıcının yazdığı cümleden çok, arkasına dizilen malzeme belirler.
Bağlam mühendisliği ile istem mühendisliği
İkisi birbirinin zıddı değil. İstem mühendisliği, bağlam mühendisliğinin talimat ifadesiyle ilgilenen parçası. Fark, emeğin nereye gittiği ve kalite düştüğünde neyin başarısız olduğu.
| Boyut | İstem mühendisliği | Bağlam mühendisliği |
|---|---|---|
| İş birimi | Tek bir talimat | Modelin bir görev boyunca gördüğü her şey |
| Çıktı yanlış olduğunda olağan çözüm | İsteği yeniden ifade etmek | Bilgi eklemek, çıkarmak ya da yeniden sıralamak |
| Başarısızlığın olağan nedeni | Belirsiz ifade | Eksik, eskimiş, gömülü ya da çelişen bilgi |
| Nasıl ölçeklenir | Her görev için yeniden yazılır | Yeniden kullanılabilir kaynaklar, şablonlar ve bellek |
| Ana beceriler | Açık yazım, örnekler, çıktı biçimi talimatları | Seçme, getirme, sıralama, özetleme, araç tasarımı |
| Kim yapar | Bir istek yazan herkes | Neyi ekleyeceğine, yapıştıracağına, getireceğine ya da hatırlayacağına karar veren herkes |
İnsanların kaçırdığı, son satır. Bağlam mühendisliği yapmak için ajan kurman gerekmez. Bir isteğe hangi dosyaları ekleyeceğine, önceki hangi e-postayı yapıştıracağına ya da hangi ayrıntıyı dışarıda bırakacağına her karar verişinde onu yapıyorsun.
Doğru bilgi neden doğru ifadeden üstündür?
İki kişi aynı modele aynı görevi veriyor. Biri belirsiz bir cevap alıyor, diğeri keskin bir cevap. Çoğu zaman fark, ifadede değil, modele çalışması için verilenlerde yatar.
Yapay zeka aracından bir menü sayfası isteyen bir kafe sahibini düşün. Birinci istek şöyle: “Kafem için güzel, modern bir menü sayfası yap.” İkinci istek güzellik hakkında daha az şey söylüyor ama güncel menüyü PDF olarak, fiyat listesini tablo olarak ve logoyu ekliyor, ardından şunu ilave ediyor: “Fiyatlar TL cinsinden; vegan yemekleri işaretle; pazar günleri 15.00'te kapanıyoruz.” İlk istek modeli yemekleri, fiyatları ve çalışma saatlerini icat etmeye zorlar. İkincisi ona tahmin edemeyeceği olguları verir. Birinci istekte ne kadar cila yapılırsa yapılsın o boşluğu kapatmaz.
İstemden bağlama geçişin ana dersi bu. Modeller talimatları anlamakta iyileşti; bu yüzden zekice ifade, sonucun giderek daha azını açıklıyor. Yapamadıkları şey, kimsenin vermediği olguları bilmek. Bir görevin ihtiyaç duyduğu bilgi mevcutsa düz bir cümle bile işe yarar. Eksikse, en zarif istem bile kendinden emin bir tahmin üretir. Niyet sadakati yazımız aynı boşluğa tarif tarafından bakıyor.
Daha fazla bağlam neden her zaman daha iyi değil?
Bilgi bu kadar önemliyse modele neden her şeyi vermeyelim? Çünkü bağlam bir depo gibi değil, bir bütçe gibi davranır.
Anthropic ekibi, bağlamın “azalan marjinal getirisi olan sonlu bir kaynak olarak ele alınması gerektiğini” ve modellerin bağlam büyüdükçe harcadıkları bir “dikkat bütçesi”ne sahip olduğunu yazıyor. “Bağlam çürümesi” (context rot) üzerine araştırmalara işaret ediyorlar: daha fazla token eklendikçe bir modelin tek bir bilgiyi hatırlama ve kullanma yeteneği düşme eğilimindedir.
Konum da önemli. Nelson F. Liu ve arkadaşları 2023'te yaptıkları bir çalışmada, dil modelinin “performansının genellikle ilgili bilgi girdi bağlamının başında ya da sonunda yer aldığında en yüksek olduğunu” ve model uzun bir bağlamın ortasına gömülü bilgiyi kullanmak zorunda kaldığında belirgin biçimde düştüğünü buldu (Lost in the Middle, İngilizce; çeviri bize ait). Buradan üç pratik kural çıkıyor:
- Seç, yığma. Adımın ihtiyaç duyduğunu ekle, duymadığını dışarıda bırak. Anthropic'in yol gösterici ilkesi, istenen sonucu olası kılan “mümkün olan en küçük, yüksek sinyalli token kümesini” bulmak.
- Kritik olguları okunacakları yere koy. Temel kısıtlar, uzun bir yapıştırmanın ortasında değil, başında ya da sonunda durmalı.
- Çelişkileri kaldır. Yeni bir fiyat listesinin yanındaki eski bir fiyat listesi, ikisinden de kötüdür; çünkü model hangisinin güncel olduğunu tahmin etmek zorunda kalır.
Eskimiş bağlam, aynı sorunun sessiz sürümü. Bir iç asistanın kaynakları arasında hâlâ geçen çeyreğin fiyat listesi varsa, soru ne kadar özenle ifade edilirse edilsin, bazen onu aktaracaktır. Kaynakları güncel tutmak, onları seçmek kadar işin bir parçasıdır.
Bir bağlamın yapı taşları
Parçaları adlandırmak yardımcı olur, çünkü her biri ayrı bir tasarım kararıdır.
- Talimatlar
- Rol, hedef, kısıtlar ve çıktı biçimi. İstem mühendisliğinin yaşadığı yer burası.
- Başvuru malzemesi
- Görevle ilgili belgeler, veri ve örnekler; ya baştan eklenir ya da gerektiğinde getirilir.
- Araçlar
- Modelin yapabileceği eylemler; her birinin ne zaman kullanılacağını söyleyen bir açıklaması vardır. Araç açıklamaları da bağlamdır; araç kullanan ajanlar yazısında ele alındı.
- Konuşma geçmişi
- Şimdiye kadar söylenenler. Süreklilik için yararlı, uzayıp terk edilmiş fikirlerle dolduğunda maliyetli.
- Çalışma belleği
- Bir adımdan ya da oturumdan diğerine taşınan notlar, kararlar ve özetler.
- Bağlam penceresi
- Yukarıdakilerin hepsinin tek bir adımda paylaşması gereken sınırlı alan.
Üç teknik zaman boyutunu yönetir. Tam zamanında getirme (just-in-time retrieval), dosya adları ya da arama sorguları gibi hafif başvuruları tutar ve asıl içeriği yalnızca bir adım ihtiyaç duyduğunda yükler. Sıkıştırma (compaction), uzun bir konuşmayı kısa bir özete indirir ve oradan devam eder. Yapılandırılmış not alma ise ajanın notları bağlam penceresinin dışına yazmasını ve sonra geri okumasını sağlar. Bunlar, oturumlar arası ajan belleğinin arkasındaki mekanikler.
Bağlam adım adım nasıl tasarlanır?
Bağlam tasarımı bir yığın değil, bir dizidir. Sıra bozulduğunda iyi bilgi bile yanlış anda gelir ve değerini yitirir.
- Görevin neye ihtiyaç duyduğunu adlandır. Yetkin bir kişinin onu yapmak için ihtiyaç duyacağı olguları, kararları ve kısıtları yaz. Kötü tanımlanmış bir ihtiyaç hep yanlış bağlamı getirir.
- Kaynakları topla. Her birinin güncel sürümünü bul: son fiyat listesi, gerçek çalışma saatleri, onaylı logo.
- Göreve hizmet etmeyeni kes. Eskimiş, tekrarlanan ve yalnızca ilginç olan malzemeyi çıkar.
- Sırala. Hedefi ve sert kısıtları başa, destekleyici malzemeyi sonraya koy; bağlam uzunsa en önemli tek kısıtı sonda tekrarla.
- Neyin sonra getirileceğine karar ver. Büyük ya da nadiren gereken malzeme, bir adım isteyene kadar pencerenin dışında kalabilir.
- Döküm değil, özet taşı. Adımlar ya da oturumlar arasında, her mesajı değil, alınan kararları ve açık soruları aktar.
- Çıktıyı kaynaklara karşı kontrol et. Bir şey yanlış olduğunda önce modelin neyi eksik bildiğini, ancak sonra isteğin nasıl ifade edildiğini sor.
Yedinci adım, alışkanlığın değiştiği yer. İstem öncelikli refleks cümleyi yeniden yazar; bağlam öncelikli refleks girdileri kontrol eder. Birinci adımda ihtiyaçları yazmak da doğal olarak, bakımı yapılan bir tarifin en yeniden kullanılabilir bağlam olduğu spec odaklı geliştirmeye çıkar.
İstem mühendisliği öldü mü?
Soru sık geliyor ve dürüst cevap hayır. İstem yazımı daha geniş bir disiplinin içindeki tek bir beceri hâline geldi. Açık bir talimat hâlâ önemli, çünkü modele elindeki bağlamla ne yapacağını söylüyor. Artık tek başına yetmiyor ve zayıf bir sonucu düzelten kaldıraç da nadiren o oluyor.
İstemde hâlâ yeri olanlar, neyin doğru olduğunu değil, ne istediğini anlatan her şey: hedef tek cümlede, hedef kitle, sert kısıtlar, çıktı biçimi ve iyi bir sonucun bir iki örneği. Hiçbir getirme sistemi bunları senin yerine sağlayamaz.
Değişen, zorluğun nerede durduğu. Modeller düz talimatları izlemekte iyileştikçe ifade kolaylaşıyor ve zor kısım neyi ne zaman göstereceğine karar vermeye kayıyor. İyi istem yazan biri artık hangi belgeleri ekleyeceğini, hangi geçmişi tutacağını ve hangi ayrıntıları keseceğini de bilmeli. İki beceri tek bir işte birleşti.
Bir dayanıklılık argümanı da var. Parlak bir istem, görüldüğünde kopyalanması kolay. Güncel kaynaklar, net şartnameler ve derli toplu notlarla iyi tutulmuş bir bağlam bütünü ise kopyalanması zor ve yüzlerce görev boyunca karşılığını vermeyi sürdürür. Kalıcı kalite genellikle buradan gelir.
Bağlam mühendisliğini WisyLink ile işe koş
WisyLink ile üretirken, adına öyle desen de demesen de bağlam mühendisliği yapıyorsun. Bir sohbette bir web sitesini ya da web uygulamasını anlatırsın; oluşturma ajanı bu bağlamı kendi adresinde canlı bir uygulamaya dönüştürür. Ona verdiklerinin kalitesi sonuçta görünür.
- Olguları ekle. Bir mesaja görseller, PDF'ler, Word belgeleri, tablolar, CSV ve JSON dahil, her biri 25 MB'a kadar başvuru dosyaları ekleyebilirsin. Bir menü PDF'i, bir fiyat listesi ya da markanın bir ekran görüntüsü, bir paragraf tarifi geride bırakır.
- Modelin tahmin edemeyeceğini söyle. Hedef kitle, sayfalar, hangi özelliklerin hesap ya da ödeme gerektirdiği, çalışma saatleri, para birimi ve ton.
- Görünümü anlatmak yerine göster. Kendi marka malzemelerinin ekran görüntüleri, sıfat listesinden daha hızlı stil belirler.
- Wisy'nin sormasına izin ver. Makul biçimde seçemeyeceği bir ayrıntı eksikse, asistan Wisy bunu her turda tek bir kısa soruyla sana sorar. Daha küçük ayrıntılara kendisi karar verir.
- Uygulama başına tek bir konuşma tut. Aynı sohbetteki devam değişiklikleri öncekinin üzerine kurulur. Kesin ol: sayfayı, öğeyi ve değişikliği adlandır.
Yapay zeka ile site yapma promptları yazımız bunu kopyala-yapıştır başlangıç noktalarına çeviriyor, yetenekler sayfası da bir oluşturmanın neleri içerebileceğini gösteriyor. Bağlamın hazır olduğunda ücretsiz başla, dosyalarını ekleyerek tek ve eksiksiz bir ilk mesaj gönder ve paylaşmadan önce sonucu test et.
S.S.S.