Panel: Ajanların Kendi Arayüzlerini Geliştirdiği Açık Kaynaklı Araştırma Alanı

Panel, yapay zeka ajanlarının araştırmacıyla etkileşimli biçimde yan yana çalıştığı, sohbeti, dosyaları, PDF'leri ve Jupyter notebook'ları tek bir dock üzerinde toplayan açık kaynaklı bir çalışma alanıdır. En dikkat çekici özelliği, yerleşik arayüzlerin yetersiz kaldığı senaryolarda ajanın ihtiyaç duyulan özel görsel panelleri ve mini uygulamaları dinamik olarak kendisinin inşa edebilmesidir (Generative UI). Henüz erken test aşamasında olan bu proje, otonom ajanların yazılım geliştirme ve araştırma iş akışlarına entegrasyonu açısından önemli pratik çıkarımlar sunmaktadır.

Başlamadan Önce (Gereksinimler)

Node.js: 22.18 veya daha yeni sürüm (ya da 24.12 ve üzeri).
pnpm: Paket yöneticisi.
uv: Gerekli Python sürümünü (3.12+) kendi yöneten paket ve ortam aracı.
Claude Code: Sistemde kurulu ve oturumu açık olmalı (claude komutuyla giriş yapılır; ajan ve literatür taraması bu altyapı üzerinden yürütülür).

Kurulum ve Başlatma

Projeyi ayağa kaldırmak için terminalde sırasıyla pnpm install, uv sync ve pnpm start komutları çalıştırılır. İlk çalıştırmada uygulama önce derlendiğinden açılış yaklaşık bir dakika sürebilir. Ardından tarayıcıda http://localhost:4173 adresi açılır. Başlatılan tüm süreçler Ctrl-C ile durdurulabilir.

Verilerinizin Konumu

~/Panel/panel.db: Sohbet geçmişinizi ve ajanların gerçekleştirdiği tüm işlemleri saklar.
~/Panel/workspaces: Farklı bir dizin seçilmediği sürece yeni çalışma alanlarının oluşturulduğu yerdir. Her iki konum da proje klasörünün dışında tutulur; böylece deponun silinmesi veya yeniden klonlanması durumunda veriler kaybolmaz.

Çalışan Özellikler

İzin Odaklı Ajan: Dosya okuyup yazabilen ve herhangi bir araç çalıştırmadan önce kullanıcı onayı isteyen akıllı sohbet.
İzole Çalışma Alanları: Ajanın çalıştığı, kendine ait sohbet geçmişi ve kayıtlı panel düzeni bulunan klasörler.
Zengin Panel Desteği: Dosya, PDF, Markdown ve Jupyter notebook panelleri. Notebook'lar gerçek bir çekirdek (kernel) üzerinde çalışır ve kullanıcı ile ajan aynı anda düzenleme yapabilir.
Arka Plan Komutları: Arka planda çalıştırılabilen, gerçek zamanlı izlenebilen ve istendiğinde durdurulabilen uzun süreli terminal komutları.
Dinamik Panel Üretimi: Yerleşik panellerin gösteremediği özel bir veri istendiğinde ajanın sizin için anlık kodlayıp sunduğu arayüzler.
Literatür Taraması: Doğrudan sohbet üzerinden talep edilen ve oluşturulan araç kartı üzerinden incelenebilen akademik araştırma özelliği.

Henüz Desteklenmeyenler

Şu an için yalnızca Claude Code ile tam uyumlu çalışması.
Modüllerin yalnızca sohbet komutuyla tetiklenebilmesi (henüz bir başlatma butonu bulunmamaktadır).
Hipotez modüllerinin bağımsız bir görsel arayüzünün olmaması nedeniyle sonuçların okunmasının güç olması.
Modüllerin henüz OpenAI API desteğinin bulunmaması.

OpenAI Anahtarı (İsteğe Bağlı)

apps/server/.env.example dosyasını apps/server/.env yoluna kopyalayarak OPENAI_API_KEY tanımlayabilirsiniz. Bu ayar ajan seçiciye OpenAI API seçeneğini ekler; ancak web araması gerektiren literatür taraması ve hipotez modülleri yalnızca Claude Code ile çalışır.

Sorun Giderme

Sunucu Bağlantı Hatası: "Panel couldn't reach its server" uyarısı alındığında, pnpm start terminali kontrol edilmeli ve "Retry" butonuna basılmalıdır.
Ajanın Hazır Görünmemesi: Ajanın yapılandırılmama nedeni doğrudan mesaj kutusunun altında açıkça listelenir.
Port Çakışmaları: Port meşgulse veya uygulama yanıt verip yüklenmiyorsa, pnpm dev:doctor komutu çalıştırılarak portu tutan süreçler tespit edilip temizlenebilir.

Geliştirici ve Öğrenme Çıkarımı

Modern ajan mimarilerinde sadece metin tabanlı yanıt üretimi yerini araç kullanımı (Tool Calling) ve çalışma anında dinamik arayüz üretimine (Generative UI) bırakmaktadır. Panel, kullanıcı denetimli ajanların ve gerçek çekirdek üzerinde çalışan notebook'ların güvenli lokal mimarilerle nasıl birleştirilebileceğinin başarılı bir örneğidir.

Orijinal kaynağa buradan ulaşabilirsiniz.

Bu konuyu derinlemesine öğrenmek isterseniz: Tool Calling ve Multi-Step Agent'lar modülüne göz atın.