# AI CodeOps nasıl çalışır

> 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.

Kaynak: https://aicodeops.dev/tr/docs/how-it-works · Son güncelleme: 2026-10-18

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](https://aicodeops.dev/tr/docs/projects) 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](https://aicodeops.dev/tr/docs/cost-controls).
- **Ç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](https://aicodeops.dev/tr/docs/approvals-and-policies).

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:

1. **Plan**: [Architect](https://aicodeops.dev/tr/agents/architect) çalıştırır.
2. **Build**: [Builder](https://aicodeops.dev/tr/agents/builder) çalıştırır.
3. **Review**: [Reviewer](https://aicodeops.dev/tr/agents/reviewer) çalıştırır.
4. **Test**: [Tester](https://aicodeops.dev/tr/agents/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ı](https://aicodeops.dev/tr/docs/workflows) 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ı](https://aicodeops.dev/tr/docs/quality-gates) 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](https://aicodeops.dev/tr/docs/multi-agent-reviews).

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:

1. çalışma alanı politikası;
2. onay;
3. [kalite kapısı](https://aicodeops.dev/tr/docs/quality-gates): 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](https://aicodeops.dev/tr/docs/git/permissions-and-scopes) 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](https://aicodeops.dev/tr/docs/gated-deploys).

## 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

- [Temel kavramlar](https://aicodeops.dev/tr/docs/core-concepts)
- [Oturumlar](https://aicodeops.dev/tr/docs/sessions)
- [Kalite kapıları](https://aicodeops.dev/tr/docs/quality-gates)

## 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.
