Hata durumunda kapalı kalan yapay zekâ kod kalite kapıları
AI CodeOps'ta yapay zekânın yazdığı değişiklikler ancak testler geçince, yapay zekâ bulgu incelemesi temiz çıkınca ve başka biri onaylayınca pull request açar.
AI CodeOps'ta kalite kapıları, her yapay zekâ değişikliğinin pull request'e dönüşmeden önce geçmek zorunda olduğu kontrollerdir: diff'in yapay zekâ incelemesi çalışmış ve açık ciddi bir şey bulmamış olmalı, projenin testleri başarısız olmamalı ve bir insan onaylamalıdır. Aynı kapı, konsol pull request'i merge etmeden önce yeniden çalışır ve CI'ınız bir API üzerinden ondan karar isteyebilir.
Yapay zekâ ajanları hızlı kod yazar. Bu hız, ancak her değişiklik insanların yaptığı değişikliklerden beklediğiniz çıtayı yine de karşılıyorsa işe yarar. Bu sayfa her kontrolün neye baktığını, neyi engellediğini ve nerede durduğunu açıklar.
Hangi ajanlar çalışır
Kapı, bir ajanın kendi işi hakkındaki görüşüne güvenmez. Ajanların ve platformun ürettiği kayıtları okur:
- Gerçek diff'in incelemesinden gelen bulgular; iş akışında varsa Security Auditor ajanına, yoksa Reviewer ajanına atfedilir.
- Kendi test paketinizden gelen test çalıştırmaları. Tester test senaryolarını adlandırır ve kaydedilen çalıştırmayı okur, ancak geçerli sayılan sonuç test paketinin çalıştırılmasından gelir.
- CI'ınız gerektirdiğinde, tamamlanmış bir Release Readiness çalıştırması gibi, oturumun kendi iş akışı çalıştırmaları.
Quality-Gated Change iş akışı (Builder, Tester, Reviewer) kapıdan geçen en kısa yoldur. Kodu değiştiren diğer her iş akışı aynı kontrollerden geçer.

Etkileşimli demo, örnek veriler.
İlgili kalite kapıları
Bir oturum bittiğinde AI CodeOps, değişikliğinin yayına alınmaya hazır olup olmadığını belirler. Şunlardan herhangi biri başarısız olursa değişiklik bekletilir:
- Yapay zekâ incelemesi çalıştı. Kod yazıldıktan sonra bir inceleme adımı diff'i okur ve yapılandırılmış bulgular kaydeder. Tamamlanamadıysa değişiklik, incelenene kadar bekletilir. Eksik bir inceleme asla geçti sayılmaz.
- Engelleyici bulgu yok. Hâlâ open, acknowledged veya in progress durumunda olan, yüksek (high) veya kritik (critical) önem derecesindeki bir bulgu değişikliği engeller. Bkz. yapay zekâ kod incelemesi.
- Testler başarısız olmuyor. Projenin kendi test paketi, değişiklik üzerinde çevrimdışı bir sandbox içinde çalışır. Başarısız bir test veya sıfırdan farklı bir çıkış kodu değişikliği engeller. Projede Don't run tests for this project seçeneği açık değilse, sayıları içeren bir test sonucu olmayan kod değişikliği de engellenir. Bkz. test.
- Test edilen sürüm günceldir. Testler çalıştıktan sonra biri değişikliği düzenlerse eski sonuç artık sayılmaz.
- Bir insan onaylar. Değişiklik üreten her oturum bir onay talebi açar. Tek bir onay yeterlidir. Çalışma alanında başka bir onaylayıcı varken oturumu başlatan kişi bu onayı veremez. Tek başınıza mı çalışıyorsunuz? Tek onaylayıcısı olan bir çalışma alanı kendi değişikliklerini onaylar ve denetim izi bunları kendi kendine onaylanmış olarak işaretler. Tek bir ret talebi sonlandırır. Onaydan sonra kodu düzenlemek talebi yeniden beklemeye alır. Karara bağlanmamış bir talebin süresi yedi gün sonra dolar ve yeniden talep edilebilir.
- Çalışma alanı politikası. Pull request açılmadan önce repo ve değişen her dosya politikalarınıza göre kontrol edilir. Bir deny kararı işlemi durdurur; bir ask kararı onay gerektirir.
Kapı hata durumunda kapalı kalır. Bir kontrol hata verirse değişiklik geçirilmez, reddedilir.
Neyi engeller
Kapı, AI CodeOps aracılığıyla yapılan eylemlere uygulanır:
- Bir oturumdan pull request açılması.
- Bir oturumun açtığı pull request'in konsoldan merge edilmesi.
- Bir olayın düzeltmesi merge edildikten sonraki otomatik dağıtımlar.
Doğrudan GitHub, GitLab veya başka bir platformda merge edilen bir pull request AI CodeOps'un dışındadır. Bu merge işlemlerini de kapıdan geçirmek için kapıyı CI'ınızdan çağırın.
Kapıyı CI'dan kullanma
Release gate sayfası (Review & Gate altında), bir pull request URL'sini veya commit SHA'sını istek üzerine kontrol eder. Aynı kontrol, pipeline'ınız için bir çalışma alanı API anahtarıyla kimliği doğrulanan bir API'dir:
curl -s -X POST "https://<your-console>/api/release/check" \
-H "Authorization: Bearer $WORKSPACE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"pullRequestURL":"https://github.com/acme/checkout/pull/42","blockingSeverity":"medium","requireDeployedTo":"staging"}'
Ana alanlara indirgenmiş, reddedilmiş bir yanıt:
{
"allowed": false,
"evidenceComplete": true,
"summary": "HIGH security: Coupon code is passed to the pricing query without validation",
"reasons": [
"HIGH security: Coupon code is passed to the pricing query without validation",
"Not yet deployed to \"staging\" — promote there before releasing"
],
"blockingFindings": [
{
"id": "fnd_01JA8ZC1P3R5T7V9X1Z3B5D7F9",
"severity": "high",
"category": "security",
"title": "Coupon code is passed to the pricing query without validation",
"workflowRunID": "wfr_01JA8YQ4M2C7H5K9P3S6V8X1ZD",
"agentID": "security-auditor",
"filePath": "src/api/checkout.ts"
}
],
"testFailures": [],
"coverageShortfall": null,
"priorEnvironmentMissing": { "required": "staging" },
"requiredGatesPassed": true,
"missingRequiredWorkflows": []
}
API her iki sonuç için de HTTP 200 döndürür; bu yüzden durum kodu yerine allowed alanını okuyun. Her çağrı daha sıkı kontroller ayarlayabilir:
blockingSeverity: high ve critical bulguların yanı sıra medium bulgularda da engellemek için.minCoveragePct: kapsam bildiren en son çalıştırma için bir kapsam alt sınırı. Hiçbir çalıştırma kapsam bildirmediyse alt sınır kontrol edilemez ve değişiklik reddedilir.requiredWorkflows: bu değişiklik üzerinde tamamlanmış olması gereken iş akışları.requireDeployedTo: değişikliğin hâlihazırda dağıtılmış olması gereken bir ortam.blockOnInFlight: değişikliğe ait bir oturum hâlâ çalışırken reddetmek için.
Kapı varsayılan olarak son 14 günün çalıştırmalarına bakar. Hakkında hiçbir oturum bulamadığı bir değişiklik geçirilmez, reddedilir: kapının değerlendirecek bir şeyi yoktur. Aynısı test kanıtı için de geçerlidir. Kodu değiştiren bir oturumun sayıları içeren bir test sonucuna ihtiyacı vardır. Hiçbir test çalışmadıysa veya test komutu sayı bildirmediyse, projede Don't run tests for this project seçeneği açık olmadıkça yayın kapısı değişikliği reddeder.
Nasıl yapılandırılır
Yerleşik kontroller her çalışma alanında açıktır ve her oturum için aynıdır. Policies sayfası (Secure altında) bunların üzerine kendi kurallarınızı ekler. Her kural; bir iş akışını başlatma, bir yol altındaki dosyaları değiştirme veya pull request açma gibi bir eyleme izin verir, bunun için onay ister ya da bunu reddeder. Hiçbir kural eşleşmediğinde ne olacağına bir güven ayarı karar verir. Her deny veya ask kararı günlüğe kaydedilir.
Kimin onay verebileceği ve triyaj yapabileceği rollerle belirlenir; roller, denetim günlüğüyle birlikte yönetişim sayfasında anlatılır. Onay, her oy ve kapı sonucu, değişikliğin imzalı kanıt paketine girer.
Sık sorulan sorular
Başarısız bir kapı merge işlemini engelleyebilir mi?
Evet, AI CodeOps aracılığıyla yapılan değişiklikler için. Kapı geçilene kadar bir oturumun değişikliği pull request olarak açılmaz ve konsol onu merge etmez. Doğrudan Git platformunuzda yapılan merge işlemleri ise yalnızca CI'ınız kapı API'sini çağırır ve ret durumunda işi başarısız kılarsa engellenir.
Bir projede hiç test yoksa ne olur?
Projenin ayarlarından "Don't run tests for this project" seçeneğini açın. Bu yapılmazsa yayın kapısı, sayıları içeren bir test sonucu olmayan kod değişikliğini reddeder; çünkü kanıt yokluğu, geçti anlamına gelmez. Değişikliğin yine de temiz bir bulgu incelemesine ve bir onaya ihtiyacı vardır.
Yapay zekânın ürettiği kendi değişikliğimi onaylayabilir miyim?
Çalışma alanında onu onaylayabilecek başka biri varsa hayır. Başka bir onaylayıcı varken oturumu başlatan kişi onay oyunu kullanamaz. Tek başınıza mı çalışıyorsunuz? Tek onaylayıcısı olan bir çalışma alanı kendi değişikliklerini onaylar ve denetim izi bunları kendi kendine onaylanmış olarak işaretler.
Engelleyici bir bulguyu nasıl kaldırırım?
Düzeltin ya da triyajdan geçirin. Bir bulgu fixed, won't fix, false positive veya duplicate olarak işaretlendiğinde artık engellemez. Yüksek (high) veya kritik (critical) önem derecesindeki open, acknowledged ve in progress durumundaki bulgular ise engeller.
CI pipeline'ım kapıdan bir karar isteyebilir mi?
Evet. /api/release/check adresini bir çalışma alanı API anahtarı ve bir pull request URL'si veya commit SHA'sı ile çağırın. allowed alanı true veya false olan bir karar ve gerekçelerini döndürür.
Kapının kendisi hata verirse ne olur?
Değişiklik reddedilir. AI CodeOps'taki her kapı hata durumunda kapalı kalır; dolayısıyla kontrol sırasındaki bir hata bir değişikliğin geçmesine asla izin vermez.