DokumentationWorkflowsKI und Agenten
AI Agent Node
Führt einen Prompt aus. Werkzeuge lassen sich bei Bedarf andocken. Hier findest du Einrichtung, Felder, Ein- und Ausgaben, Testablauf und Fehlerbehebung.
8 Min LesezeitAktualisiert am
Was AI Agent macht
Führt einen Prompt aus. Werkzeuge lassen sich bei Bedarf andocken.
- 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 „AI 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
AI 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 |
|---|---|---|
| Modell | Anymize Waterfall 2 ist der Standard. Claude-Modelle für komplexere Aufgaben. | Standard |
| User-Prompt (Pflicht) | Freier Text oder eine Variable wie {{ $json.message }}. | Standard |
| Ausgabeformat | JSON für Folge-Nodes erzwingen. | Erweitert |
| JSON-Struktur (optional) | Beispiel mit Feldnamen und Typen; leer lässt die Struktur frei. | Erweitert |
| Werkzeuge | Angedockte Werkzeuge. | Standard |
| System-Message | Rolle und Regeln für das Modell. | Erweitert |
| 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 |
Eingaben und Ausgaben
| Eingabe | Bedeutung | Typ |
|---|---|---|
| user prompt | Nachricht an den Agent. | text |
| system prompt | Rolle und Regeln. | text |
| Ausgabe | Bedeutung | Typ |
|---|---|---|
| output | Die Agenten-Antwort (finale Assistant-Message). | text |
| steps | Alle Tool-Calls + Observations (wenn aktiviert). | json |
Beispiel und Testlauf
Recherche-Agent mit Calculator + HTTP-Tool: 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": "Wie viele Einwohner hat Berlin laut Wikipedia, und wie viel ist das mal 0.2?",
"systemPrompt": "Du bist ein präziser Recherche-Assistent. Antworte kurz auf Deutsch."
}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.