Bir BatonX pilotunun amacı, kodlama ajanının gerçek bir geliştirme iş akışında kurumun belirlediği sınırlar içinde çalışmasını değerlendirmektir.
Başarılı bir pilot için kapsamı küçük ve ölçülebilir tutun: bir temsilî repository, sınırlı sayıda geliştirici, onaylı bir model hedefi ve açık başarı kriterleriyle başlayın.
Bu rehber, pilot öncesi hazırlıkları açıklar. Kullanılacak BatonX sürümünün desteklediği özellikler ve entegrasyonlar, pilot kapsamı belirlenirken doğrulanmalıdır.
1. Temsilî bir proje seçin
Günlük geliştirme çalışmalarınızı yansıtan, ancak ilk deneme için kritik üretim sistemlerine erişim gerektirmeyen bir repository seçin.
Projenin kurulum adımları, bağımlılıkları ve test komutları belgelenmiş olmalıdır. İlk görevleri hata düzeltme, küçük bir özellik geliştirme veya test ekleme gibi sınırları net çalışmalar arasından belirleyin.
Hazırlayın:
- Pilot repository’si ve erişim yetkileri.
- Kullanılacak branch ve kod inceleme süreci.
- Gerekli paket kaynakları ve geliştirme servisleri.
- Gizli bilgilerden arındırılmış örnek yapılandırma ve test verileri.
Üretim kimlik bilgilerini veya gerçek müşteri verilerini başlangıç için gerekli kabul etmeyin.
2. Onaylı model hedefini belirleyin
Pilot ajanının hangi model sağlayıcısına ve endpoint’e bağlanacağını netleştirin. Bu hedef, kurumunuzun onayladığı bir sağlayıcı servisi veya pilot sürümünün desteklediği özel bir model endpoint’i olabilir.
Model adı, erişim yöntemi, veri işleme koşulları ve kullanım bütçesi önceden belirlenmelidir. Özel bir endpoint’in uyumluluğu yalnızca API biçimiyle değil, ajanın ihtiyaç duyduğu araç çağrıları ve diğer yeteneklerle birlikte doğrulanmalıdır.
Sağlayıcı kimlik bilgilerinin kim tarafından oluşturulacağını, nasıl korunacağını ve gerektiğinde nasıl iptal edileceğini belirleyin. Onaysız bir model veya sağlayıcıya otomatik geçişi pilotun varsayılan davranışı yapmayın.
3. Geliştirici iş akışını tanımlayın
Pilot, geliştiricinin günlük çalışma biçimini değerlendirmeye yetecek kadar gerçekçi olmalıdır.
Basit bir akış belirleyin:
- Geliştirici yetkili proje için oturum başlatır.
- Ajana kapsamı belirli bir görev verir.
- Ajan, tanımlanan izinler ve gerekli onaylar çerçevesinde çalışır.
- Değişiklikler ve test sonuçları geliştirici tarafından incelenir.
- Geliştirici, mevcut kod inceleme sürecini kullanarak değişiklikleri teslim eder.
Hangi işlemlerin serbest, hangilerinin onaya bağlı ve hangilerinin yasak olduğunu önceden kararlaştırın. Engellenen bir işlemde geliştiricinin kimden destek alacağını da açıklayın.
4. Çalışma ortamını ve erişim sınırlarını hazırlayın
Ajanın erişebileceği çalışma alanını, çalıştırabileceği işlemleri ve bağlanabileceği hedefleri tanımlayın.
Model bağlantısının yanında bağımlılık indirme, test çalıştırma ve geliştirme servislerine erişim ihtiyaçlarını da değerlendirin. Gerekli bağlantıları tek tek belirleyin; sorunları çözmek için genel ve sınırsız erişim açmayın.
Pilot sırasında şu sınırların doğrulanmasını planlayın:
- Yetkisiz repository ve çalışma alanı dışı dosya erişimi.
- İzin verilmeyen komutlar ve ağ bağlantıları.
- Kimlik bilgilerine erişim.
- Oturumun durdurulması ve erişimin geri alınması.
5. Operasyonel sorumlulukları netleştirin
Müşteri tarafından yönetilen bir pilotta, kurulumun yapılacağı altyapı ve günlük işletim sorumlulukları açık olmalıdır.
Kurum tarafında altyapı, güvenlik ve geliştirici koordinasyonu için sorumlular belirleyin. BatonX ekibiyle kurulum desteği, sorun inceleme ve güncelleme kapsamını ayrıca kararlaştırın.
Başlamadan önce şu soruları yanıtlayın:
- Kullanıcı ve repository erişimini kim onaylayacak?
- Model kimlik bilgilerini ve kullanım bütçesini kim yönetecek?
- Politika değişikliklerine kim karar verecek?
- Denetim kayıtlarını kim inceleyecek ve ne kadar süre saklayacak?
- Bir sorun yaşandığında oturumu kim durduracak?
- Pilot sonunda erişimler, çalışma alanları ve kayıtlar nasıl ele alınacak?
6. Başarı kriterlerini önceden belirleyin
Pilotun başarısını yalnızca üretilen kod miktarıyla ölçmeyin.
Seçilen geliştirme görevlerinin tamamlanmasını; erişim sınırlarının uygulanmasını, gerekli onayların işlemesini, model kullanımının izlenebilmesini ve sorunların anlaşılır biçimde raporlanmasını birlikte değerlendirin.
Geliştiricinin karşılaştığı gereksiz kesintileri de kaydedin. Pilot sonunda hangi kontrollerin doğrulandığı, hangi sınırlamaların kaldığı ve bir sonraki aşama için nelerin gerektiği açık olmalıdır.