Yapay zekâ ile hata çözerken hangi bilgiler paylaşılmalı?

İyi bir hata isteği; beklenen davranışı, gerçekleşen sonucu ve sorunu yeniden oluşturan en kısa yolu birlikte verir. Yalnız “çalışmıyor” yazmak, aracı tahmin yürütmeye zorlar. Bütün projeyi paylaşmak yerine hatayı taşıyan küçük örneği hazırlamak hem teşhisi kolaylaştırır hem ilgisiz veriyi dışarıda tutar.

Önce hatanın sınırını bulun​

Bir kayıt formu başarısızsa sorun ekranın açılmaması, isteğin gönderilmemesi veya sunucunun isteği reddetmesi olabilir. Bunlar farklı düzeltmeler gerektirir. Hata metnini kendi yorumunuzla değiştirmeden alın; ardından hangi işlemin hemen sonrasında çıktığını yazın. Ekran görüntüsü yerleşimi gösterir, fakat kopyalanabilir hata metni arama ve satır eşleştirme için daha kullanışlıdır.

Kısa ve tekrar edilebilir rapor hazırlayın​

1. Ortamı belirtin. Dil veya çalışma zamanı sürümünü, işletim sistemini ve kullandığınız çalıştırma komutunu yazın. Projede kilit dosyası varsa kullanılan bağımlılık sürümlerini onunla ilişkilendirin.
2. Adımları gerçek sırada verin. Örneğin “uygulamayı başlat, boş e-posta ile formu gönder” gibi herkesin izleyebileceği eylemler kullanın. Giriş yapılmış olma gibi ön koşulu da ekleyin.
3. Beklenen ve gerçekleşen sonucu ayırın. “Alan altında uyarı bekliyorum; bunun yerine boş sayfa açılıyor” ifadesi araştırmanın yönünü belirler.
4. Hatanın ilk anlamlı satırını ve ilgili çağrı zincirini paylaşın. Sonraki yüzlerce aynı mesajı eklemeyin. Parola, erişim belirteci, kişisel kayıt ve bağlantı parolasını örnek değerle değiştirin.
5. En küçük örneği tekrar çalıştırın. Gereksiz parçaları çıkardığınızda hata da kaybolduysa çıkardığınız parçanın bağımlılığını araştırın. Artık hata vermeyen örneği asıl sorunmuş gibi sunmayın.

Kullanılabilir bir istek örneği​

Python 3 kullanıyorum. CSV dosyasından tutarları okuyorum. Boş hücre bulunduğunda o satırı rapora almak istiyorum, fakat ValueError ile işlem duruyor. Aşağıdaki üç satırlık örnek sorunu üretiyor. Önce hatanın nedenini açıkla, sonra yalnız boş hücre davranışını düzelt; diğer satırları atlama.

Genişletmek için tıkla ...

Bu isteğe küçük girdi dosyası, ilgili fonksiyon ve tam hata eklenirse araç davranışı kontrol edebilir. Düzeltme geldikten sonra aynı örneği ve daha önce çalışan bir kaydı tekrar deneyin. Hata metni değiştiyse bunun ilerleme mi, başka bir arıza mı olduğunu yeni sonuca göre değerlendirin.

Hata raporundan özel bilgileri çıkarırken sorunu da yanlışlıkla ortadan kaldırmak mümkün. Örnek olarak yalnız Türkçe karakter içeren bir dosya adında hata oluştuğunu varsayalım. Dosya adını tamamen sadeleştirince hata kaybolursa paylaşılabilir bir örnek hazırlarken hangi özelliği korumak gerekir? Gerçek adın kendisi gerekli olmayabilir.

Gerçek kimliği değil, hatayı üreten teknik özelliği korumak gerekir. Aynı türde Türkçe karakter, boşluk veya uzunluk içeren uydurma bir dosya adı seçilip örnek tekrar çalıştırılabilir. Böylece özel ad paylaşılmadan aynı davranış gösterilir. Örneğin artık hata vermediği durumda onu asıl sorunun yeniden üretimi diye sunmamak önemli.

Temizlenmiş örnekte hangi alanların temsilî değerlerle değiştirildiğini kısa biçimde belirtmek de yardımcı olur. Ancak bu not hata metninin yerine geçmemeli. Kullanılan komut, ortam sürümü ve beklenen sonuç korunursa karşı taraf sorunun veri biçiminden mi, dosya yolundan mı kaynaklandığını daha kolay ayırabilir.