OĞUZ EROLADS & AI

Harness Nedir? Yapay Zeka Ajanlarında Koşum Takımı

3 dk okuma20 Ağustos 2026

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şımHarness’ı kim yazıyorNerede çalışıyor
Döngüyü elle yazmakSizSizin sunucunuz
SDK’nın araç koşucusuKütüphaneSizin sunucunuz
Claude Agent SDKKütüphane (hazır araçlarla)Sizin sunucunuz
Yönetilen ajanlarSağ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.