- Ana sayfa
- Dokümantasyon
- AI CodeOps nasıl çalışır
AI CodeOps nasıl çalışır
Son güncelleme
Bir AI CodeOps oturumunu görevden merge edilmiş pull request'e kadar izleyin: ajanlar planlar ve yazar, testleriniz sandbox'ta çalışır, yapay zekâ incelemesi sorunları işaretler, bir insan onaylar.
Bir oturum, tek bir görevi bir cümleden incelenmiş bir pull request'e taşır. Bu sayfa bir oturumu, AI CodeOps'un çalıştırdığı sırayla her aşamasında izler.
1. Görevi tarif edersiniz
Develop → AI Sessions sayfasını açın ve New session düğmesini seçin. Görevi tarif edin, bir Workflow ve bir Project seçin ve Start session düğmesini seçin. Her oturum bir projeye aittir.
Herhangi bir şey çalışmadan önce AI CodeOps iki şeyi kontrol eder:
- Bütçeniz. Çalışma alanı bütçesini aşmışsa veya kotası tükenmişse oturum başlamaz ve nedenini söyler. Bkz. Maliyet kontrolleri.
- Çalışma alanı politikanız. Bir deny kuralı oturumu durdurur. Bir ask kuralı, biri Review & Gate → Approvals sayfasında onaylayana kadar oturumu bekletir. Bkz. Onaylar ve politikalar.
Oturum ardından, bir worker onu alana kadar pending durumuyla kuyruğa girer.
2. Ajanlar iş akışını baştan sona yürütür
İş akışı, sabit bir adım listesidir. Her adımı tek bir ajan çalıştırır ve adımlar birbiri ardına çalışır. Varsayılan iş akışı olan Plan, Build, Review & Test dört adımdan oluşur:
- Plan: Architect çalıştırır.
- Build: Builder çalıştırır.
- Review: Reviewer çalıştırır.
- Test: Tester çalıştırır.
Değişikliği uygulayan adıma kadarki adımlar (burada Plan ve Build) önce çalışır. Ondan sonraki adımlar işi kontrol eder; bu yüzden kod yazılana ve testleriniz onun üzerinde çalışana kadar beklerler (5. aşama).
Her adım görevi ve önceki adımların yazdıklarını görür. Bütçe, her model çağrısından önce yeniden kontrol edilir. Yarı yolda bütçeyi aşan bir oturum, gerekçesiyle birlikte durur. Diğer iş akışları İş akışları sayfasında listelenir.
3. Değişiklik yazılır
AI CodeOps ardından planı eksiksiz dosyalara dönüştürür. Bunları reponuzun yeni bir kopyasına uygular ve bir diff üretir. Reposu olmayan bir proje ise bunun yerine yeni bir kod tabanı alır.
Yarıda kesilen bir yanıtın yazdıkları korunur ve geri kalanı istenir: henüz ulaşmadığı dosyalar ve içinde durduğu dosyanın kalanı. Herhangi bir şey incelenmeden önce her dosya kontrol edilir: başıboş diff işaretleri çıkarılır ve ayrıştırılamayan bir dosya bir kez daha istenir. Yine ayrıştırılamayan bir dosya yüksek (high) önem derecesinde bir bulgu olarak kaydedilir.
60 KB'ı aşan bir diff bütünüyle reddedilir: "Split the task into smaller changes." Kullanılabilir hiçbir dosya değişikliği dönmezse oturum, gerekçesiyle birlikte başarısız olur.
4. Testleriniz çalışır
AI CodeOps değişikliği yalıtılmış bir sandbox içinde yeniden kurar. Bağımlılıkları yükler, sandbox'ın ağ bağlantısını keser ve projenizin test komutunu çalıştırır. Sonuç, oturumun test çalıştırması olarak kaydedilir: geçen, başarısız olan ve atlanan testler ile kapsam.
Test komutu, projede ayarlanmış olan komuttur. Ayarlanmamışsa AI CodeOps önce bir package.json test script'i, sonra pytest, sonra go test arar. Testler hiç çalışamıyorsa (komut yoksa veya bağımlılıklar yüklenemiyorsa) hiçbir şey kaydedilmez ve çalıştırma sayfası değişikliğin doğrulanmadığını gösterir. Yayın kapısı bunu geçti saymaz: projede Don't run tests for this project seçeneği açık olmadıkça, test sonucu olmayan bir kod değişikliğini reddeder.
5. Kalan adımlar yazılan değişikliği kontrol eder
Uygulama adımını izleyen adımlar (burada Review ve Test) şimdi çalışır. Her birine değişikliğin yazılmış hâli ve kaydedilen test sonucu gösterilir; okuduğu dosyaları belirtmesi söylenir. Oturumun özeti bunların sonuncusundan gelir; dolayısıyla testler çalıştıktan sonra yazılır.
Bu adımlardan biri başarısız olursa veya süresi dolarsa oturum, değişikliğiyle birlikte devam eder: kod yazılmış ve test edilmiştir, adım ise oturum sayfasında failed olarak işaretlenir.
6. Diff incelenir
Bir inceleme geçişi, inceleme ve güvenlik adımlarının notlarını bağlam olarak alıp gerçek diff'i okur. Bulguları kaydeder; her bulgunun bir önem derecesi, bir kategorisi ve genellikle bir dosyası vardır. Bir takip oturumunda ona, önceki turların neleri gündeme getirdiği ve bir insanın her biri hakkında ne karar verdiği de söylenir. Bkz. Çok ajanlı incelemeler.
Bu inceleme tamamlanamazsa değişiklik bekletilir: bulguları bilinmediği için temiz sayılamaz.
7. Değişiklik bir insanı bekler
Oturum bir diff ile bittiğinde AI CodeOps:
- oturumu completed olarak işaretler;
- değişikliğini Develop → Changes altında in review durumuna taşır;
- Review & Gate → Approvals sayfasında bir inceleme talebi açar. Talebin süresi 7 gün sonra dolar.
Özeti, Proposed changes bölümünü, Quality gates panelini ve Findings bölümünü görmek için oturum sayfasını açın.
8. Bir insan onaylar
Oturum sayfasında Accept changes düğmesini ya da Approvals sayfasında Approve düğmesini seçin. Çalışma alanında onay verebilecek başka biri varken oturumu başlatan kişi onu onaylayamaz. Tek kişilik bir çalışma alanı kendi değişikliğini onaylayabilir. Tek bir ret talebi sonlandırır.
9. Pull request açılır
Onay, pull request'i başlatır. AI CodeOps onu açmadan önce sırasıyla şunları kontrol eder:
- çalışma alanı politikası;
- onay;
- kalite kapısı: açık yüksek veya kritik bulgu yok, başarısız test yok ve inceleme tamamlanmış.
Üçü de geçilirse AI CodeOps codeops/run-<id> adlı bir branch'i push eder ve projenin varsayılan branch'ine bir pull request açar. Bunun için onaylayan kişinin Git bağlantısını kullanır; dolayısıyla o kişinin o platform için bağlı bir Git hesabına ihtiyacı vardır. Pull request açılamadıysa oturum sayfasında Create Pull Request düğmesini seçin. Düğme neyin eksik olduğunu söyler.
10. Merge ve dağıtım
Hazır olduğunuzda pull request'i merge edin. Konsoldan merge ederseniz önce kalite kapısı yeniden kontrol edilir. Projenin bir dağıtım hedefi varsa AI CodeOps ardından dağıtım webhook'unuzu çağırır ve dağıtımı kaydeder. Bkz. Kapı denetimli dağıtımlar.
Süre sınırları
| Aşama | Sınır |
|---|---|
| Koddan önceki adımlar | Toplam 4 dakika |
| Değişikliğin yazılması | 8 dakika |
| Testler | 6 dakika, ayrıca hâlihazırda çalışan komutun süresi |
| Koddan sonraki adımlar | Toplam 3 dakika |
| Diff'in incelenmesi | 2 dakika |
| Oturumun tamamı | Yaklaşık 30 dakika sonra takılmış sayılarak durdurulur |
Zaman aşımına uğrayan veya takılan bir oturum, gerekçesi sayfasında yer alacak şekilde failed olarak sona erer.
Sonraki adımlar
Sık sorulan sorular
Bir yapay zekâ oturumu kodu kendi başına merge eder mi?
Hayır. Her kod değişikliğini, pull request'i açılmadan önce bir insan onaylar; merge ise sizin attığınız ayrı bir adımdır.
Projemde hiç test yoksa ne olur?
Oturum yine çalışır ve çalıştırma sayfası doğrulamanın atlandığını gösterir. Yayın kapısı ardından değişikliği reddeder; çünkü test sonucu olmayan bir kod değişikliği geçti sayılmaz. Projenin test paketi yoksa ayarlarından "Don't run tests for this project" seçeneğini açın.
Ajanları çalışırken izleyebilir miyim?
Evet. Oturum sayfası her adımla, adımın ajanıyla, durumuyla ve o ana kadarki token ve maliyet bilgisiyle canlı olarak güncellenir.