Zum Hauptinhalt springen

Das Agent-Menü

Wenn du im Visual Designer auf einen Agenten klickst, erscheint direkt neben ihm eine vertikale Leiste mit Symbolen — das Agent-Menü. Es gibt dir schnellen Zugriff auf alle Aktionen, die du für diesen Agenten ausführen kannst.

Das Agent-Menü neben einem ausgewählten Agenten

Kein Menü sichtbar?

Klicke einmal direkt auf die Agenten-Karte. Das Menü erscheint nur, wenn ein Agent aktiv ausgewählt ist.


Übersicht: Alle Aktionen im Agent-Menü

Das Agent-Menü enthält bis zu acht Symbole. Welche Symbole erscheinen, hängt vom Agenten-Typ ab — ein Web Form-Agent hat zum Beispiel einen Testlauf, ein Deep Research-Agent hingegen eine direkte Run-Aktion.

SymbolBezeichnungKurzbeschreibung
✏️BearbeitenKonfiguration des Agenten öffnen
🗂️KlonenExakte Kopie des Agenten erstellen
🧪TestlaufAgenten sicher im Dry-Run testen
▶️RunAgenten direkt ausführen
👁️SummaryZusammenfassung und Formular-URL anzeigen
✉️MessagesVersendete Nachrichten einsehen und erneut ausführen
📋LogsAktivitätsprotokoll öffnen
⏸️DeaktivierenAgenten vorübergehend pausieren
🗑️LöschenAgenten dauerhaft entfernen

Bearbeiten

Klicke auf das Stift-Symbol, um den Konfigurationsdialog des Agenten zu öffnen. Hier kannst du alle Einstellungen anpassen:

  • Name — die Bezeichnung des Agenten im Designer
  • Aufbewahrungsdauer für Nachrichten — wie lange empfangene Nachrichten gespeichert bleiben
  • Empfänger — welcher Agent die Ausgabe dieses Agenten empfängt
  • Agenten-spezifische Optionen — je nach Typ z. B. Formularfelder, Abfrage-Prompts oder Anzeige-Templates

Änderungen werden erst nach dem Klick auf Speichern übernommen.

Tooltip: Bearbeiten

Dialog: Agent bearbeiten


Klonen

Das Kopier-Symbol erstellt eine exakte Kopie des Agenten mit allen aktuellen Einstellungen. Der neue Agent erscheint als eigenständige Karte im Designer — erkennbar am Namenszusatz (2).

Tooltip: Klonen

Dialog: Agent klonen

Ergebnis: Geklonter Agent im Designer

Wann ist Klonen sinnvoll?

Nutze Klonen, wenn du einen ähnlichen Agenten benötigst und nicht von Null anfangen möchtest. Auch praktisch: Klone einen produktiven Agenten, um Änderungen zuerst am Klon zu testen — so bleibt der ursprüngliche Agent unberührt.


Testlauf ausführen

Das Kolben-Symbol startet den Agenten im Dry-Run-Modus — einer sicheren Testumgebung, in der der Ablauf vollständig simuliert wird, ohne echte Folgeaktionen auszulösen. E-Mails werden nicht gesendet, externe Systeme nicht dauerhaft verändert.

Tooltip: Testlauf ausführen

Dialog: Testlauf starten

Wenn der Agent bereits Nachrichten empfangen hat, kannst du eine davon direkt als Testgrundlage auswählen:

Dialog: Testlauf mit kürzlich empfangenen Nachrichten

Nach dem Testlauf öffnen sich die Testlauf-Ergebnisse mit drei Reitern:

  • Nachrichten — die vom Agenten erzeugten Ausgaben
  • Log — eine technische Protokollzeile für jeden Verarbeitungsschritt
  • Speicher — Vorschau auf Daten, die im Workflow gespeichert würden

Testlauf-Ergebnisse: Reiter Nachrichten

Testlauf-Ergebnisse: Reiter Log

Empfehlung

Führe vor der ersten Inbetriebnahme und nach jeder Konfigurationsänderung einen Testlauf durch.


Run

Bei bestimmten Agenten-Typen — zum Beispiel Deep Research — erscheint anstelle des Testlauf-Symbols ein Run-Symbol (Pfeil-Kreis-Icon). Ein Klick startet den Agenten direkt mit einer eingehenden Nachricht aus der Warteschlange.

Tooltip: Run

Kein Dry-Run

Im Unterschied zum Testlauf ist Run eine echte Ausführung. Folgeaktionen werden ausgelöst und externe Systeme können verändert werden.


Summary

Das Auge-Symbol zeigt eine kurze Zusammenfassung des Agenten. Bei Agenten vom Typ Web Form findest du hier außerdem den direkten Link zum öffentlichen Formular — die URL, die du an Nutzer weitergeben kannst, damit sie Eingaben in den Workflow übermitteln.

Tooltip: Summary

Dialog: Agent-Zusammenfassung mit Formular-URL


Messages

Das Brief-Symbol öffnet die Nachrichtenübersicht des Agenten. Hier siehst du alle Nachrichten, die der Agent versendet hat — mit Zeitstempel und vollständigem Inhalt.

Tooltip: Messages

Dialog: Agent Messages

Pro Eintrag stehen drei Aktionen zur Verfügung:

  • Anzeigen — zeigt den vollständigen Nachrichteninhalt
  • Erneut senden — führt den Workflow ab dieser Stelle erneut aus, ohne die vorherigen Agents nochmals durchlaufen zu müssen. Vorherige Workflow-Durchläufe werden dabei nicht verändert — es wird ein neuer Durchlauf ab diesem Punkt gestartet.
  • Löschen — entfernt die Nachricht dauerhaft
Gezielt ab einer bestimmten Stelle erneut ausführen

"Erneut senden" ist besonders praktisch, wenn du einen Workflow an einer bestimmten Stelle erneut ausführen möchtest, aber die vorherigen Schritte unangetastet lassen willst. Beispiel: Die Datenextraktion hat funktioniert, aber der nachfolgende Speicher-Agent war falsch konfiguriert. Statt den gesamten Workflow von vorne zu starten, öffnest du die Messages des Extraktions-Agents und sendest die betreffende Nachricht erneut — nur der Teil ab dort wird nochmals durchlaufen.


Logs

Das Listen-Symbol öffnet das Aktivitätsprotokoll des Agenten. Jeder Eintrag entspricht einem Verarbeitungsvorgang und zeigt, was wann passiert ist — zum Beispiel ob ein Formular empfangen, eine Nachricht erstellt oder eine Aktion ausgelöst wurde.

Tooltip: Logs

Dialog: Agent Logs

Über die Buttons Nachricht eingehend, Nachricht ausgehend und Details kannst du bei jedem Eintrag die zugehörigen Daten im Detail einsehen. Die Logs sind das wichtigste Werkzeug zur Fehleranalyse im laufenden Betrieb.


Deaktivieren

Das Pause-Symbol pausiert den Agenten vorübergehend. Ein deaktivierter Agent nimmt keine neuen Nachrichten mehr an und löst keine Aktionen aus — er bleibt aber vollständig im Workflow erhalten und kann jederzeit wieder aktiviert werden.

Tooltip: Deaktivieren

Ein deaktivierter Agent ist im Designer gut erkennbar: Die Karte wird ausgegraut und erhält einen gestrichelten Rahmen. Das Agent-Menü zeigt nun ein Play-Symbol, mit dem du den Agenten wieder aktivierst.

Visueller Zustand: Deaktivierter Agent im Designer

Deaktivieren statt Löschen

Deaktiviere einen Agenten, wenn du ihn vorübergehend außer Betrieb nehmen möchtest, aber seine Konfiguration erhalten willst — zum Beispiel während Wartungsarbeiten oder beim schrittweisen Aufbau eines Workflows.


Löschen

Das Papierkorb-Symbol entfernt den Agenten dauerhaft aus dem Workflow. Alle Verbindungen zu anderen Agenten werden dabei getrennt.

Tooltip: Löschen

Zur Sicherheit erscheint vor dem endgültigen Löschen ein Bestätigungsdialog:

Bestätigungsdialog: Agent löschen?

Achtung: Unwiderruflich

Das Löschen eines Agenten kann nicht rückgängig gemacht werden. Alle Konfigurationen und gespeicherten Nachrichten des Agenten gehen verloren. Wenn du unsicher bist, nutze stattdessen Deaktivieren.