Terim

AI ajan harness'i nedir: tanımı ve bileşenleri

Güncellendi: · Skillaria.Top

AI ajanın harness'i, dil modelini ajanın içinde çalışan bir araca dönüştüren her şeydir: talimatlar, araçlar, çalıştırma ortamı, oturumlar arası durum ve geri bildirim döngüleri. Ajan = Model + Harness: model akıl yürütür, harness ona kurallar, eller, hafıza ve sonucu kontrol etme imkanı verir.

Tanım

AI ajanın harness'i (agent harness), dil modelinin etrafındaki yazılım yapısıdır: modelin kendisi olmayan ama ajanın çalışma biçimini etkileyen her şey. Formül şudur: Ajan = Model + Harness. Model akıl yürütmeyi ve kod yazmayı bilir, ama harness modelin neyi gördüğünü, neyle eylemde bulunabileceğini, komutların nerede çalışacağını, oturumlar arasında neyin kalacağını ve ajanın kendi hatalarını nasıl öğreneceğini belirler.

Harness'in beş bileşeni

  • Talimatlar — sistem prompt'u ve CLAUDE.md ile AGENTS.md gibi proje dosyaları, konu belgeleri ve skills.
  • Araçlar — shell'de komut çalıştırma, dosya düzenleme, tarayıcı, MCP üzerinden bağlantılar.
  • Ortam — ajanın kodu üretimi tehlikeye atmadan çalıştırdığı sandbox veya container.
  • Durum — plan ve ilerleme dosyaları, git geçmişi: oturum kapansa bile kalan hafıza.
  • Geri bildirim — ajana hata sinyali veren testler, linter'lar, tip kontrolü ve hook'lar.

Harness yalnızca tek bir prompt dosyası değildir. Ajanın testlere erişimi yoksa veya ortam hiç açılmıyorsa, uzun bir AGENTS.md de yardımcı olmaz. Güvenilirliği beş bileşenden en zayıf olanı belirler.

Örnek

Ajan üst üste üçüncü oturumda aynı hatayı düzeltmeye çalışıyor: her yeniden başlatmadan sonra daha önce neyi denediğini hatırlamıyor. İlk akla gelen, sorunun modelde olduğudur. Oysa bozuk olan durum bileşenidir. Çözüm, ajanın oturum sonunda işe yaramayan hipotezleri ve sonraki adımı yazdığı bir PROGRESS.md dosyasıdır:

## Hata: aynı isteğin tekrarında çift tahsilat
Kontrol edildi ve elendi:
- HTTP istemcisinin zaman aşımı — etkisi yok
- webhook işleyicisinde yarış durumu — yeniden üretilemedi
Sonraki adım: payments/service.py içinde idempotency anahtarını kontrol et

Yeni oturum dosyayı okur ve tam kaldığı yerden devam eder. Model değişmedi, harness değişti.

Özet

AI ajanın harness'i, modelin etrafındaki talimatlar, araçlar, ortam, durum ve geri bildirimin bütünüdür. Aynı ajanın güvenilir çalışıp çalışmayacağını ya da bozulacağını belirleyen şey budur. Her bileşenin nasıl kurulacağı, gerçek bir proje üzerinde uygulamalı bir kursta gösterilmektedir.

Sık sorulan sorular

Harness ile ajan framework'ü arasındaki fark nedir?

Framework, ajanın üzerine inşa edildiği bir kütüphanedir. Harness ise projeniz için modelin etrafındaki somut yapılandırmadır: kurallar, erişimler, ortam, testler ve durum dosyaları. Claude Code gibi hazır bir ajanda temel bir harness zaten vardır ve siz bunu genişletirsiniz.

Harness ve prompt aynı şey mi?

Hayır. Prompt, talimatlar bileşeninin yalnızca bir parçasıdır. Harness ise araçları, ortamı, oturumlar arası hafızayı ve sonuç doğrulamasını da içerir.

Harness'in hangi bileşeninden başlamalıyım?

Geri bildirimden. Ajana, kendi işini kontrol edebileceği komutlar verin. Bu, insana ulaşan hataları en hızlı azaltan yöntemdir.

Bu konuyu videoyla öğrenin

Bu konu “Harness Engineering: AI Ajanları İçin Güvenilirlik Mühendisliği” kursunda uygulamalı olarak ayrıntılı işleniyor.

Kursa git