Katlar, ajanlar ve terminaller: üç temel kavram

Agent X'te üç kavram var: kat, ajan ve terminal. Programı anlamanın en kısa yolu bu üçünü ayırt etmek. Bu yazı her birinin ne olduğunu, birbirine nasıl bağlandığını ve nerede sınırlandığını anlatıyor.

Kat = proje

Her proje, ofis binasının bir katıdır. Katta 12 masa vardır; bir ajan eklediğinde ajan bir masaya oturur. Kat panelinde kaç masanın dolu olduğunu, ekibi ve ajan ekleme düğmesini görürsün. Bina görünümünde katlar üst üste durur, böylece birden çok projeyi tek ekranda izlersin.

Ajan = rolü olan çalışan

Ajanın bir rolü ve bir motoru vardır. Motor Claude ya da Codex olur (hesabı bağlama). Rol, ajanın ne iş yapacağını belirler. "Ajan ekle" ekranındaki rol listesinde şunlar gibi roller var:

• Takım Lideri: işi böler, ajanlara dağıtır ve sana raporlar.
• Backend ve Frontend geliştirici: kodu yazar.
• UI/UX tasarımcı: arayüzü tasarlar.
• QA / Test: gerçek tıklama testi yapar, hata kaydı tutar.
• YouTube Yöneticisi ve Trendyol Yöneticisi: her sabah özet hazırlar, cevap taslağı yazar (YouTube ve Trendyol ajanları).
• Stüdyo Yaratıcı: görsel ve video üretimini yürütür (Stüdyo).

Tek tek ajan eklemek yerine hazır bir ekip şablonu da seçebilirsin; örneğin lider ve bir Trendyol ajanından kurulan "E-ticaret (Trendyol)" şablonu var. Görev verdiğinde ajan çalışırken masasında görünür; durumu (çalışıyor, onay bekliyor, toplantıda, hata) ofis ekranında ayrı ayrı sayılır. Bir ajan işi başka bir ajana devredebilir; bunu en çok lider yapar.

Terminal = ajanın gerçek çalışma yeri

Ajanın terminalini açtığında ona komut yazabilir, durumunu sorabilir ve canlı çıktıyı izleyebilirsin. Ajan ne yapıyorsa terminalde görürsün: komutlar, çıktılar, ilerleme. Bu, kara kutu bir sohbet değil; ekibin ortak çalışma alanı.

Bu örnekte ajana durum yazarak ne yaptığı soruldu, ata ile yeni görev verildi, gorevler ile liste görüldü.

Üçü birlikte nasıl akar

1. Bir proje için kat açarsın.
2. Kata ajan eklersin: lider ve ihtiyacın olan roller masalara oturur.
3. İşi lidere (ya da doğrudan bir ajana) verirsin; ajan terminalinde çalışmaya başlar.
4. Ajan dışarıya çıkan bir adım atmak isterse Kararlar ekranına bir onay kartı düşer; sen "Evet" ya da "Hayır" dersin.
5. İş bitince ajan bir rapor bırakır.

Akışın tamamını örnekle Ajan ekibi nasıl çalışır? yazısında bulursun.

Görev bitince: rapor

Her görev bir sonuç raporu bırakır: hüküm, ne yapıldığı ve kanıt; riskler de rapora yazılır. Raporu ofis ekranından açıp okuyabilir, sonradan Raporlar ekranında yeniden bulabilirsin. Rapor, ajanın "bitti" demesinin yetmediği yerde kanıtı gösterir.

Hafıza, zamanlama ve maliyet

• Hafıza: ajanlar proje hakkında öğrendiklerini saklar; bir sonraki işte aynı şeyi yeniden anlatmak zorunda kalmazsın.
• Zamanlama: tekrar eden işler (her sabah 09:00'da özet gibi) zamanlama ekranından kurulur, kapatılır ya da hemen çalıştırılır.
• Maliyet: hangi ajanın ne kadar token harcadığı Maliyet ekranında görünür.

Terminal sayısı ve plan limitleri

Aynı anda açabileceğin terminal sayısı planına bağlıdır: Lite 3, Pro 5, Max sınırsız. Bu sayı aynı anda kaç ajanın terminalde çalışabileceğini sınırlar. Kaç bilgisayarda kullanabileceğin de plana göre değişir: Lite 1, Pro 2, Max sınırsız. Ayrıntı için Planlar ve lisans yazısına bak.

Bir örnek kurgu

Aşağıdaki gerçek bir müşteri hikâyesi değil, kavramları oturtmak için uydurulmuş bir örnektir. Bir mağaza sahibi iki proje yürütüyor: biri web sitesi, biri e-ticaret. Web sitesi katında lider, frontend ve QA ajanı oturuyor; e-ticaret katında bir Trendyol ajanı var. Sahibi bina görünümünde iki katı birlikte izliyor, web sitesi katındaki bir ajanın terminalini açıp ne yaptığına bakıyor ve e-ticaret katında sabah özetini raporlardan okuyor. İki proje birbirine karışmaz, çünkü her biri kendi katında ve kendi masalarında çalışır.

Küçük ipuçları

• Küçük bir iş için tek ajan yeter; ekip kurmak ek koordinasyon ve ek token demektir.
• Bir projede çok sayıda ajan varsa lideri kullan: parçaları o dağıtır ve tek bir rapor sana gelir.
• Terminalde bir şey anlamadıysan ajana durum yaz; ne yaptığını anlatır.

Sonraki adım

Henüz kurmadıysan Kurulum ve ilk giriş yazısındaki üç adımı izle. Programın genel fikri için Agent X nedir? yazısı var.