Environment inspection

Bu modül için tahmini süre: 3 dakika

Genel bakış

AI agent’ları inşa ederken sık göz ardı edilen kritik bir kavram: environment inspection. Claude kör çalışır — etkili çalışabilmesi için aksiyonlarının sonuçlarını gözlemleyip anlayabilmesi gerekir.

AI agent’ları inşa ederken sık göz ardı edilen kritik bir kavram: environment inspection. Claude kör çalışır — etkili çalışabilmesi için aksiyonlarının sonuçlarını gözlemleyip anlayabilmesi gerekir.

Environment inspection neden önemli

Claude’un computer use ile nasıl çalıştığını düşünün. Claude metin yazma veya butona tıklama gibi her aksiyon gerçekleştirdiğinde, ne olduğunu anlamak için hemen bir ekran görüntüsü alır. Bu yalnızca “olsa iyi olur” bir özellik değil — esastır.

Claude’un perspektifinden bir butona tıklamak yeni bir sayfaya gidebilir, bir menü açabilir veya başka değişiklikleri tetikleyebilir. Sonuçları göremezse Claude’un aksiyonunun başarılı olup olmadığını veya ortamın yeni halini anlama olanağı yoktur.

Yazmadan önce okumak

Aynı prensip dosya işlemlerine de uygulanır. Claude bir dosyayı değiştirmeden önce mevcut içerikleri anlamalıdır. Bu bariz görünebilir ama agent inşa ederken her zaman izlemeniz gereken bir pattern’dir.

Yukarıdaki örnekte, bir Python dosyasına yeni route eklemesi istendiğinde Claude önce mevcut kodu okuyup yapıyı anlar. Yalnızca o zaman mevcut işlevselliği bozmadan istenen değişiklikleri güvenle yapabilir.

Environment inspection için system prompt

Claude’u sistem prompt’larıyla ortamını incelemeye yönlendirebilirsiniz. Video üretimi gibi karmaşık görevler için bu özellikle önemli olur.

Şunları yapması gereken bir video oluşturma agent’ı düşünün:

• FFmpeg gibi tool’larla video içeriği üretmek
• Ses diyaloğun doğru yerleştirildiğini doğrulamak
• Görsel öğelerin beklendiği gibi göründüğünü kontrol etmek

System prompt’a şu talimatları dahil edebilirsiniz:

• Diyalog yerleşimini doğrulamak için bash tool’unu kullanıp whisper.cpp çalıştır ve timestamp’lı caption dosyaları üret
• Video’dan düzenli aralıklarla ekran görüntüleri çıkarmak için FFmpeg kullan
• Üretilen içeriği orijinal gereksinimlere karşı karşılaştır

Environment inspection’ın faydaları

Claude ortamını inceleyebildiğinde birkaç şey iyileşir:

• İlerleme takibi — Claude bir görevi tamamlamaya ne kadar yakın olduğunu ölçebilir
• Hata yönetimi — Beklenmedik sonuçlar tespit edilip düzeltilebilir
• Kalite güvencesi — Görev tamamlanmış sayılmadan output doğrulanabilir
• Uyarlanabilir davranış — Claude gözlemlediklerine göre yaklaşımını ayarlayabilir

Pratik implementasyon

Kendi agent’larınızı tasarlarken her zaman şunu sorun: “Claude bu aksiyonun çalışıp çalışmadığını nasıl bilecek?” Dosyalarla, API’lerle veya kullanıcı arayüzleriyle çalışıyor olun; Claude’un aksiyonlarının sonuçlarını gözlemlemesini sağlayan tool ve talimatlar verin.

Bu şunlar anlamına gelebilir:

• Modifikasyondan önce dosya içeriklerini okumak
• UI etkileşimlerinden sonra ekran görüntüsü almak
• API yanıtlarını beklenen veri için kontrol etmek
• Üretilen içeriği gereksinimlere karşı doğrulamak

Environment inspection, Claude’u komutların kör bir uygulayıcısından, çalışma ortamını gerçekten anlayıp uyum sağlayan bir agent’a dönüştürür.

Temel çıkarımlar

• Claude kör çalışır — sonuçları gözlemlemesi gerekir
• Computer use her aksiyondan sonra ekran görüntüsü alır
• Dosya işlemlerinde edit’ten önce read şarttır
• System prompt’a doğrulama adımları (whisper.cpp, FFmpeg snapshot vb.) ekleyin
• “Claude bunun çalıştığını nasıl anlayacak?” sorusu agent tasarımının pusulasıdır