AI / Ajan Sistemleri
Ajanları İzlenebilir Kılmak: The Delegation ve 3D Ofisteki Yapay Zeka Ekibi
Çoklu ajan sistemleri genelde bir log dosyasında yaşar. The Delegation onları tarayıcıda 3D bir ofise koyuyor: ajanlar masaya oturuyor, iş devrediyor ve kritik adımda senden onay istiyor.
Çoklu ajan sistemleriyle çalışırken en büyük zorluk teknik değil, algısal: ne olduğunu göremiyorsun. Beş ajan bir görevi paylaşıyor, aralarında iş devrediyor, biri diğerinin çıktısını bekliyor — ve sen bunu ancak bir terminal logunda satır satır takip ediyorsun.
The Delegation bu problemi alışılmadık bir yerden çözmeye çalışıyor: ajanları 3D bir ofise yerleştiriyor. Tarayıcıda açılan simülasyonda ajanlar birer karakter olarak yürüyor, masalara oturuyor, bilgisayar başında çalışıyor ve konuşma balonlarıyla iletişim kuruyor. Kendi tanımıyla “Agentic AI sistemlerini keşfetmek, tasarlamak ve onlarla etkileşmek için no-code 3D oyun alanı”.
Proje künyesi
Projeyi Arturo Paracuellos (unboring.net) geliştiriyor. İlginç bir detay: geliştirici, bu sürümün tamamen Google Antigravity ana IDE olarak kullanılarak ve Gemini 3 Flash ile geliştirildiğini belirtiyor.
| Özellik | Değer |
|---|---|
| Geliştirici | Arturo Paracuellos (arturitu) |
| Sürüm | v0.2.0 |
| Yıldız | ~570 |
| Fork | ~105 |
| Ana dil | TypeScript |
| Model sağlayıcı | Gemini API (BYOK) |
| Lisans | Kod MIT, 3D varlıklar CC BY-NC 4.0 |
Rakamlar Temmuz 2026 itibarıyla. Listedeki diğer repolara göre küçük bir proje ama yaptığı şey tek: ajan davranışını görünür kılmak.
Ajan katmanı: ekibi nasıl kuruyorsun?
İşin no-code kısmı burada. React Flow üzerine kurulmuş bir Team Editor var; ajanları ve aralarındaki iş akışını node’larla bağlıyorsun. Sıfırdan başlamak istemezsen hazır altı ekip şablonu geliyor — Creative Agency, Film Studio ve PR Agency bunlardan üçü.
- Ajan başına model ataması: her role farklı bir Gemini modeli verebiliyorsun. Hız isteyen role Flash, muhakeme isteyen role Pro.
- PR tarzı iş akışı: işaretlediğin ajanlar çıktı üretince duruyor ve senin onayını bekliyor. Tıpkı bir pull request gibi inceleyip geçiriyorsun.
- “Auto-approve output” anahtarı: onay kapısını tamamen kapatmak istersen var, ama açık bırakmak asıl güvenlik mekanizması.
- Maliyet ve token takibi: hangi ajanın ne kadar harcadığını görüyorsun.
- Teknik loglar: ham izler ve araç çağrıları açıkta — görsel katman bilgiyi saklamıyor, üstüne bir katman ekliyor.
Çok kipli üretim
Ajanlar sadece metin üretmiyor. Görsel için Nano Banana, müzik için Lyria 3, video için Veo 3.1 bağlı. Yani bir Film Studio şablonunda ajanlar gerçekten senaryo yazıp görsel ve video üretebiliyor.
Simülasyon katmanı: teknik taraf
Görsel kısım gerçek bir 3D motor işi ve teknik olarak listedeki en ilginç parça. Hibrit bir GPU/CPU mimarisi üzerinde Three.js’in WebGPU hattı çalışıyor (shader tarafında TSL kullanılıyor).
| Bileşen | Ne yapıyor |
|---|---|
| NavMesh yol bulma | three-pathfinding ile karakterler ofiste engellere çarpmadan yürüyor |
| Points of Interest | Ajanlar masa ve bilgisayar gibi noktaları “sahipleniyor”, ikisi aynı masaya oturmuyor |
| Durum makinesi | Yürüme, oturma, çalışma ve konuşma durumları arasında geçiş |
| 3D konuşma balonları | Ajanlar arası iletişimi sahnede gösterir |
| Agent Inspector | Bir ajana tıklayıp “düşüncelerini” okuyabiliyorsun |
| Kanban ve aksiyon logları | 3D sahnenin üstüne 2D durum katmanı bindiriyor |
Teknoloji yığını: Three.js (WebGPU + TSL), React, React Flow, durum yönetimi için Zustand, çıkarım için Gemini API, Blender’da hazırlanmış modeller ve instanced animasyon sistemi, TypeScript, Vite.
Nasıl çalıştırılır?
İki yol var: barındırılan demoyu kullanmak veya lokalde çalıştırmak. Her ikisinde de kendi Gemini API anahtarını getirmen gerekiyor (BYOK).
- 1Google AI Studio üzerinden bir Gemini API anahtarı al.
- 2Hızlı denemek istiyorsan doğrudan canlı demoyu aç ve anahtarını gir.
- 3Lokalde çalıştıracaksan repoyu klonla.
- 4npm install ile bağımlılıkları kur.
- 5npm run dev ile geliştirme sunucusunu başlat.
- 6Tarayıcıda açılan adrese git — genelde http://localhost:3000/the-delegation.
- 7Bir ekip şablonu seç, ajanlara model ata ve onay kapısını açık bırakarak ilk görevi başlat.
Lisansta dikkat edilmesi gereken nokta
Bu proje ikili lisans kullanıyor ve bunu ticari bir işte kullanacaksan bilmen gerekiyor:
| Kapsam | Lisans | Ne demek |
|---|---|---|
| Kaynak kod (mantık, shader, arayüz) | MIT | Serbestçe kullanabilir, değiştirebilir ve dağıtabilirsin |
| 3D modeller ve varlıklar | CC BY-NC 4.0 | Kişisel ve eğitim amaçlı kullanım serbest; ticari kullanım için izin gerekiyor |
Yol haritası
- Ofis ve 3D mekân editörü
- Ajanların ortamı kendi değiştirebilmesi
- Daha derin bedenlenmiş (embodied) yapay zeka ve zengin animasyonlar
- İnsan ile ajan arasında mekânsal etkileşim
- Projeler arası uzun vadeli bellek
- Mimarinin ayrıştırılması ve arayüz yenilemesi
Kimin için mantıklı?
Bu, üretim iş yükü koşturacağın bir orkestrasyon çerçevesi değil. Değeri anlatım ve öğretimde: bir ekibe veya müşteriye çoklu ajan sistemlerinin nasıl çalıştığını göstermek, bir tasarım kalıbını denemek, ya da onay kapılarının neden gerektiğini tartışmak için elinde somut bir şey oluyor.
Ben bunu bir “vitrin” aracı olarak faydalı görüyorum. Ajan mimarisini yazıyla anlatmak zor; birinin ekranda bir ajanın diğerini beklediğini görmesi çok daha hızlı iş görüyor.