Alt Temsilciler

Alt temsilciler (Subagents), bir LibreChat Temsilcisinin odaklanmış çalışmalar için yalıtılmış bir alt çalışma (child run) başlatmasına olanak tanır. Alt temsilci kendi bağlam penceresine ve araç yürütme akışına sahip olur. Üst temsilci, her bir ara araç çağrısını, izlemeyi veya ayrıntılı dosya işlemini kendi bağlamına dahil etmeden yalnızca alt temsilcinin sonucunu alır.

Şu işlemler için alt temsilciler (subagents) kullanın:

• Uzun ara çıktılar üretebilecek araştırma alt görevleri
• Özel bir ajan ile geçişleri incele
• Üst bağlamın dışında kalması gereken araç ağırlıklı işler
• Ebeveynin koordine ettiği ve özetlediği paralel tarzda ayrıştırma

Alt Temsilciler (Subagents), Temsilci Zincirinden (Agent Chain) Nasıl Farklılaşır?

Agent Chain, aracıların sonuçları yapılandırılmış zincir adımları aracılığıyla aktardığı çoklu aracı grafiği oluşturur. Alt aracılar (subagents), bir çalışma sırasında bir araç çağrısı olarak ana aracı tarafından oluşturulur.

• Agent Chain: grafik düzeyinde çoklu ajan iş akışı
• Subagents: bir üst ajandan izole edilmiş alt çalıştırmalara çalışma zamanı delegasyonu

Her ikisi de mevcut ajanları kullanabilir, ancak alt ajanlar (subagents), tek bir ajanın mantık döngüsü içinden kapsamlı yetkilendirme için tasarlanmıştır.

Yeteneği Etkinleştir

subagents özelliği varsayılan olarak etkindir. Yöneticiler, özelliği devre dışı bırakmak için bunu agents endpoint yetenek listesinden kaldırabilirler.

endpoints:
  agents:
    capabilities:
      - 'deferred_tools'
      - 'execute_code'
      - 'file_search'
      - 'web_search'
      - 'artifacts'
      - 'subagents'
      - 'actions'
      - 'context'
      - 'skills'
      - 'tools'
      - 'chain'
      - 'ocr'

Bir Agent Yapılandırın

Agent Builder içinde Advanced Settings kısmını açın ve Subagents özelliğini etkinleştirin.

Kullanılabilir ayarlar:

• Alt temsilcileri etkinleştir: temsilciye alt temsilci oluşturma aracını ekler.
• Allow self-spawn: ajanın kendisinin yeni bir kopyasını izole bir bağlamda oluşturmasına izin verir. Alt ajanlar (subagents) etkinleştirildiğinde bu özellik varsayılan olarak etkindir.
• Ek alt temsilciler: üst öğenin oluşturabileceği belirli temsilcileri seçer.

Eşdeğer ajan şekli:

subagents:
  enabled: true
  allowSelf: true
  agent_ids:
    - 'agent_researcher'
    - 'agent_reviewer'

Model Spec Yapılandırma

Yöneticiler, bir Model Specs üzerinden oluşturulan geçici (ephemeral) ajanlar için Subagents özelliğini de etkinleştirebilirler. Bu, bir Model Specs'in, kullanıcıların kalıcı bir üst ajan oluşturmasını veya seçmesini gerektirmeden odaklanmış bir ajan profili gibi davranması gerektiğinde kullanışlıdır.

modelSpecs:
  list:
    - name: 'research-assistant'
      label: 'Research Assistant'
      subagents:
        enabled: true
        allowSelf: true
        agent_ids: []
      preset:
        endpoint: 'agents'
        model: 'gpt-4o'

Başlangıç yapılandırmasında istemcilere yalnızca enabled ve allowSelf gönderilir. agent_ids izin listesi sunucu tarafında kalır ve paylaşılan MAX_SUBAGENTS sınırına göre doğrulanır. İstemci istek yükleri, Model Specs Subagent yapılandırmasını sağlayamaz veya geçersiz kılamaz.

Çalışma Zamanı Davranışı

Alt aracılar (subagents) etkinleştirildiğinde, ana aracı bir subagent aracı alır. Bu araç şunları oluşturabilir:

• self, when allowSelf is not false
• agent_ids içinde yapılandırılmış herhangi bir alt ajan

Alt temsilciler izole edilmiş bir bağlamla çalışır. Üst araç arama durumu ve birikmiş bağlam, alt çalışmaya kopyalanmaz. Alt çalışma model kullanımı, üst işleme faturalandırılır ve üst kullanım toplamlarına dahil edilir. Arayüz, alt çalışmayı durum, anlık güncellemeler ve nihai sonuç içeren genişletilebilir bir temsilci etkinliği parçası olarak gösterir.

Sınırlar

LibreChat, alt aracı (subagent) grafiklerini sınırlı tutmak için bu limitleri uygular:

Erişim Kontrolü

Yapılandırılmış alt temsilciler (child agents) kullanıcı tarafından görülebilir olmalıdır. Eğer kullanıcının referans verilen bir temsilciye görüntüleme erişimi yoksa, LibreChat bu alt temsilciyi atlar. Oluşturma ve güncelleme istekleri için, geçersiz veya yetkisiz subagents.agent_ids girdileri reddedilir.

Tasarım İpuçları

• Ebeveyn ajan zaten iyi bir kapsam belirlemişse ve yalnızca bir alt görev için yeni bir bağlama ihtiyaç duyuyorsa self-spawn özelliğini etkinleştirin.
• Görev farklı bir model, talimat seti, araç seti veya yetenek izin listesi gerektirdiğinde belirli alt temsilciler (child agents) ekleyin.
• Alt öğe açıklamalarını net tutun. Ebeveyn, doğru yetkilendirme hedefini seçmek için her bir alt öğe adını ve açıklamasını kullanır.
• Kalıcı bir konuşma yoluna devretmek için değil, kompakt bir sonuç döndürmesi gereken ara işler için alt temsilcileri (subagents) kullanın.