Sade anlatım
Tek başına model, test tezgâhındaki bir motordur: güçlüdür ama hiçbir yere gitmez. Harness arabanın geri kalanıdır: gücü harekete çeviren şanzıman, direksiyon, frenler, gösterge paneli. Bir ajan dosya okuduğunda, bir şeyi silmeden önce onay istediğinde ya da elli adımdan sonra durduğunda iş başındaki harness'tir. Model yalnızca sıradaki hamleyi önerir; hamleyi gerçekleştiren ya da geri çeviren harness'tir.
Neden önemli
Aynı modelin üzerine kurulu iki ürün; bitirdiği iş, maliyeti ve güvenliği bakımından birbirinden çok farklı olabilir. Farkı yaratan harness'tir. Bir ajan satın aldığınızda model kadar bir harness de satın alırsınız; risk ekibinin sorduğu kontrollerin, yani yetkilerin, sandbox'ın, onayların ve kayıtların hepsi oradadır. Bağımlılık da en çok burada oluşur: modeli değiştirmek çoğu zaman bir ayardır, harness'i değiştirmek ise bir geçiş projesidir. İki sınırı vardır: harness zayıf bir modeli kurtaramaz ve geçen yılın modelini desteklemek için yazılan mantık bu yılın modeline ayak bağı olabilir.
Örnek
Bir yazılım şirketi, aynı modeli kullanan iki kodlama ajanını kendi 60 bakım görevinde deniyor. Biri 31 görevi tamamlıyor, öteki 44'ünü. İkinci harness modele bir kod arama aracı veriyor, eskimiş araç çıktılarını bağlamdan temizliyor, her düzenlemeden sonra testleri çalıştırıyor ve dosya silmeden önce soruyor. Model aynı; 13 görev daha bitmiş, geri getirilmesi gereken silinmiş dosya da yok.
Bununla en çok karıştırılan kavram
Agent Harness ve Model arasındaki fark
İnsanlar “model dosyayı sildi” ya da “model hatırladı” der. Model bir istek yazmıştır; isteği yerine getiren de eski notları yeniden bağlama koyan da harness'tir. Ayrım, bir şey ters gittiğinde ve ürünler karşılaştırılırken önem kazanır: bir benchmark puanı ya da bir hata, modelle harness'e birlikte aittir. Bu yüzden ikisinden hangisinin değişmesi gerektiğini sorun.
Teknik katman
Harness altı iş yapar. Her turda sistem isteminden, araç tanımlarından, geçmişten ve bellek dosyalarından istemi derler. Ajan döngüsünü ve durma kurallarını yürütür. Araç çağrılarını ayrıştırıp çoğu zaman paralel çalıştırır, hataları ve yeniden denemeleri yönetir. Bağlamı compaction, eski araç sonuçlarının temizlenmesi ve alt ajanlarla yönetir. Güvenliği uygular: yetki modları, onay istemleri, sandbox içinde dosya ve ağ erişimi. Bir çalışmanın duraklatılabilmesi, sürdürülebilmesi ve izlenebilmesi için durumu saklar. Hazır harness'ler SDK olarak sunulur; Claude Agent SDK ve OpenAI Agents SDK bunlar arasındadır. LangGraph, kendi harness'ini kurmak isteyenler için bir geliştirme çatısıdır (framework); Claude Code ve Codex gibi kodlama araçları ise kullanıcı arayüzü olan harness'lerdir. Değerlendirme çalışmalarında aynı katmana scaffold denir. Modeller geliştikçe harness'ler incelir: eskiden kod gerektiren adımlar modele bırakılır, kalan kod araçlarda, yetkilerde ve durumda yoğunlaşır.