KI-Agent · DeutschlandGPT

Der Knoten KI-Agent lässt ein KI-Modell eine Aufgabe bearbeiten. In jedem Schritt kann der Agent eines seiner Tools aufrufen, das Ergebnis lesen und über den nächsten Schritt entscheiden, bis die Aufgabe erledigt oder die Schrittgrenze erreicht ist. Sie finden ihn in der Knotenauswahl unter Agenten.

Konfiguration

Eingabe	Erforderlich	Beschreibung
Modell	Ja	Das Sprachmodell. Modelle unterscheiden sich in Fähigkeiten und Preis
System Prompt	Nein	Dauerhafte Anweisungen: Rolle, Ton, Einschränkungen
Task	Ja	Die Aufgabe für diese Ausführung. Frühere Ausgaben erreichen Sie mit `{{knotenName.outputs.feldName}}`
Attachments	Nein	Bilder oder PDF-Dateien, die der Agent auswerten soll, eine pro Zeile (siehe unten)
Tools	Nein	Fähigkeiten und Integrationsaktionen, die der Agent aufrufen darf
Ausgabeformat	Nein	Felder, die das Endergebnis enthalten muss (siehe unten)
Max. Schritte	Nein	Höchstzahl der Durchläufe, 1 bis 50 (Standard 10)

Anhänge

Der Agent liest PDF-Dateien und Bilder (PNG, JPEG, GIF, WebP). Jede Zeile in Attachments ist eines davon:

eine Datei aus einem früheren Knoten, zum Beispiel {{emailAbrufen.outputs.attachments[0].file}} für den ersten Anhang einer E-Mail, oder die Datei aus einem Formular-Upload
alle Anhänge einer E-Mail auf einmal: {{emailAbrufen.outputs.attachments}}
eine öffentliche URL eines Bildes oder einer PDF-Datei

Eine Datei aus einem früheren Knoten mit einem anderen Typ, etwa ein Word-Dokument, lässt den Knoten mit einer Fehlermeldung scheitern, die die Datei nennt. Eine Datei mit einem allgemeinen Typ wird an ihrem Namen erkannt (.pdf, .png, .jpg, .gif, .webp).

Ausgaben

Ausgabe	Typ	Beschreibung
`result`	string oder object	Die abschließende Antwort. Ein Objekt mit Ihren Feldern, wenn ein Ausgabeformat festgelegt ist, sonst Text
`steps`	number	Wie viele Schritte der Agent gebraucht hat
`inputTokens`	number	Input-Tokens über alle Schritte
`outputTokens`	number	Output-Tokens über alle Schritte

Tools

Mit Tool hinzufügen geben Sie dem Agenten etwas zum Aufrufen:

Fähigkeiten: Web Search sucht im Internet, Website Scraper liest den Inhalt von Webseiten aus (HTML und PDF).
Integrationsaktionen: jede Aktion einer Integration, etwa Jira-Issues suchen oder eine Slack-Nachricht senden. Jedes Integrations-Tool braucht eine eigene Verbindung.
MCP-Server: die Werkzeuge eines eigenen MCP-Servers, den Sie verbunden haben. Wählen Sie den Server und dann ein oder mehrere seiner Werkzeuge. Kennt die Auswahl die Werkzeuge noch nicht, fragt sie den Server; Aktualisieren lädt die Liste neu.

Welche Tools der Agent in welcher Reihenfolge nutzt, entscheidet er selbst.

Ein ausgewähltes Tool gilt als freigegeben, im Workflow fragt niemand nach. Ein MCP-Werkzeug, das die Person mit der Verbindung auf Nie erlauben gestellt hat, oder ein MCP-Server, den die Organisation für sie abgeschaltet hat, lässt den Knoten fehlschlagen. Die Fehlermeldung nennt den Grund. Ein Tool mit ungültiger gespeicherter Konfiguration lässt den Knoten ebenfalls fehlschlagen, mit einer Meldung, die Knoten und Tool nennt; ein ungültiger Skill wird dagegen im Lauf ausgelassen, mit einem Hinweis in der Ausgabe des Knotens. Wählen Sie das Tool in beiden Fällen im Knoten erneut aus.

Geben Sie dem Agenten nur die Tools, die die Aufgabe braucht. Jedes zusätzliche Tool kostet Tokens und verleitet zu unnötigen Aufrufen. Ändert eine Integrationsaktion Daten, schalten Sie für den Knoten am besten Genehmigung erforderlich ein.

Ausgabeformat

Ohne Ausgabeformat ist result einfacher Text. Mit Ausgabeformat ist result ein Objekt, das genau die festgelegten Felder enthält. So lässt es sich in späteren Knoten leicht weiterverwenden.

Klicken Sie auf Ausgabefeld hinzufügen und legen Sie je Feld fest:

Schlüssel: der Feldname ohne Leerzeichen, etwa summary
Bezeichnung: ein lesbarer Name
Typ: Text, Zahl, Boolean, Auswahl (mit einer Liste von Optionen), Array oder Objekt
Beschreibung: sagt dem Modell, was in das Feld gehört
Erforderliches Feld: ob das Feld gefüllt sein muss

Ein späterer Knoten liest ein Feld dann mit {{aiAgent.outputs.result.summary}}.

Tipps

Formulieren Sie Aufgaben konkret. Statt „Fasse das zusammen“ besser: „Fasse das folgende Support-Ticket in zwei oder drei Sätzen zusammen, nenne das Hauptproblem und schlage eine Antwort vor. Ticket: {{formTrigger.outputs.formData.ticket}}“.

Dauerhafte Anweisungen gehören in den System Prompt. Rolle, Format und Ton stehen dort, die Aufgabe bleibt kurz.

Senken Sie Max. Schritte bei einfachen Aufgaben. Klassifizieren oder Extrahieren ohne Tools braucht einen einzigen Schritt.

Nutzen Sie ein Ausgabeformat für die Weiterverarbeitung. Braucht der nächste Knoten ein bestimmtes Feld, legen Sie es fest. Dann ist es vorhanden und hat den richtigen Typ.