Ajanlar

Ajan (agent), bir projede belirli bir rolü üstlenen LLM tabanlı varlıktır. Kendi system prompt ve LLM ayarlarına sahip olabilir; araçlar ile dış dünyaya erişir (HTTP, bilgi tabanı araması vb.).

Ajanlar REST olarak /projects/:appId/agents altında yönetilir; tahta üzerinde düğüm olarak görselleştirilirler.

Ajan oluşturma ve düzenleme

Tipik alanlar (UI ve DTO hizası):

• Ad / görünen ad — operasyonel etiket; loglarda ve tahtada görünür.
• System prompt — rol, ton, yasaklar, çıktı biçimi. Net ve kısa talimatlar daha tutarlı yürütme verir.
• Router işareti (isRouter) — true ise bu ajan intent’e göre dallanma yapar; routing açıklaması (routingDescription) diğer ajanlarla ilişkiyi metinle özetler.
• Öncelik (priority) — çakışan router kurallarında hangi dalın öne çıkacağını belirlemek için (ürün sürümüne göre).

Router ajan deseni

1. Tek bir giriş noktası kullanıcı mesajını alır.
2. Router ajanı, routing açıklamasına ve bağlı kenarlara göre hangi uzman ajanın devreye gireceğine karar verir.
3. Uzman ajanlar dar system prompt ile kaliteyi artırır.

Anti-desen: Tek dev ajanla her şeyi yapmak — bağlam penceresi şişer, test zorlaşır.

Araç bağlama

• Araçlar çoğunlukla proje düzeyinde tanımlanır (projectTools).
• Ajan ile link edildiğinde LLM function-calling listesine girer.
• Aynı aracı birden fazla ajan paylaşabilir; rate limit’leri göz önünde bulundurun.

Bkz. Araçlar.

Alt ajan düğümü

Tahtada alt ajan düğümü, sorumluluğu başka bir ajan bağlamına devretmek için kullanılır. İnsan okuması için grafik üzerinde hiyerarşi net olmalıdır.

Test ve gözlem

• Test modunda hangi ajanın seçildiğini highlight renkleriyle izleyin.
• Router kaçırıyorsa önce örnek konuşmaları routing açıklamasına ekleyin, sonra LLM modelini değiştirmeyi düşünün.

Silme ve etki

Ajan silindiğinde düğümler ve bağlantılar etkilenir — silmeden önce grafik yedeği veya ekran görüntüsü alın.

API

• Projects uç noktaları — agents

Sonraki adımlar

• Proje yönetimi
• API entegrasyonları
• AI Builder