Skip to main content
Subagents

​
Was sind Subagenten?

Mit Subagenten kannst du einen Agenten an einen anderen anfügen. Der übergeordnete Agent kann dann während einer Unterhaltung Aufgaben an seine Subagenten delegieren. Jeder Subagent bearbeitet die Anfrage eigenständig mit seinen eigenen Anweisungen, Wissensquellen, Aktionen und seinem Modell. Das ist besonders nützlich, wenn ein einzelner Agent zu komplexe Anweisungen bräuchte, um mehrere Aufgabenbereiche abzudecken. Stattdessen kannst du diese Verantwortlichkeiten auf fokussierte Subagenten aufteilen.
Stell dir Subagenten wie Teammitglieder mit unterschiedlichen Spezialisierungen vor. Ein allgemeiner „Projektmanager”-Agent könnte Datenfragen an einen „Datenanalyse”-Subagenten und Content-Aufgaben an einen „Texter”-Subagenten delegieren.

​
Wie Subagenten funktionieren

Wenn der übergeordnete Agent entscheidet, dass ein Subagent das richtige Tool für die Aufgabe ist, sendet er einen Prompt an diesen Subagenten. Der Subagent:
  1. Empfängt den Prompt vom übergeordneten Agenten (entweder als freier Text oder als strukturierte Eingabe, je nach Eingabetyp des Subagenten)
  2. Arbeitet eigenständig mit seiner eigenen Konfiguration: Anweisungen, angehängtes Wissen, Aktionen, angehängte Skills und Modell
  3. Gibt ein Ergebnis zurück an den übergeordneten Agenten, der die Unterhaltung mit dem Nutzer fortsetzt
Der übergeordnete Agent sieht die Antwort des Subagenten und kann sie in seine eigene Antwort einbeziehen. Aus Sicht des Nutzers erscheint die Arbeit des Subagenten als ausklappbarer Tool-Aufruf in der Unterhaltung. Angehängte Skills werden während der Ausführung aufgelöst. Ein veröffentlichter Subagent läuft in seiner veröffentlichten Version. Entwurfsänderungen an diesem Subagenten wirken sich erst auf den übergeordneten Agenten aus, wenn du sie veröffentlichst.
Subagenten arbeiten in ihrem eigenen, separaten Kontext. Sie sehen nicht den gesamten Unterhaltungsverlauf des übergeordneten Agenten — sie erhalten nur den Prompt, den der übergeordnete Agent ihnen sendet.
Schreibe die Anweisungen des übergeordneten Agenten so, dass jeder Subagent die Aufgabe, den relevanten Kontext, den erwarteten Output und alle nötigen Einschränkungen erhält.

​
Subagenten zu einem Agenten hinzufügen

Im Tab Konfiguration hängst du Agenten in der Zeile Sub-Agenten an. Wenn noch keiner angefügt ist, klappe Mehr auf, klicke auf Sub-Agent hinzufügen und suche den Agenten. Wenn du einen Agenten im Anweisungs-Editor erwähnst, wird er ebenfalls angefügt. Du kannst auch den Agent Builder Chat bitten, Subagenten für dich anzufügen. Subagents
Du kannst einen Agenten nur als Subagenten hinzufügen, wenn du Bearbeiter oder Eigentümer dieses Agenten bist. So wird sichergestellt, dass du nur Agenten anfügst, die du auch verwalten darfst.

​
Aktionen und Verbindungen

Wenn ein Subagent eine Aktion nutzt, die eine Integrationsverbindung braucht, kann er eine automatische Standardverbindung oder eine geteilte Verbindung verwenden. Er kann auch eine vorkonfigurierte Verbindung nutzen, die dem Subagenten zugewiesen ist, oder den Nutzer bitten, eine eigene auszuwählen.

​
Berechtigungen und Zugriff

  • Zugriff auf den übergeordneten Agenten reicht nicht. Wer mit dem übergeordneten Agenten chattet, braucht zusätzlich Zugriff auf jeden angefügten Subagenten. Sonst kann der übergeordnete Agent diesen Subagenten für die Person nicht aufrufen.
  • Wenn ein Nutzer keinen Zugriff auf einen Subagenten hat, wird beim Aufruf eine Zugriffsverweigerung angezeigt. Der Nutzer kann dann direkt aus der Unterhaltung heraus Zugriff anfordern.
  • Wenn du den übergeordneten Agenten mit ausgewählten Nutzern, Gruppen oder API-Schlüsseln teilst, prüft Langdock den Subagenten-Zugriff vor dem Abschluss und listet Personen, denen noch Zugriff fehlt.
  • Wenn du einen Subagenten anfügst, kann der Editor eine Warnung zeigen, wenn der aktuellen Zielgruppe Zugriff fehlt. Klicke auf Prüfen, um Zugriff zu erteilen. Das Anfügen öffnet den Freigabe-Dialog nicht von selbst.

​
Wann du Subagenten einsetzen solltest

Subagenten sind eine gute Wahl, wenn:
  • Deine Agenten-Anweisungen zu lang werden. Teile verschiedene Verantwortlichkeiten auf dedizierte Subagenten mit fokussierten Anweisungen auf.
  • Du einen bestehenden Agenten wiederverwenden möchtest. Wenn du bereits einen gut konfigurierten Agenten hast, kannst du ihn als Subagent an jeden anderen Agenten anfügen, ohne das Setup zu duplizieren.
  • Verschiedene Aufgaben unterschiedliche Modelle oder Wissensquellen brauchen. Jeder Subagent kann sein eigenes Modell, seine eigene Wissensbasis und eigene Aktionen nutzen — unabhängig vom übergeordneten Agenten.

​
Einschränkungen

  • Keine Verschachtelung. Ein Subagent kann keine anderen Subagenten aufrufen. Nur der übergeordnete Agent auf oberster Ebene kann Subagenten aufrufen.
  • Separater Kontext. Subagenten haben keinen Zugriff auf den Unterhaltungsverlauf des übergeordneten Agenten. Sie erhalten nur den Prompt, der ihnen übergeben wird.
  • Aktionsbestätigungen. Wenn ein Subagent eine Aktion auslöst, die eine Bestätigung erfordert, wird der Nutzer aufgefordert, diese zu genehmigen, bevor der Subagent fortfahren kann.
  • Keine Rückfragen. Ein Subagent kann dem Nutzer keine Rückfragen mit auswählbaren Antworten stellen. Nur der übergeordnete Agent kann den Nutzer direkt fragen.
  • Keine Workflows. Ein Subagent kann keine Workflows auslösen.

​
FAQ

Nutze Subagenten, wenn ein übergeordneter Agent mehrere klar getrennte Verantwortlichkeiten hat, die sich besser auf fokussierte Spezialisten aufteilen lassen. Das macht die Anweisungen klarer und reduziert den Kontext, den jeder Agent verarbeiten muss.
Prüfe, ob die Anweisungen des übergeordneten Agenten klar beschreiben, wann delegiert werden soll, ob der Subagent angehängt und verfügbar ist und ob die Anfrage des Nutzers zur Rolle des Subagenten passt.