- Ana sayfa
- Dokümantasyon
- Çok ajanlı incelemeler
Çok ajanlı incelemeler
Son güncelleme
AI CodeOps bir değişikliği birkaç ajanla nasıl inceler: inceleme adımları, gerçek diff üzerinde bir bulgu geçişi, önem derecesi ve triyaj ve ardından gelen insan onayı.
AI CodeOps'ta bir değişikliği yazan ajan, onu kontrol eden ajan değildir. İş akışındaki inceleme adımları işe farklı açılardan bakar. Ardından bir bulgu geçişi gerçek diff'i inceler ve yapılandırılmış bulgular kaydeder. Son kararı bir insan verir.
İş akışındaki inceleme adımları
Çoğu iş akışı, her birini kendi ajanının çalıştırdığı bir veya daha fazla inceleme adımı içerir:
- Plan, Build, Review & Test iş akışında Reviewer tarafından çalıştırılan bir Review adımı vardır.
- Security-Sensitive Change iş akışında değişiklikten önce bir Risk analysis, sonra bir Audit diff adımı vardır; ikisini de Security Auditor çalıştırır.
- Parallel Review iş akışında üç inceleme (Reviewer tarafından doğruluk, Security Auditor tarafından güvenlik, Tester tarafından test kapsamı) ve ardından bunları birleştiren bir Merge findings adımı vardır.
- Release Readiness bir E2E sanity kontrolü ve bir bağımlılık denetimi, ardından bir Go / no-go adımı ekler.
- Architecture Debate iş akışında iki mimar birer yaklaşım önerir, bir eleştirmen bunları inceler ve bir nihai sentez yapılır.
Adımlar birbiri ardına çalışır. Her biri önceki adımların yazdıklarını görür; dolayısıyla bir birleştirme veya sentez adımı kendisinden önceki her incelemeden yola çıkar. Hiçbir şey oyla kararlaştırılmaz.
Bir inceleme adımı ne zaman çalışır
İşi kontrol eden bir adım yalnızca var olan işi kontrol edebilir. Bu yüzden bir oturum şu sırayla çalışır:
- Değişikliği uygulayan adıma kadarki adımlar önce çalışır. Plan, Build, Review & Test iş akışında bunlar Plan ve Build adımlarıdır; Security-Sensitive Change iş akışında ise Scope change, Risk analysis ve Implement adımlarıdır.
- Değişiklik yazılır ve projenizin testleri onun üzerinde çalışır.
- Uygulama adımından sonraki adımlar çalışır: Review ve Test ya da Audit diff ve Validate. Her birine değişikliğin yazılmış hâli (diff; uzunsa sığacak şekilde kesilir ve kesilen yer işaretlenir) ve kaydedilen test sonucu gösterilir; okuduğu dosyaları belirtmesi söylenir.
Bu sonraki adımlardan biri başarısız olursa veya süresi dolarsa oturum değişikliğini korur ve adım oturum sayfasında failed olarak işaretlenir.
Parallel Review, Swarm Inspection veya Release Readiness gibi uygulama adımı olmayan bir iş akışı, tüm adımlarını herhangi bir kod yazılmadan önce çalıştırır. İncelemeleri, reponuzda hâlihazırda bulunan kod üzerinedir. Architecture Debate belge yazar, kod yazmaz.
Bulgu geçişi
İnceleme adımları notlarını metin olarak yazar. Bu yüzden değişiklik yazılıp test edildikten ve o adımlar çalıştıktan sonra AI CodeOps, diff'in kendisi üzerinde ayrı bir inceleme çalıştırır; değişikliği kapıda tutan bulguları bu inceleme kaydeder. Bu incelemeye şunlar verilir:
- incelenecek şey olarak diff;
- bağlam olarak, adında review, security, audit, risk veya test geçen her adımın notları;
- bir takip oturumu için, önceki turların neleri gündeme getirdiği ve bir insanın her biri hakkında ne karar verdiği.
İncelemeye, high veya critical bir bulgunun onu tetikleyen somut girdiyi ve neyin ters gittiğini belirtmek zorunda olduğu, bu şekilde destekleyemediği bir bulgunun ise en fazla medium olabileceği söylenir.
En fazla 12 somut sorunu bulgu olarak kaydeder. Bulgular, oturumda çalıştıysa Security Auditor ajanına, çalışmadıysa Reviewer ajanına, o da yoksa çalışan son ajana atfedilir.
Her bulgunun bir başlığı, bir açıklaması, bir önerisi ve genellikle bir dosyası vardır.
Önem derecesi
| Önem derecesi | Çözülmediği sürece değişikliği engeller mi? |
|---|---|
| critical | Evet |
| high | Evet |
| medium | Hayır |
| low | Hayır |
| info | Hayır |
Kategori
Security, quality, performance, accessibility, compliance, dependency, documentation, test coverage, reliability, cost, UX veya other.
İnceleme tamamlanamadığında
Bulgu geçişinin iki dakikası vardır. Bulgu olarak okunamayan bir yanıt bir kez daha istenir; yarıda kesilen bir yanıtın ise tamamladığı bulgular korunur. Model başarısız olursa veya süresi dolarsa, önce bütçe tükenirse ya da yanıt yine okunamazsa inceleme tamamlanmamış sayılır. Değişiklik bu durumda bekletilir ve oturum sayfası bunlardan hangisinin olduğunu ve ne yapılacağını söyler: oturumu yeniden çalıştırın veya önce bütçeyi artırın. Boş bir liste ise tam tersine, hiçbir şey bulunmamış, tamamlanmış bir incelemedir.
Bulguları triyajdan geçirin
Bir oturumun sayfasını açın ve Findings listesini bulun. Her bulgunun durumunu açılır menüsünden ayarlayın:
| Durum | Hâlâ engeller mi (high veya critical ise)? |
|---|---|
| open, acknowledged, in progress | Evet |
| fixed, won't fix, false positive, duplicate | Hayır |
Bir bulguyu düzelten bir oturum başlatmak için bulguda Fix düğmesini seçin. O oturumdan, bulguyu yeniden üreten bir test içermesi istenir. Çalışma alanı genelindeki bulgular Build & Test → Quality altındadır. Bir durumu değiştirmek için triyaj izni olan bir rol gerekir; Viewer rolünde bu izin yoktur. Bkz. Kalite kapıları.
İnsan incelemesi
Bulgu geçişi bittiğinde ve oturum bir diff ürettiğinde AI CodeOps, Review & Gate → Approvals sayfasında bir inceleme talebi açar. Bir insan diff'i ve bulguları okur, ardından onaylar veya reddeder.
- Ç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.
- Onaydan sonra değişikliği düzenlemek onu yeniden onaya gönderir.
Onay, kalite kapısı da geçilirse pull request'i açar. Bkz. Onaylar ve politikalar.
Sonraki adımlar
Sık sorulan sorular
İnceleme koda mı bakar, plana mı?
Koda. Değişikliği uygulayan adımı izleyen bir inceleme adımı, kod yazıldıktan sonra çalışır ve ona diff ile test sonucu gösterilir. Bulgu geçişi ardından, inceleme adımlarının notlarını bağlam olarak alıp aynı diff'i okur.
İnceleyen ajanlar oy kullanır mı?
Hayır. Her inceleme adımı analizini sırayla yazar ve son bir adım ya da bulgu geçişi hepsini okur. Oylama veya uzlaşı sayımı yoktur.
Yapay zekâ incelemesi başarısız olursa ne olur?
Değişiklik bekletilir. Bulguları bilinmez; dolayısıyla siz oturumu yeniden çalıştırana kadar pull request açamaz.