AI Ajan Harness'ı Neyden Oluşur: Talimatlar, Araçlar, Ortam, Durum, Geri Bildirim
Beş harness engineering alt sistemi: talimatlar (AGENTS.md), araçlar, ortam, durum ve geri bildirim döngüleri. Uygulama sırası, sabit modelde her bileşenin değerinin ablasyon ölçümü ve alt sistemler arası akış şeması.
- Kendi harness'ınızı beş alt sisteme ayırır ve eksik olanını tespit edersiniz.
- Belirli bir bileşenin katkısını göz kararıyla değil, ablasyon deneyiyle ölçmeyi öğrenirsiniz.
- Getiri eğrisine dayanarak önceliklendirilmiş bir uygulama planı oluşturursunuz.
课程开头
«Sadece prompt'u biraz daha uzun yazın»
- Ekip bir hafta boyunca beş sayfalık bir AGENTS.md yazıyor
- Ajan hâlâ testleri kendi kendine çalıştırmıyor
- Her oturum ortamı onarmakla başlıyor
- Sorun modelde gibi görünüyor — ama asıl suçlu o değil
Ekip şöyle karar veriyor: ajan hata yapıyorsa her şeyi daha ayrıntılı anlatmalıyız — beş sayfalık bir talimat yazıyorlar; kütüphaneleri, ses tonunu, ekip liderinin sevdiği kod pattern'lerini sıralıyorlar. Ajan bunu bir kez okuyor ama yine de commit öncesinde linter'ı çalıştırmıyor; çünkü onu fiilen çalıştırması mümkün değil — gerekli yetkilere sahip bir shell erişimi yok. Sorun prompt'un uzunluğunda değil. Sorun şu: talimatlar, harness'ın beş alt sisteminden yalnızca biri; diğer dördü yerli yerine oturmamışsa hiçbir metin işe yaramaz.
Mit: harness = bir prompt dosyası
- 🤔 Mit / Sık karıştırılan: «bende harness var» = «bende bir prompt dosyası var»
- ✅ Aslında: harness beş farklı alt sistemdir; talimatlar bunlardan yalnızca biridir
- 📌 Akılda kalsın: tarif rafı henüz mutfak değildir
«Bende harness var» cümlesi neredeyse her zaman «bende bir prompt dosyası var» anlamına gelir — bir AGENTS.md ya da CLAUDE.md. Ama bu harness değildir; tıpkı malzemeyle dolu bir buzdolabının henüz bir lokanta olmaması gibi. Malzeme vardır ama ocak yoktur, bıçaklar yoktur, yemeği kontrol etme yöntemi yoktur, kalite kontrol sistemi yoktur. Tam teşekküllü bir harness, birlikte çalışan beş parçadır; herhangi birinin eksikliği «biraz daha kötü» demek değildir — tekrar tekrar karşımıza çıkacak ayrı ve öngörülebilir bir başarısızlık türüdür.
Beş istasyonlu mutfak
- Harness = birlikte çalışan beş alt sistem
- Atlanan bir parça «biraz daha kötü» değil, sistematik bir başarısızlıktır
- Devamında: bu mutfağın istasyonlarını tek tek inceliyoruz
Profesyonel bir mutfaktan yalnızca tek bir istasyonu kaldırın: mutfak ya hiç açılmaz ya da müşterilerini şansa bırakarak doyurmaya çalışır. Mutfakta beş istasyon vardır: tarif rafı, bıçak standı, ocak, hazırlık tezgâhı ve kalite kontrol penceresi. Harness'ta da durum aynıdır: talimatlar, araçlar, ortam, durum ve geri bildirim yalnızca birlikte çalışır; bir istasyonun zayıflığını diğerinin gücü telafi etmez.
课程内容
- «Sadece prompt'u biraz daha uzun yazın»
- Mit: harness = bir prompt dosyası
- Beş istasyonlu mutfak
- İstasyon 1–2: Talimatlar ve araçlar
- İstasyon 3–4: Ortam ve durum
- İstasyon 5: Geri bildirim — kalite kontrol penceresi
- Nereden başlanmalı: 5 → 1 → 4 → 3 → 2
- ❓ Kontrol molası: hangi istasyon sizde en zayıf?
- 💡 Teşhis: neyin bozuk olduğunu nasıl anlarsınız?
- Neden farklı ekipler aynı yoldan geçiyor?
- 🛠 Gerçek ekiplerde bu nasıl görünüyor?
- Bir bileşenin değerini nasıl ölçersiniz?
- Sıfır düşüş ≠ 'bileşen gereksiz'
- Ablasyonun tuzakları: işe onunla başlamayın
- Sınır koymak, mikromenajman değil
- Ders kitabı değil, harita
- Harness de kod gibi çürür
- Tek bir bağı koparırsanız ajanın işi nereye akar
- Şema liste gibi değil, döngü gibi okunur
- Harness'inizin en zayıf halkası için 30 dakika
- Sırada: ödeme backend'i için ilk AGENTS.md
- Harness bir dosya değil, bir döngüdür
本课时相关文章
- 什么是 harness engineering:让 AI 智能体成为可靠的工作工具
- Harness 与上下文工程:Harness 工程和提示词、上下文工程有什么区别
- 智能体 Harness 是什么:定义与组成部分
- 智能体 Harness 速查表:组件、文件、常见问题与启动清单
- Harness 工程面试题:22 道题及参考答案(AI 工程师)
本课程全部课程
- Harness Engineering Nedir? AI Kodlama Ajanı Modelden Değil, Ortamdan Neden Çöker
- AI Ajanında Hata Birikimi: Adım Başına %95 Doğruluk Neden 10. Adımda Başarısız Olur
- AI Ajan Güvenilirlik Metrikleri: MTBF, MTTR, Patlama Yarıçapı ve Little Yasası
- AI Ajanı Üretimde Neden Çöker: Beş Hata Katmanı ve Teşhis Döngüsü
- AI Ajan Harness'ı Neyden Oluşur: Talimatlar, Araçlar, Ortam, Durum, Geri Bildirim
- AI Kodlama Ajanları İçin Depo Haritası: Oturumlar Arası Hafızasız Proje Yapısı
- AGENTS.md En İyi Uygulamaları: Dev Talimat Dosyası Neden Çalışmaz, Yönlendirici Nasıl Kurulur
- AI Ajanı Oturumlar Arası Hafıza: Oturum Devri, PROGRESS.md ve Başlangıç Sözleşmesi
- AI Ajanları İçin feature_list.json: WIP=1, Özellik Durumları ve verify.sh Doğrulaması
- Ajan 'Hazır' Dedi, Özellik Çalışmıyor: Doğrulama Boşluğu ve Definition of Done
- Tüm Testler Yeşil, Özellik Bozuk: AI Ajanları İçin E2E Testler ve Mimari Kurallar
- AI Ajanı Gözlemlenebilirliği: Sprint Sözleşmesi, Değerlendirici Rubriği ve Temiz Oturum Çıkışı
- AI Ajanını Saatlerce Denetimsiz Çalıştırmak: Loop Engineering ve Durdurma Koşulları
- AI Ajanları İçin Graph Engineering: Tek Döngü Yetmediğinde Görev Grafiği
- AI Ajan Harness'ını Sıfırdan Kurmak: AGENTS.md, feature_list.json, verify.sh ve Otonom Döngü