Proje yönetimi

Projeler, platformdaki ana çalışma birimidir: tek bir sohbet ürününün tüm parçaları — LLM varsayılanları, tahta grafiği, ajanlar, proje düzeyi araçlar, gelen kutusu bağlantıları — burada toplanır.

Bu sayfa, BoardLayout bileşeninin birleştirdiği ekranları soldan sağa anlatır: kenar çubuğu, tuval, detay panelleri, test ve AI Builder.

Proje listesi (/projects)

• Kart veya liste görünümünde org’unuzdaki tüm projeler.
• Oluşturma çoğu kurulumda ORG_ADMIN + abonelik projects limitidir; üye kullanıcılar düzenleyebilir ama oluşturamayabilir.
• Karttan detaya geçiş: /projects/[id] — tahta ve ayarlar.

Proje oluşturma ve düzenleme

Tipik alanlar (API DTO’larıyla hizalı):

• Ad ve açıklama — operasyonel tanıma yardımcı olur.
• System prompt — tüm ajanlar özel prompt kullanmıyorsa varsayılan davranış buradan gelir.
• LLM yapılandırması — model, temperature, maxTokens, topP vb.; planınızın allowedModels listesi dışına çıkmayın.

Kayıttan sonra Dashboard aktivite günlüğünde PROJECT_CREATED benzeri bir kayıt oluşabilir (kurulumunuza göre).

Tahta düzeni (BoardLayout)

Tahta React Flow sağlayıcısı içinde çalışır. Ana bölgeler:

Bölge	Dosya (FE)	İşlev
Üst başlık	board-header	Proje adı, kaydet durumu, kısayollar
Sol şerit	board-sidebar	Düğüm paleti / nav
Tuval	board-canvas	Sürükle-bırak grafik
Sağ panel	board-detail-panel	Seçili düğüm/kenar özellikleri
Ayarlar	board-settings-panel	Genel proje ayarları (-sekme)
Test	test-mode-panel	Mesaj gönderme ve highlight
AI Builder	ai-builder-panel / ai-builder-chat	Doğal dil oturumu
Gelen kutu	inbox-detail-panel	Gelen kutusu detayı

Düğüm seçildiğinde sağ detay paneli ilgili formu açar: ajan düzenleme, araç bağlama, entegrasyon kimlik alanları vb.

Düğüm tipleri (operasyonel)

Tip	Kullanım ipucu
Router	Intent ayrımı; routing açıklamasını test kullanıcılarıyla birlikte yazın
Alt ajan	Yetki sınırı veya persona ayrımı
Araç	Function calling ile HTTP veya KB
Entegrasyon	Ortak base URL + auth
Bilgi tabanı	RAG yolunu görünür kılar
Gelen kutu	Hangi platform hattı bu projeye bağlı

Kenarlar (edges) yürütme sırasını veya “sonraki adım” ilişkisini temsil eder — tam semantik ürün sürüm dokümanınıza bakın.

Proje seviyesi araçlar ve bağlama

• Proje araçları (projectTools) tekil tanımlanır; ajanlara link / unlink ile bağlanır (onLinkTool, onUnlinkTool akışı).
• Araç form diyalogları (tool-form-dialog, link-tool-dialog) proxy ve güvenlik sekmeleri içerebilir — dış API çağrılarında kurumsal güvenlik politikanıza uyun.

Test modu

TestModePanel üzerinden:

1. Kullanıcı mesajını girin ve gönderin.
2. Backend test kuyruğu / SSE akışı yanıtı üretir (kurulumunuza göre).
3. highlight haritası (NodeHighlightState) hangi ajan veya aracın aktif olduğunu tuval üzerinde renklendirebilir — hata ayıklama için kritiktir.

Başarı kriteri: Aynı girdi tekrarlandığında tutarlı bir yürütme yolu görürsünüz; tutarsızlık router prompt veya kenar eksikliğidir.

Üretim karışıklığı

Test modu üretim trafiğini her zaman temsil etmez — canlıda canlı ajan atama kuralları, insan müdahalesi ve kuyruk gecikmeleri farklıdır.

AI Builder

Ayrı panelde sohbet ederek projeyi şekillendirirsiniz; backend uçları projects/:appId/builder altındadır. Önerileri tahtada doğrulamadan yayınlamayın.

Bkz. AI Builder.

Canlı sohbet bağlantısı

• Projeyi gelen kutusuna bağlama ve canlı ajan atamaları API + yönetim arayüzü ile yapılır.
• Kanal olayları platformun webhook girişleri üzerinden işlenir; kuyruk işçileri mesajları yürütür.

Bkz. Canlı sohbet ve mesajlaşma.

İlgili sohbet sayfası (/projects/[id]/chat)

Bazı sürümlerde sadeleştirilmiş bir sohbet test görünümü ayrı rotada sunulur; tahta ile birlikte veya müşteri demosu için kullanılır.

API ve aktivite

• CRUD: Projects uç noktaları
• Dashboard aktivitesi: Dashboard API

Sonraki adımlar

• Ajanlar
• Araçlar
• Orkestrasyon — olay güdümlü iş akışları