Bir görev kaynak dosyasını düzenleyebildiği halde üst klasöre çıktı yazamıyorsa sorun kodda olmayabilir. Codex'in çalıştığı sandbox, dosya sistemi ve diğer kaynaklarla ilgili teknik sınırları belirler. OpenAI belgeleri bu sınırı onay davranışından ayrı anlatır. Dolayısıyla onay istememek, bütün dizinlere erişebilmek anlamına gelmez; görev planı mevcut çalışma ortamına uygun kurulmalıdır.
Göreve ait dosyaları birlikte düşünün
Bir fatura PDF'si oluşturan uygulama üzerinde çalıştığınızı varsayın. Kaynak kodu proje dizininde, örnek görsel masaüstünde, beklenen çıktı ise başka bir diskte olabilir. Göreve başlamadan önce bu üç parçanın hangilerine gerçekten ihtiyaç olduğunu belirleyin. Görsel gerekli değilse onu bağlama eklemek gereksizdir. Gerekliyse erişilebilir konumu ve kullanım amacı açık olmalıdır.
Örnek istek: “Bu çalışma alanındaki fatura şablonunu düzenle. Örnek veriyi fixtures dizininden kullan ve üretilen önizlemeyi artifacts içine kaydet. Diğer projelere ait dosyaları değiştirme.” Bu talimat, uygulanabilir bir dosya ilişkisi kurar. Gerçek izin sınırı yine çalışma ortamının ayarlarından gelir; doğal dilde yazılmış bir yol kendi başına teknik yetki sağlamaz.
Engeli nedeniyle birlikte okuyun
“Dosya bulunamadı” ve “erişim reddedildi” aynı sorun değildir. İlkinde yol, çalışma dizini veya dosyanın varlığı kontrol edilir. İkincisinde dosya sistemi izinleri, sandbox sınırı veya yönetilen kısıtlar etkili olabilir. İki hataya da daha geniş erişimle karşılık vermek teşhisi zorlaştırır. Önce küçük bir okuma veya dosya durumu kontrolüyle nedeni ayırın.
Sembolik bağlantılar ve bağlanan dizinler görünürde proje içinde olsa da farklı bir fiziksel konuma işaret edebilir. Bir çıktı yolu türetiliyorsa gerçek hedefi kontrol etmek önemlidir. Özellikle toplu taşıma veya silme işlemlerinde hedefin beklenen çalışma alanında kaldığı doğrulanmalıdır. Yolu ekranda benzer görmek yeterli güvence değildir.
Ağ ve dosya erişimini ayrı değerlendirin
Kaynak dosyasını okuyabilen bir süreç paket sunucusuna bağlanamayabilir. Tarayıcıda açılan bir site de kabuk komutunun aynı adrese erişebildiğini kanıtlamaz. Farklı araçlar farklı erişim yollarına sahip olabilir. Bir bağımlılık kurulumu engellendiğinde önce eldeki yerel araçlar ve önceden kurulmuş paketler değerlendirilmelidir.
Hata raporunda bu ayrımı koruyun: “Kaynak değişikliği hazır; paket indirme bağlantısı engellendiği için derleme çalıştırılamadı” açıklaması, “testler geçmedi” cümlesinden daha doğrudur. İlki altyapı engelini anlatır; ikincisi kod başarısızlığı izlenimi verebilir. Eksik doğrulamayı doğru adlandırmak sonraki kişinin işini kolaylaştırır.
Daha geniş erişimi varsayılan çözüm yapmayın
Birden çok depoda yürütülen gerçek bir görev için ek çalışma kökleri gerekebilir. Bu ihtiyaç açıkça tanımlanmalı, yalnızca ilgili alanları kapsamalıdır. Tek bir önizleme dosyası için bilgisayarın tamamını erişilebilir kılmak çoğu durumda gereksizdir. Daha dar bir çıktı konumu seçmek sorunu daha az değişiklikle çözebilir.
Çalışma alanı düzenli olduğunda son kontrol de sadeleşir. Değişen dosyaları listeleyin, çıktıları ayrı klasörde tutun ve geçici dosyaların yayına karışmadığını görün. Sandbox işin doğruluğunu tek başına garanti etmez; ancak görevle ilişkili kaynakların sınırını görünür ve yönetilebilir hale getirir. Bu sınırı anlamak, gereksiz yetki değişikliklerinden önce gelen temel teşhis becerisidir.
Önizleme üreten bir görevde dosya adını sabit tutmak, çıktının nerede aranacağını belirler. Birden fazla çalışma aynı klasörü kullanıyorsa görev kimliği içeren adlar seçmek dosyaların birbirini ezmesini önler ve son teslimde doğru görselin bulunmasını kolaylaştırır.
Resmî kaynak: OpenAI Docs — Sandbox.
