Sehemu ya muhadhara

Tüm Testler Yeşil, Özellik Bozuk: AI Ajanları İçin E2E Testler ve Mimari Kurallar

AI ajanıyla çalışırken birim testlerinin kör noktaları: testler geçer, özellik uçtan uca çalışmaz. E2E testler, mimari kuralların çalıştırılabilir kontrole dönüştürülmesi (arch-check) ve linterden E2E'ye doğrulama hiyerarşisi.

izolasyonun kör noktaları E2E testleri çalıştırılabilir mimari kurallar doğrulama hiyerarşisi
Utakachojifunza katika muhadhara huu
  • Birim testlerin özelliğin hazır olduğunu yanlış bildirdiği kör noktayı kendi test kapsamınızda tespit edeceksiniz.
  • En az bir mimari kuralı dokümandaki paragraf yerine çalıştırılabilir bir betik olarak yazacaksınız.
  • En ucuz kontrolden en maliyetliye kadar uzanan bir doğrulama hiyerarşisi oluşturacaksınız.

Mwanzo wa muhadhara

Her şey yeşil. Hiçbir şey çalışmıyor.

  • Üç katman birim testi — hepsi geçti
  • “Dışa Aktar” düğmesi: yol bozuk, ilerleme donmuş, bellek sızıntısı var
  • Beş kusur — ve birim testler hiçbirini yakalamadı

Beş hata, hiçbir testin bakmadığı yerlere saklandı — tam olarak oraya. Sahne şu: bir masaüstü uygulaması ve dosya dışa aktarma işlevi. Üç katmanın tamamında — yol ayrıştırmadan yazma modülüne kadar — birim testler yeşil; ajan “hazır” bildiriyor. Uygulamayı kendiniz açıp düğmeye basıyorsunuz. Yol biçimi yanlış: bileşen mutlak yol bekliyordu, göreli yol geldi. İlerleme çubuğu kımıldamıyor. Büyük dosyalarda uygulama bellek yemeye başlıyor ve sonunda çöküyor. Toplam beş kusur — ve hepsi bileşenler arası sınır noktalarında. Hiçbir birim test bunları fark etmedi; çünkü her test, kendi modülünü komşularından tamamen izole hâlde test etti.

Mit: %100 birim test kapsamı ≠ özelliğin çalışması

  • 🤔 Mit / Sık karıştırılan:
  • “Birim testler yeşil — demek ki özellik hazır”
  • ✅ Aslında:
  • Birim test, modülü izole hâlde test eder; modüller arası birleşim noktasını değil
  • 📌 Unutmayın: yeşil birim testler yalnızca her parçanın tek başına çalıştığını kanıtlar

Yüzde yüz birim test kapsamı, özelliğin çalıştığı anlamına gelmez — en sık karıştırılan nokta tam da budur. Birim test, tanımı gereği modülü izole hâlde test eder: bağımlılıklar mock'lanmıştır, ortam değiştirilmiştir. İki gerçek bileşenin birleşim noktasında olup bitenler hakkında hiçbir şey söylemez: veri biçimleri uyuşuyor mu, kaynaklar serbest bırakılıyor mu, mantık gerçek ortamda ayakta kalıyor mu. Tam da bu yüzden dosya dışa aktarma örneğinde ajan her şeyin bittiğinden emindi — ve beş ayrı yerde yanıldı; bunların hiçbiri tek bir modülün içinde değil.

Birim testler tesadüfen kör değildir — bilerek böyle tasarlandılar

  • Bağımlılıkları mock'la, modülü tek başına test et
  • Hızlı ve isabetli — ama sistematik olarak kör
  • Körlük, testlerin hatası değil; tasarımı

Bir fabrika montaj hattını düşünün: fren kaliperi kendi test istasyonunda, direksiyon kendi istasyonunda kontrol edilir; her sensör araçtan sökülüp ayrı ayrı test edilir. Her kontrol hızlı ve isabetlidir — hangi parçanın hatalı olduğu hemen anlaşılır. Ama hiçbir istasyon, tüm parçalar tek bir araca takılıp araç yola çıktığında ne olacağını kontrol etmez. Birim test de aynı şekilde çalışır: çevresindeki her şeyi mock'lar ve tek bir modülü saf hâliyle test eder. Bu, hız ve isabetli teşhis sağlar; ama aynı izolasyon, testleri dört kusur sınıfına karşı sistematik olarak körleştirir — o kusurlar modülün içinde değil, modüllerin birleşim noktalarında yaşar; parçaların tek bir sisteme dönüştüğü tam o noktada. Körlük, testlerin hatası değil; tasarımının doğrudan sonucudur.

Muhadhara kamili unapatikana kwa usajili

Kuna slaidi 21 zaidi katika toleo kamili.

Video, slaidi zote, maelezo, majaribio, AI tutor na mahojiano vitafunguka baada ya kuingia na kujisajili.

Ingia au jisajili Jiandikishe

Yaliyomo kwenye muhadhara

  1. Her şey yeşil. Hiçbir şey çalışmıyor.
  2. Mit: %100 birim test kapsamı ≠ özelliğin çalışması
  3. Birim testler tesadüfen kör değildir — bilerek böyle tasarlandılar
  4. Birim testin asla göremeyeceği dört hata türü
  5. Birim testler, E2E'den kesinlikle daha az hata görür — bu bir metafor değil
  6. E2E yalnızca çıkıştaki bir filtre değildir
  7. E2E'nin ilk çalıştırmadan önce ajanın kodunu değiştirdiği üç yol
  8. Önce mimari sınırlar, sonra E2E
  9. 📖 OpenAI gözlemi: ajanlar örüntüleri kopyalar
  10. Bağımlılık okları yalnızca yukarı akar — ve bunu makine denetler
  11. Değişmezleri sağlayın, uygulamayı mikro yönetmeyin
  12. ❓ Dur-kontrol: sıra sizde
  13. Mimari kuralı otomatikleştirmenin üç seviyesi
  14. 💡 İnceleme: seviye 2 — linter kuralları
  15. 💡 İnceleme: seviye 2 — linter kuralları
  16. Seviye 3: CI'da mimari testler
  17. Review'da aynı yorumu ikinci kez mi yazıyorsunuz? Bu, harness'ınızın bug'ıdır
  18. Reviewer şikâyeti otomatik kontrole nasıl dönüşür: 1-3. adımlar
  19. 4-6. adımlar: kontrolü sağlamca sabitleyin — ve asıl olanı unutmayın
  20. E2E ne zaman zorunlu, ne zaman onsuz da olur
  21. Ters çevrilmiş doğrulama piramidi
  22. Tuzaklar: alttan üçüncü seviyede verilen 'hazır' kararı
  23. Proje: checkout için E2E ve ödemeler için arch-check.sh
  24. Unit testler detayları kanıtlar; feature'ın bütünüyle hazır olduğunu değil

Makala kuhusu somo hili

Mihadhara yote ya kozi hii

  1. Harness Engineering Nedir? AI Kodlama Ajanı Modelden Değil, Ortamdan Neden Çöker
  2. AI Ajanında Hata Birikimi: Adım Başına %95 Doğruluk Neden 10. Adımda Başarısız Olur
  3. AI Ajan Güvenilirlik Metrikleri: MTBF, MTTR, Patlama Yarıçapı ve Little Yasası
  4. AI Ajanı Üretimde Neden Çöker: Beş Hata Katmanı ve Teşhis Döngüsü
  5. AI Ajan Harness'ı Neyden Oluşur: Talimatlar, Araçlar, Ortam, Durum, Geri Bildirim
  6. AI Kodlama Ajanları İçin Depo Haritası: Oturumlar Arası Hafızasız Proje Yapısı
  7. AGENTS.md En İyi Uygulamaları: Dev Talimat Dosyası Neden Çalışmaz, Yönlendirici Nasıl Kurulur
  8. AI Ajanı Oturumlar Arası Hafıza: Oturum Devri, PROGRESS.md ve Başlangıç Sözleşmesi
  9. AI Ajanları İçin feature_list.json: WIP=1, Özellik Durumları ve verify.sh Doğrulaması
  10. Ajan 'Hazır' Dedi, Özellik Çalışmıyor: Doğrulama Boşluğu ve Definition of Done
  11. Tüm Testler Yeşil, Özellik Bozuk: AI Ajanları İçin E2E Testler ve Mimari Kurallar
  12. AI Ajanı Gözlemlenebilirliği: Sprint Sözleşmesi, Değerlendirici Rubriği ve Temiz Oturum Çıkışı
  13. AI Ajanını Saatlerce Denetimsiz Çalıştırmak: Loop Engineering ve Durdurma Koşulları
  14. AI Ajanları İçin Graph Engineering: Tek Döngü Yetmediğinde Görev Grafiği
  15. AI Ajan Harness'ını Sıfırdan Kurmak: AGENTS.md, feature_list.json, verify.sh ve Otonom Döngü