Bir yapay zekâ ajanına izole edilmiş bir ortama (Sandbox) erişim yetkisi verildiğinde, ajanın üzerinde çalışacağı dosyaların nasıl organize edileceği konusunda temel bir soru ortaya çıkar. Docker Sandbox platformu (sbx olarak anılır), kaynak kodunu yönetmek için her birinin geliştiricinin iş akışı ve ajanla etkileşimi üzerinde doğrudan etkisi olan üç ana model sunar.
1. Doğrudan Bağlantı (Shared Mounts)
Bu seçenek, mevcut çalışma yolunun ana makineden doğrudan izole ortamla paylaşılmasına olanak tanır. Proje klasöründen sbx run komutu çalıştırıldığında, klasör ortam içinde aynı mutlak yola bağlanır. Bu model, geliştiricinin değişiklikleri yerel düzenleyicisinde gerçekleştiği anda görebilmesi ve yerel geliştirme sunucularının hızlı yenileme (Hot Reload) özelliği aracılığıyla değişiklikleri yakalayabilmesi açısından tek bir görev üzerinde yakın iş birliği için idealdir.
Uyarı: Bağımlılık çakışmalarına karşı dikkatli olunmalıdır; yerel ikili dosyalar (Native Binaries) içeren paketler izole Linux ortamında çalışıp macOS veya Windows sisteminde başarısız olabilir. Bu nedenle çalışma ortamının standardize edilmesi veya bağımlılık kurulumunun ayrılması önerilir.
2. Git Çalışma Ağaçlarının Kullanımı (Git Worktrees)
Bu seçenek, aynı anda birden fazla görevi gerçekleştirmek için uygundur. Her göreve kendi klasörünü ve dalını (Branch) vererek her çalışma ağacının ayrı bir izole ortamda bağlanmasına olanak tanır. Buradaki avantaj, görevlerin tamamen izole edilmesidir; ancak teknik bir kilit nokta devam etmektedir: .git dosyası bağlama kapsamı dışındaki meta verilere işaret eder; bu da durum kontrolü (git status) veya dallar arasında geçiş yapma gibi işlemlerin ana makineden yapılması gerektiği anlamına gelir.
3. Klonlama Modu (Clone Mode)
Bu modda sbx aracı, izole ortam içinde kodun bağımsız bir kopyasını oluştururken, ana makine kodunu salt okunur olarak bağlar. Bu, ajana ortam içinde Git'e tam erişim sağlayarak onu dalları ve işlem geçmişini (Commits) yönetme konusunda tamamen bağımsız hale getirir. Çalışma bittikten sonra geliştirici, uzak bir Git deposu (Remote) aracılığıyla değişiklikleri alabilir.
Bu, Geliştiricinin İş Akışını Nasıl Değiştirir?
Doğru yöntemi seçmek, görevin doğasına ve doğrudan müdahale arzusuna bağlıdır:
- Yakın İş Birliği: Ajanın çalışmasını anlık olarak izlemek istiyorsanız Doğrudan Bağlantı'yı kullanın.
- Bağımsızlık: Ajana yerel çalışma ortamınızı etkilemeden görevleri yönetmesi için alan tanımak istiyorsanız Klonlama Modu'nu veya tamamen izole ortamlarni (Mountless) kullanın.
- Çoklu Proje Yönetimi: Ajanın birbirine bağlı projelerle (ön uç ve arka uç gibi) başa çıkmasını kolaylaştırmak için birden fazla deposunu tek bir ortamda toplamak amacıyla çalışma alanı yöneticileri (Workspace Managers) kullanılabilir.
Ana makine dosyalarını bağlamaya dayanmayan izole ortamların (Mountless), geliştirme sunucularına yerel tarayıcınızdan erişmek için manuel bağlantı noktası (Port) yönetimi gerektirdiğini unutmayın; bu, izolasyon güvenliğini artıran ancak kurulum için bazı ek adımlar ekleyen bir uygulamadır.