# Temel kavramlar

> AI CodeOps'un yapı taşları: kuruluşlar, çalışma alanları, projeler, ajanlar, iş akışları, oturumlar, bulgular, kapılar, onaylar, değişiklikler ve dağıtımlar.

Kaynak: https://aicodeops.dev/tr/docs/core-concepts · Son güncelleme: 2026-10-18

Bunlar AI CodeOps'un birlikte çalıştığı şeyler ve aralarındaki bağlantılardır. Her kayıt, onu konsolda nerede bulacağınızı söyler.

## Kuruluş

Çalışma alanlarının sahibi olan hesap; plan ve kullanıcı sayısı için de birim odur. Herkes ilk kez giriş yaptığında bir kuruluş alır. Kuruluşu **Configure → Settings → Organization & Teams** altında yönetin.

## Çalışma alanı

Ekibinizin çalıştığı yer: projeler, oturumlar, üyeler, roller ve ayarlar. Her çalışma alanı tek bir kuruluşa aittir. Çalışma alanları veritabanında birbirinden ayrı tutulur; dolayısıyla biri bir başkasının verilerini okuyamaz. Bkz. [Üyeler ve roller](https://aicodeops.dev/tr/docs/members).

## Proje

AI CodeOps'un üzerinde çalıştığı, genellikle bir Git reposuna bağlı bir kod tabanı. Bir tanımlayıcısı, bir türü, bir varsayılan branch'i ve bir test komutu vardır. Her oturum bir proje üzerinde çalışır. Projeleri **Plan → Projects** altında bulursunuz. Bkz. [Projeler](https://aicodeops.dev/tr/docs/projects).

## Ajan

Architect, Builder, Reviewer, Tester veya Security Auditor gibi, kendi talimatları olan bir yapay zekâ rolü. Bir iş akışının her adımını tek bir ajan çalıştırır. **Configure → Agents** altında kendi modeli, izinleri ve prompt'u olan kendi ajanlarınızı tanımlayabilirsiniz. Bkz. [Ajanlar ve iş akışları](https://aicodeops.dev/tr/docs/agents) ve [ajan sayfaları](https://aicodeops.dev/tr/agents).

## İş akışı

Her birini tek bir ajanın çalıştırdığı sabit bir adım listesi; örneğin Plan → Build → Review → Test. **Develop → Workflows** altında listelenen 16 yerleşik iş akışı vardır. Bkz. [İş akışları](https://aicodeops.dev/tr/docs/workflows).

## Oturum

Bir iş akışının tek bir görev ve tek bir proje üzerindeki tek bir çalıştırması. Konsolda bu, **Develop → AI Sessions** altındaki bir **AI session** kaydıdır. Bir oturum her ajan adımını, adımın token'larını ve maliyetini, ürettiği diff'i ve test sonucunu kaydeder.

Bir oturumun durumu şunlardan biridir: pending, running, completed, failed, canceled veya (bir politika ya da bütçe nedeniyle) blocked. Bir takip oturumu, üzerine inşa ettiği oturuma bağlanır.

## Bulgu

Yapay zekâ incelemesinin bir değişiklikte bulduğu bir sorun. Her bulgunun şunları vardır:

- bir **önem derecesi**: critical, high, medium, low veya info;
- security, quality, performance veya test coverage gibi bir **kategori**;
- bir **triyaj durumu**: open, acknowledged, in progress, fixed, won't fix, false positive veya duplicate.

Açık high ve critical bulgular değişikliği engeller. Bulgular oturum sayfasında ve **Build & Test → Quality** altında görünür. Bkz. [Çok ajanlı incelemeler](https://aicodeops.dev/tr/docs/multi-agent-reviews).

## Kalite kapısı

Bir değişikliğin yayına alınıp alınamayacağına karar veren kontrol. Bir değişiklik; incelemesi tamamlandığında, açık kalan high veya critical bulgusu olmadığında ve hiçbir testi başarısız olmadığında yayına hazırdır. Kapı, bir pull request açılmadan önce ve konsol bir pull request'i merge etmeden önce çalışır. CI'ınız aynı soruyu yayın kapısı üzerinden sorabilir. Bkz. [Kalite kapıları](https://aicodeops.dev/tr/docs/quality-gates) ve [CI'da yayın kapısı](https://aicodeops.dev/tr/docs/release-gate-ci).

## Onay

Bir insandan evet ya da hayır demesini isteyen bir talep. AI CodeOps, bir oturumun önerdiği her kod değişikliği ve politikanızın ask olarak işaretlediği eylemler için bir onay talebi açar. Her birinin bir durumu vardır: pending, approved, rejected, expired veya canceled. Bunlar hakkında **Review & Gate → Approvals** altında karar verin. Bkz. [Onaylar ve politikalar](https://aicodeops.dev/tr/docs/approvals-and-policies).

## Değişiklik

Öneriden canlı ortama kadar iş birimi. Bir değişiklik; onu yapan oturumu, onayını, pull request'ini, dağıtımını ve varsa olayını birbirine bağlar. Durumu ileriye doğru hareket eder:

| Durum     | Anlamı                                       |
| --------- | -------------------------------------------- |
| proposed  | Bir oturum üzerinde çalışmaya başladı.       |
| in review | Oturum kod üretti; değişiklik onay bekliyor. |
| approved  | Bir insan onayladı.                          |
| merged    | Pull request'i konsoldan merge edildi.       |
| deployed  | Bir dağıtımı başarılı oldu.                  |
| abandoned | Oturum başarısız oldu veya iptal edildi.     |

Değişiklikleri **Develop → Changes** altında bulursunuz.

## Kanıt paketi

Tek bir değişikliğin nasıl yapıldığının imzalı kaydı: görev, modeller, onaylar, politika kararları, bulgular, testler ve teslim. Onu bir değişikliğin sayfasından indirin ve tarayıcıda veya çevrimdışı olarak doğrulayın. Bkz. [Kanıt paketleri](https://aicodeops.dev/tr/docs/evidence-packs).

## Dağıtım

Bir projenin bir sürümünün bir ortama gittiğinin kaydı. Bir durumu (queued, in progress, succeeded, failed, rolled back veya canceled), bir commit'i veya sürümü ve onu üreten oturumu vardır. Dağıtımları **Release → Deployments** altında bulursunuz. Bkz. [Kapı denetimli dağıtımlar](https://aicodeops.dev/tr/docs/gated-deploys).

## Sonraki adımlar

- [AI CodeOps nasıl çalışır](https://aicodeops.dev/tr/docs/how-it-works)
- [Bir oturum başlatın](https://aicodeops.dev/tr/docs/sessions)
- [Açık beta SSS](https://aicodeops.dev/tr/docs/open-beta-faq)

## Sık sorulan sorular

### Oturum ile iş akışı aynı şey mi?

Hayır. İş akışı tariftir, yani sabit bir ajan adımları listesidir. Oturum ise bir iş akışının tek bir görev ve tek bir proje üzerindeki tek bir çalıştırmasıdır.

### Oturumu bittikten sonra bir değişikliği nerede bulurum?

Develop → Changes altında. Bir değişiklik, işi öneriden incelemeye, merge'e ve dağıtıma kadar izler.

### AI CodeOps kodumu dağıtır mı?

Hayır. Sizin ayarladığınız bir dağıtım webhook'unu çağırır ve dağıtımı kaydeder. Dağıtımı kendi pipeline'ınız yapar.
