Harness Nedir? Yapay Zeka Ajanlarında Koşum Takımı
Yapay zeka ajanlarından söz edilirken hep model konuşuluyor: hangisi daha akıllı, hangisi daha ucuz. Oysa aynı modelle kurulmuş iki ajandan biri işi bitirirken diğeri yarıda bırakabiliyor. Aradaki farkın adı harness.
Türkçesi tam oturmuyor; en yakını koşum takımı. At güçlüdür ama arabayı çeken şey koşum takımıdır — hangi yöne gideceğini, yükün nasıl bağlandığını, ne zaman duracağını o belirler. Harness de modelin etrafındaki o düzenek.
Harness ne yapıyor
Üç işi var:
Bağlamı yönetiyor. Uzun bir görevde her adımın çıktısı birikiyor ve model bir noktada kendi bağlam penceresini dolduruyor. Harness neyin hatırlanacağına, neyin özetleneceğine, neyin atılacağına karar veriyor.
Araçları yönetiyor. Modelin hangi anda neye erişebileceğini belirliyor: dosya okuma, komut çalıştırma, web araması, veritabanı sorgusu. Her aracı her an açık bırakmak iyi fikir değil.
Döngüyü yönetiyor. “Model cevap verdi, araç çağırdı, sonucu aldı, tekrar düşündü” döngüsünü kim sürdürüyor? Ne zaman duracak, ne zaman işi bir alt ajana devredecek? Bunu harness kuruyor.
Neden önemli — üç tipik başarısızlık
Anthropic’in kendi mühendislik yazısında, tek bağlamda çalışan ajanlarda tekrarlayan üç hata tarif ediliyor. Üçünü de sahada gördüm:
Ajan tembelliği. Model işi bitirmeden “tamam, hallettim” diyor. Görevin yarısı yapılmış, raporda tamam yazıyor.
Kendini kayırma. Model kendi ürettiği çıktıyı denetlemesi istendiğinde onaylıyor. Kendi yazdığı metni kendisi kontrol edince hata bulma oranı düşüyor.
Hedeften sapma. Uzun görevlerde ilk talimat sulanıyor; on adım sonra model başka bir şey optimize ediyor.
Bu üçü modelin zayıflığı değil, düzeneğin zayıflığı. Çözüm de modelde değil harness’ta: denetimi ayrı bir ajana yaptırmak, alt görevleri temiz bağlamlarla ayırmak, hedefi her turda yeniden hatırlatmak.
Harness’ı kim sağlıyor
Pratikte dört seçenek var ve fark, koşum takımını ve sunucuyu kimin verdiğinde:
| Yaklaşım | Harness’ı kim yazıyor | Nerede çalışıyor |
|---|---|---|
| Döngüyü elle yazmak | Siz | Sizin sunucunuz |
| SDK’nın araç koşucusu | Kütüphane | Sizin sunucunuz |
| Claude Agent SDK | Kütüphane (hazır araçlarla) | Sizin sunucunuz |
| Yönetilen ajanlar | Sağlayıcı | Sağlayıcının sunucusu |
Karışan nokta şu: bir kütüphanenin harness vermesi, barındırmayı da üstlendiği anlamına gelmiyor. İlk üçünde sunucu yine sizin.
Pratik anlamı
Bir ajan projesinde sonuç alamıyorsanız ilk refleks daha güçlü modele geçmek oluyor. Çoğu zaman sorun orada değil: görev tek bağlamda çok uzun, araçlar gereğinden geniş, denetim adımı yok.
Çoklu ajan sistemleri tam olarak bu yüzden var — işi bölmek modeli değiştirmekten daha çok işe yarıyor. Kendi kurulumumda kullandığım yapıyı agentic yığınım yazısında anlattım.
Sıkça Sorulan Sorular
Harness ile model aynı şey mi?
Değil. Model beyin, harness onu işe koşan düzenek. Aynı modeli farklı harness’la çalıştırırsanız sonuç belirgin şekilde değişiyor.
Harness ile framework aynı şey mi?
Yakın ama aynı değil. Framework genel bir yazılım iskeleti; harness özel olarak ajan döngüsünü, bağlamı ve araç erişimini yöneten katman.
Kendi harness’ımı yazmalı mıyım?
Çoğu iş için gerek yok — hazır olanlar döngüyü zaten kuruyor. Kendi kurgunuz gerekiyorsa (özel onay adımları, farklı sırayla çalışan alt ajanlar) o zaman yazmak mantıklı.
Bu benim işime nasıl dokunuyor?
Doğrudan dokunmuyorsa bilmenize gerek de yok. Ama “AI ajanı kuralım” diye teklif alıyorsanız, teklifin harness tarafında ne söylediğine bakın: denetim, bağlam yönetimi ve durma koşulu yazmıyorsa o teklif eksik.
RAG ile ilişkisi var mı?
Farklı katmanlar. RAG modele doğru bilgiyi getirmekle ilgili; harness modelin o bilgiyle ne yapacağını yönetmekle.