Harness engineering: güvenilir bir yapay zeka ajanı nasıl kurulur
Makale: 8
Harness engineering (harness mühendisliği), bir dil modelinin etrafında yapay zeka ajanının gerçek işi güvenilir biçimde yapabileceği bir ortam kurma disiplinidir. Konunun formülü: Ajan = Model + Harness. Aynı model bir projede deneyimli bir geliştirici gibi çalışırken başka bir projede bağlamı kaybeder ve çalışmayan bir özelliği "hazır" diye bildirir. Farkın neredeyse her zaman sebebi harness'tir, modelin kendisi değil.
Bu rehber konunun bir haritasıdır. Temel kavramları ve bunları öğrenmenin sırasını bir arada toplar. Her konu ayrı bir makalede ayrıntılı olarak ele alınmıştır.
Harness'in beş bileşeni
- Talimatlar — CLAUDE.md ve AGENTS.md dosyaları, konu belgeleri ve skills: ajanın projeyi hakkında bildikleri.
- Araçlar — shell, dosya düzenleme, tarayıcı, MCP sunucuları: ajanın nasıl eylemde bulunduğu.
- Ortam — sandbox, container, izole çalışma kopyası: ajanın komutları nerede çalıştırdığı.
- Durum — plan ve ilerleme dosyaları, git geçmişi: oturumlar arasındaki hafıza.
- Geri bildirim — testler, linter'lar, hook'lar, bağımsız denetleyici: ajanın kendi hatalarını nasıl öğrendiği.
Bu bileşenler kapalı bir döngü oluşturur. Herhangi birini çıkarırsanız döngü kopar: kontrol yoksa ajan hataları görmez, durum yoksa her oturum sıfırdan başlar.
Nereden başlamalı
Konu yeniyse, harness engineering'in ne olduğunu ve prompt ile context engineering'den nasıl ayrıldığını anlatan makaleyle başlayın. Kısa tanım ve örnek, ajan harness'i makalesindedir.
Ardından pratik kısma geçin. Herkesin karşılaştığı ilk dosya proje talimatlarıdır: CLAUDE.md ve AGENTS.md'ye ne yazılmalı, neyin yazılmamalı ve ajan dosyada açıkça yazılı bir kuralı neden görmezden gelir.
Ajan projede zaten çalışıyorsa güvenilirlik sorusu gündeme gelir. Adım adım plan, hata günlüğü ve MTBF ile MTTR metriklerinden başlar; ucuz geri alma, geri bildirim döngüleri ve dosyalardaki hafızadan geçerek ajanın saatlerce gözetimsiz çalıştığı özerk döngüye ulaşır.
Temel ilkeler
- Ajan bozuk değildir, ortam bozuktur. Önce harness'teki açığı arayın, modeli değiştirmeyin.
- Geri bildirimle başlayın: tek bir kontrol komutu, talimat sayfasının tamamından daha değerlidir.
- Talimatlar bir haritadır, ders kitabı değil: kısa bir giriş dosyası ve ihtiyaç halinde açılan ayrıntılar.
- Önemli şeyler context penceresinde değil, dosyalarda yaşar.
- Ölçün: hislere değil, bir hata günlüğüne dayanın.
Beş bileşenin ve harness'in bütününün nasıl kurulacağı, tek bir proje üzerinden uygulamalı bir kursta ele alınmıştır.