DokumentationWorkflowsKI und Agenten
Agent Node
Führt einen deiner persönlichen Agents aus - mit seiner Persona, seinem Gedächtnis und seinem Arbeitsordner als Werkbank. Hier findest du Einrichtung, Felder, Ein- und Ausgaben, Testablauf und Fehlerbehebung.
8 Min LesezeitAktualisiert am
Was Agent macht
Führt einen deiner persönlichen Agents aus - mit seiner Persona, seinem Gedächtnis und seinem Arbeitsordner als Werkbank.
- Verarbeitet einen Eingang.
- Stellt einen Ausgang für weitere Schritte bereit.
- Kann freigegebene Werkzeug-Nodes selbstständig aufrufen.
Node einrichten
- 01Öffne einen Workflow und füge „Agent“ über Bausteine hinzu.
- 02Fülle die erforderlichen Felder aus. Werte aus vorherigen Schritten kannst du als Variable einsetzen.
- 03Nutze Testdaten oder starte einen Testlauf und prüfe die Ausgabe des Nodes.
- 04Verbinde den erfolgreichen Ausgang mit dem nächsten Schritt und aktiviere den Workflow erst nach einem vollständigen Probelauf.
Aktionen und Betriebsarten
Agent hat eine klar abgegrenzte Aufgabe. Die verfügbaren Einstellungen erscheinen direkt im Node-Panel, sobald du den Node auswählst.
Einstellungen
| Feld | Bedeutung | Bereich |
|---|---|---|
| Maximale Denk-Schritte | Maximale Modellrunden (1 bis 25). Jede Runde kann mehrere Tools aufrufen. Ohne finale Antwort wird der Lauf als fehlgeschlagen beendet. | Erweitert |
| Credit-Budget | Stoppt weitere Modell- und Tool-Aufrufe ab diesem Verbrauch (1 bis 100000 Credits). Ein bereits laufender Modellaufruf kann das Budget überschreiten. | Erweitert |
| Maximale Tool-Aufrufe | Höchstens 1 bis 100 Tool-Aufrufe pro Agent-Schritt, auch wenn eine Modellrunde mehrere Tools anfordert. | Erweitert |
| Agent | Welcher deiner Agents den Auftrag ausführt. | Standard |
| Auftrag (Pflicht) | Freier Text oder eine Variable wie {{ $json.message }}. | Standard |
| Modell-Fallback | Greift nur, wenn der Agent selbst kein Modell festgelegt hat. | Erweitert |
| Ausgabeformat | JSON für Folge-Nodes erzwingen. | Erweitert |
| JSON-Struktur (optional) | Beispiel mit Feldnamen und Typen; leer lässt die Struktur frei. | Erweitert |
Eingaben und Ausgaben
| Eingabe | Bedeutung | Typ |
|---|---|---|
| user prompt | Der Auftrag an den Agent. Override für das inline Auftrags-Feld. | text |
| Ausgabe | Bedeutung | Typ |
|---|---|---|
| output | Die Antwort des Agents (finale Assistant-Message). | text |
| steps | Alle Tool-Aufrufe + Ergebnisse des Laufs. | json |
Beispiel und Testlauf
Auftrag an einen Agent: Starte den Node zunächst mit einem kleinen, eindeutig erkennbaren Datensatz. Öffne danach die Ausgabe und verwende nur Felder, die dort tatsächlich vorhanden sind.
Beispiel für einen Testlauf
{
"userPrompt": "Sichte die Notizen in deinem Arbeitsordner und fasse den aktuellen Stand in drei Sätzen zusammen."
}Zugriff und Sicherheit
Prüfe vor der Aktivierung, welche Daten in diesen Schritt gelangen und welche Daten seine Ausgabe enthält.
Schlüssel und Zugangsdaten gehören in die geschützte Verbindungsverwaltung. Trage sie nicht als normalen Text in Workflow-Felder, Testdaten oder Beschreibungen ein.
Häufige Fehler beheben
- Keine Ausgabe: Prüfe den letzten Testlauf und ob der vorherige Node die erwarteten Felder geliefert hat.
- Variable bleibt leer: Öffne die Ausgabe des vorherigen Schritts und übernimm den Feldnamen aus den echten Testdaten.