Yapay zeka ajan iş akışı denince çoğu kişi tek bir ajana uzun bir görev verip sonucu beklemeyi düşünür. Küçük işlerde bu yeterli. Ama “ödeme modülünü yeni sağlayıcıya taşı” gibi büyük bir işte tek ajan hem araştırır, hem planlar, hem uygular; bağlam şişer, plan hiç görünmez ve hata ancak kod yazıldıktan sonra fark edilir.
Bu yazıda işi üç aşamaya bölen bir hattı anlatıyorum: araştır, planla, geliştir. Her aşamayı ayrı bir ajan yürütür, aşamalar dosyalarla teslimleşir ve plan uygulamaya geçmeden önce senin onayından geçer.
Neden aşamalı bir yapay zeka ajan iş akışı?
Tek ajanlı bir oturumun sorunları:
- Bağlam büyür. Araştırma sırasında okunan her dosya uygulama aşamasında da bağlamda kalır.
- Plan görünmez. Ajan ne yapacağına karar verip doğrudan kodlamaya geçer.
- Hata geç fark edilir. Yanlış bir varsayım ancak testler patlayınca ortaya çıkar.
Aşamalı bir hat bunları ayrı ajanlara böler. Araştırmacı kod yazmaz, planlayıcı yalnızca plan yazar, geliştirici planı uygular. Her biri kendi küçük bağlamıyla çalışır.
Üç aşama ve teslim dosyaları
| Aşama | Ajan | Çıktı | Kural |
|---|---|---|---|
| Araştır | Araştırmacı | 01-arastirma.md | Kod yazmaz, mevcut durumu ve seçenekleri raporlar |
| Planla | Planlayıcı | 02-plan.md | Hedef, kapsam dışı, dosyalar, adımlar, test stratejisi, kabul kriterleri |
| Geliştir | Geliştirici | Kod ve testler | Planı uygular, testleri çalıştırır |
Teslim dosyaları neden önemli? Çünkü bir sonraki ajan önceki ajanın bütün konuşmasını değil, yalnızca sonucunu okur. Plan dosyası aynı zamanda senin için de bir belgedir: geliştirme başlamadan ne yapılacağını okursun.
AgentVera bu dosyaları .agentvera/handoff/<tarih>-<konu>-<id>/ altına yazar. Klasör git’in yerel exclude dosyasıyla dışarıda tutulur, yani deponda değişiklik olarak görünmez.
Aşamalar ne zaman ilerler?
Hattın en kritik parçası geçiş kuralıdır. Bir ajan yarıda “Hangi veritabanını kullanalım?” diye sorabilir. Bu soru bir sonraki aşamayı tetiklememeli.
Bu yüzden bir aşama, ancak ajanın yanıtı [[TESLİM]] işaretiyle bittiğinde ilerler. Bunu bir regex koşul düğümü kontrol eder. Ajan işini bitirmeden sorduğu sorular akışı ilerletmez; sen yanıtlarsın, ajan devam eder.
Onay adımı
Plan geliştiriciye gitmeden önce okumak, hattın en değerli anıdır. Yanlış bir plan burada beş dakikada düzelir; kod yazıldıktan sonra saatler sürer.
AgentVera’da “Plan geliştiriciye gitmeden önce onayımı al” seçeneği varsayılan olarak açıktır. Hatta bir insan onayı düğümü eklenir. Onay bekleyen adım durum çubuğunda listelenir. Telegram bildirimleri açıksa onayı telefondan da verebilirsin.
Hattı adım adım kurmak
AgentVera’daki Araştır → Planla → Geliştir hattı bu yapıyı tek pencerede kurar:
- ⌘K komut paletinden hattı aç ya da Detaylar → Akışlar’daki düğmeyi kullan.
- Konu / hedef alanına işi yaz. Ne kadar net yazarsan araştırmacı o kadar odaklı çalışır.
- Her aşama için bir araç seç: Claude Code, Codex ya da desteklenen başka bir CLI.
- Onay seçeneğini açık bırak.
- Oluştur ve başlat’a bas. Üç ajan oluşturulur, panellere yerleşir ve akış başlar.
Akış bittiğinde bir bildirim düğümü haber verir. Hattı daha sonra Detaylar → Akışlar’da düzenleyebilirsin; örneğin geliştiriciden sonra bir inceleme adımı ekleyebilirsin.
İyi bir hedef nasıl yazılır?
Araştırmacının ilk girdisi senin yazdığın hedeftir. İyi bir hedef:
- Sonucu tarif eder: “Ödeme sağlayıcısını X’ten Y’ye taşı, mevcut API sözleşmesi değişmesin.”
- Sınırları söyler: “Fatura modülüne dokunma.”
- Başarıyı tanımlar: “Mevcut ödeme testleri geçmeli, yeni sağlayıcı için entegrasyon testi eklenmeli.”
“Ödemeleri iyileştir” gibi bir hedef ise araştırmacıyı bütün kod tabanını okumaya iter.
Hattı kendi akışınla genişletmek
Üç aşamalı hat bir başlangıç noktasıdır. Akışlar üzerinde aynı yapıyı genişletebilirsin:
- Koşul düğümü: Yanıtta belirli bir ifade varsa farklı bir yola sap.
- Dönüştür düğümü: Bir sonraki ajana yalnızca son kod bloğunu ya da ilk N satırı gönder.
- Bekleme: İki adım arasında süre bırak.
- Bildirim: Önemli adımlarda haber al.
- Tur sınırı: Döngüye giren bağlantıları otomatik durdur.
Örnek: ödeme sağlayıcısı geçişi
Hattın gerçek bir işte nasıl ilerlediğini düşünelim. Hedef: “Ödeme sağlayıcısını X’ten Y’ye taşı; mevcut API sözleşmesi değişmesin, fatura modülüne dokunma.”
Araştırma aşaması
Araştırmacı kod yazmaz. Mevcut ödeme modülünü okur, X sağlayıcısının nerelerde kullanıldığını listeler, Y’nin karşılık gelen kavramlarını eşleştirir ve riskleri not eder. Çıktısı 01-arastirma.md dosyasıdır: hangi dosyalar etkilenecek, hangi davranışlar korunmalı, hangi sorular açık.
Araştırmacı açık bir soruyla karşılaşırsa, örneğin “İade akışı da taşınacak mı?”, bunu sorar. Yanıtı [[TESLİM]] ile bitmediği için akış ilerlemez; sen yanıtlarsın, araştırmacı raporunu tamamlar.
Plan aşaması
Planlayıcı yalnızca araştırma dosyasını okur. Konuşmanın tamamını taşımadığı için bağlamı küçüktür. 02-plan.md dosyasına hedefi, kapsam dışını, değişecek dosyaları, adımları, test stratejisini ve kabul kriterlerini yazar.
Onay
Plan sana gelir. Burada en sık yakalanan sorunlar:
- Kapsam dışı bırakılması gereken bir modülün plana girmesi.
- Test stratejisinde mevcut testlerin unutulması.
- Adımların sırası: önce arayüz, sonra uygulama gibi.
Düzeltmeni yazıp onaylarsın ya da reddedersin. Reddettiğinde akış durur; planlayıcıya düzeltme isteyip tekrar başlatabilirsin.
Geliştirme aşaması
Geliştirici onaylanan planı uygular ve testleri çalıştırır. Plan net olduğu için kapsam dışına taşmaz. İş bittiğinde bildirim gelir; değişiklikleri incelemek için otomatik kod incelemesini açtıysan bulgular da hazırdır.
Hat ne zaman fazla gelir?
Üç aşama her iş için gerekli değil. Tek dosyalık bir düzeltme, bir yazım hatası ya da küçük bir stil değişikliği için hat kurmak, işten uzun sürer. Kabaca kural: değişiklik birden fazla modüle dokunuyorsa, belirsizlik varsa ya da yanlış bir varsayımın maliyeti yüksekse hat kur; değilse tek ajanla ilerle.
Hattı zamanlamak ve uzaktan yönetmek
Uzun süren hatları bilgisayar başında beklemek zorunda değilsin. Birkaç yardımcı özellik:
- Telegram bildirimleri: Plan onayını telefondan verebilir, bir bildirime yanıt yazarak metni ilgili ajana iletebilirsin.
- Zamanlanmış görevler: Bir ajana cron ifadesiyle düzenli mesaj gönder; örneğin her sabah bağımlılık güncellemesi için araştırma başlat.
- Uykuyu engelle: Ajan çalışırken bilgisayarın uykuya geçmesini engelleyen ayar, gece süren işlerin yarıda kalmasını önler.
Bu özellikler hattın kendisini değiştirmez ama onu bekleme yükünden kurtarır.
Kontrol listesi
- Hedef tek paragrafta, sonucu ve sınırları anlatıyor mu?
- Araştırmacıya kod yazmaması söylendi mi?
- Plan onayı açık mı?
- Geliştirici testleri çalıştıracak mı?
- Akış bitince haber alacak mısın?
Sonuç
Aşamalı bir yapay zeka ajan iş akışı, büyük işlerde ajanları daha öngörülebilir yapar. Araştırma ve plan ayrı dosyalarda durur, geliştirme planı okuduktan sonra başlar ve bağlam her aşamada küçük kalır.
AgentVera bu hattı tek tıkla kurar ve istediğin gibi genişletmeni sağlar. Ücretsiz planla başlayabilir, plan onayı gibi adımları uzaktan yönetmek için bildirimler ve onaylar sayfasına bakabilirsin.