- Ana sayfa
- Dokümantasyon
- Oturumlar
Oturumlar
AI CodeOps'ta yapay zekâ oturumu başlatın: görevi tarif edin, proje ve iş akışı seçin, ajanları canlı izleyin, diff'i inceleyin ve pull request açın.
Oturum, bir proje üzerindeki tek bir yapay zekâ işidir. Bir görevi tarif edersiniz; bir ajan ekibi onu planlar ve değişikliği yazar, testleriniz onun üzerinde çalışır, ardından ajanlar yazılanı inceler. Sonra sonucu siz inceler ve yayına alınıp alınmayacağına karar verirsiniz. Her şey platformda çalışır; siz tarayıcıda izlersiniz.
Bir oturum başlatın
- Develop → AI Sessions sayfasını açın ve New session düğmesini seçin.
- Start an AI session formunu doldurun (alanlar aşağıdadır).
- Start session düğmesini seçin. Oturum kuyruğa girer ve listede görünür.
Formun alanları:
- What should the session do? Görevi düz sözcüklerle tarif edin; örneğin "Genel API'ye istek limiti ekle ve bunun için testler yaz."
- Workflow: ajanların nasıl çalışacağı. Varsayılan olan Plan, Build, Review & Test çoğu değişikliğe uyar. Bkz. Ajanlar ve iş akışları.
- Project: zorunlu. Yapay zekânın ürettiği kod her zaman bir projeye aittir.
- Model tier veya Model: hangi modellerin kullanılacağı. Bkz. Modeller ve kademeler.
- File context (optional): ajanların önce okuması gereken, virgülle ayrılmış yollar.
Bir projenin sayfasından Run workflow ile de oturum başlatabilirsiniz.
Bir değişiklik ne kadar büyük olabilir
Bir oturumun değişikliği, bir insanın inceleyebileceği kadar küçük olmalıdır:
- diff'i en fazla 60 KB olabilir;
- en fazla 25 dosyayı değiştirebilir; her dosya en fazla 64 KB olabilir.
Daha büyük bir değişiklik bütünüyle reddedilir, asla kesilmez: oturum "The change is too large to review" mesajıyla sona erer ve boyutun çoğunu oluşturan dosyaları belirtir. Görevi daha küçük görevlere bölün.
Bir oturum, değiştirdiği her dosyayı baştan sona yeniden yazar ve uzun bir dosyanın yalnızca başı ona gösterilir. Hiç görmediği satırları silecek bir yeniden yazım dosyaya yazılmaz: oturuma o dosyaların tamamı verilir ve bir kez daha dener; sonuç yine o satırları siliyorsa oturum, gerekçesiyle birlikte sona erer. Bu durumda daha dar bir değişiklik isteyin veya dosyanın değiştirilecek kısmını belirtin.
Canlı izleyin
Oturum sayfası, oturum çalışırken güncellenir. Her adımı (hangi ajan, ne yapıyor, durumu) ve oturumun maliyetini ve token'larını biriktikçe görürsünüz. AI Sessions altındaki liste her oturumu projesi, süresi, maliyeti ve durumuyla birlikte, değişiklik veya bulgu üreten oturumlar için de rozetlerle gösterir.
Bir oturumu durdurmak için Cancel session düğmesini seçin ve bir gerekçe yazın. Gerekçe oturuma kaydedilir ve sayfasında gösterilir.
Sonucu inceleyin
Oturum bittiğinde sayfası şunları gösterir:
- Summary: ajanların ne yaptığı, son adımın sözcükleriyle. İş akışında Review ve Test gibi kodu izleyen adımlar varsa özet, testleriniz çalıştıktan sonra yazılır. Testler hakkında söyledikleri kaydedilen sonuçla çelişiyorsa, üzerindeki bir uyarı bunu belirtir.
- Proposed changes: diff ve bir
.patchindirme seçeneği. İsteğiniz dosyalar belirttiyse ve değişiklik bunlardan bazılarına dokunmadıysa bir not bunları listeler. - Quality gates: test sonuçları ve değişikliğin yayına hazır olup olmadığı. Bkz. Kalite kapıları.
- Findings: incelemenin bulduğu sorunlar, önem derecesi ve dosyasıyla birlikte.
Kod yazan her oturum ayrıca Develop → Changes altında da listelenir; onu orada öneriden incelemeye, merge'e ve dağıtıma kadar izleyebilirsiniz.
Değişiklik isteyin
İyileştirmeler veya bunun üzerine inşa eden bir sonraki görevi istemek için oturum sayfasındaki Follow-up prompt kutusunu kullanın. Send follow-up düğmesini seçin; takip, oturumun bağlamından devam eder. Takip oturumunun sayfası özgün Task alanını ve onun altında Latest request (follow-up N) alanını gösterir. Bir oturum hâlâ çalışırken bir takip, yeni ve bağlantılı bir oturum başlatır; çalışmakta olan oturum değişmeden devam eder.
Re-run, aynı görevi baştan yeniden başlatır.
Onaylayın ve pull request açın
Kodu değiştiren bir oturum Review & Gate → Approvals sayfasında bir inceleme açar. Oturum sayfasında Accept changes veya Reject düğmesini seçin. Çalışma alanında onay verebilecek başka biri varsa oturumu başlatan kişi onu onaylayamaz. Bkz. Onaylar ve politikalar.
Değişiklik onaylanıp kalite kapılarından geçtiğinde AI CodeOps pull request'i sizin için açar: projenin reposunda, varsayılan branch'ine yönelik yeni bir codeops/run-<id> branch'i. Create Pull Request düğmesini kendiniz de seçebilirsiniz. Düğme kilitliyse neyin eksik olduğunu açıklar; örneğin Connect git to open PR veya Add a repository to open PR.
Sizin onayınız olmadan hiçbir şey merge edilmez.
Terminal
Develop → Terminal (beta), etrafa bakmak veya kendiniz bir komut çalıştırmak istediğinizde, bir projenin kök dizininde kendi yalıtılmış sandbox'ı içinde bir kabuk açar. Komutlar asla platformun kendi sunucularında çalışmaz. Kullanılabilirlik planınıza bağlıdır.
Sonraki adımlar
Sık sorulan sorular
Bir oturum çalıştırmak için bir şey yüklemem gerekiyor mu?
Hayır. Oturumlar bulutta çalışır ve onları tarayıcıda izlersiniz. CLI veya yerel kurulum yoktur.
Bir oturumun sonucunu onaylamadan önce değiştirebilir miyim?
Bir takip prompt'uyla değişiklik isteyebilirsiniz. Değişikliği onaylandıktan sonra düzenlemek onayını sıfırlar; dolayısıyla yeniden onaylanması gerekir.