Anmelden

KI-Agent-Workflow-Schritte für WordPress-Formulare

Der Workflow-Schritt ai.agent ist die Backend-KI-Aktion innerhalb von Flow-Workflows.

Er sendet die endgültige E-Mail oder Webhook-Anfrage nicht direkt. Stattdessen veröffentlicht er ein ai.agent.requested-Ereignis im Backend-Workflow-System. Das KI-Backend verarbeitet die Anfrage und gibt anschließend folgende Ereignisse aus:

  • ai.agent.completed
  • ai.agent.failed

Nachgelagerte Workflows können auf diese Ergebnisereignisse reagieren. Schrittbezogene Auslöserverzweigungen der Prozesskarte können diese Workflows genau auf den KI-Schritt begrenzen, der das Ereignis ausgegeben hat.

Bereitstellungsvoraussetzung​

Damit dieser Schritt in der Produktion funktioniert, reicht das Flow-Backend allein nicht aus.

Sie benötigen:

  • ein bereitgestelltes Flow-Backend, das Workflows synchronisiert und ausführt,
  • ein bereitgestelltes AI-Kit-Backend, da dessen interne AiAgentDispatcherFunction das Ereignis ai.agent.requested verarbeitet und ai.agent.completed oder ai.agent.failed ausgibt.

Fehlt der Dispatcher des AI-Kit-Backends oder ist er falsch konfiguriert, kann der Workflow das KI-Anfrageereignis veröffentlichen, doch keine Komponente verarbeitet es zu einem nachfolgenden KI-Ergebnis.

Für auf einer Knowledge Base basierende Antworten oder Klassifizierungen benötigt das AI-Kit-Backend außerdem eine funktionsfähige Modellkonfiguration und eine konfigurierte Knowledge Base mit aufgenommenen Inhalten.

Zweck dieser Ansicht​

Die Konfigurationsansicht des KI-Agent-Schritts verbindet vier Bereiche:

  1. Aufgabenabsicht über Mode
  2. optionales plattformgesteuertes Routing über Internal routing
  3. Prompting über Prompt Text und Additional System Guidance
  4. Ausgabevalidierung über Response Constraint

Wenn Sie diese Bereiche getrennt halten, lassen sich die Konfiguration wesentlich leichter nachvollziehen.

Mode​

Mode bezeichnet die übergeordnete Absicht, die an das KI-Backend übergeben wird.

Aktuelle Werte:

  • Answer
  • Summarize
  • Classify
  • Extract structured data

Empfohlene Verwendung:

  • Wählen Sie Answer für allgemeine Texterzeugung oder das Verfassen von Antworten.
  • Wählen Sie Summarize für knappe Zusammenfassungen.
  • Wählen Sie Classify für Routing- und Verzweigungsentscheidungen.
  • Wählen Sie Extract structured data, wenn Sie eine vorhersagbare strukturierte Ausgabe benötigen.

Mode prägt die Standardwerte; das tatsächliche Verhalten hängt weiterhin von Ihrem Prompt und Schema ab.

Internal routing​

Internal routing steuert, ob Flow einen plattformeigenen Routingvertrag einfügt.

Aktuelle Voreinstellungen:

  • No internal routing
  • Route by category
  • Route by outcomes
  • Draft reply only

Empfohlene Verwendung:

  • No internal routing: Verwenden Sie diese Einstellung, wenn Sie keine Flow-Routinghülle möchten. Sie entfernt den Plattform-Routingblock; ein bereits vorhandenes eigenes Antwortschema bleibt jedoch bestehen, bis Sie es löschen oder ersetzen.
  • Route by category: Verwenden Sie diese Einstellung, wenn die KI eine stabile Kategorie wie support, sales oder billing auswählen soll.
  • Route by outcomes: Verwenden Sie diese Einstellung, wenn die KI ausdrückliche umsetzbare Ergebnisse wie invoke_webhook, invoke_workflow oder send_email zurückgeben soll.
  • Draft reply only: Verwenden Sie diese Einstellung, wenn der Schritt einen strukturierten Antwortentwurf erzeugen soll und Sie keine Routingmetadaten benötigen.

Route Keys, Outcome Types und Signal Keys​

Bei aktiviertem Routing legen diese Felder fest, welche Werte die KI ausgeben darf.

Route Keys​

Verwenden Sie stabile Kategoriewerte wie:

  • support
  • sales
  • billing
  • crm_lead

Diese Werte fließen in Verzweigungsvorschläge der Prozesskarte wie route:support ein.

Outcome Types​

Verwenden Sie wiederverwendbare Aktionsgruppen wie:

  • invoke_webhook
  • invoke_workflow
  • send_email
  • set_status

Sie unterstützen Verzweigungsschlüssel wie outcome:invoke_webhook:create_ticket.

Signal Keys​

Verwenden Sie optionale strukturierte Metadaten wie:

  • priority
  • language
  • urgency

Sie unterstützen Verzweigungsschlüssel wie signal:priority:high.

Empfehlung:

  • Verwenden Sie route für den wichtigsten fachlichen Zweig.
  • Verwenden Sie outcomes für umsetzbare nächste Schritte.
  • Verwenden Sie signals nur für ergänzende Metadaten.

Prompt-Felder​

Prompt Text​

Prompt Text ist die zentrale Aufgabenanweisung und das wichtigste vom Benutzer verfasste Feld.

Gute Prompts sind konkret, handlungsbezogen und benennen die gewünschte Entscheidung oder das gewünschte Ergebnis ausdrücklich.

Platform System Block​

Platform System Block wird von Flow automatisch eingefügt, wenn die gewählte Routing-Voreinstellung ihn erfordert.

Sie bearbeiten ihn nicht direkt. Er setzt den ausgewählten Routingvertrag durch.

Additional System Guidance​

Additional System Guidance ist Ihre eigene Anweisung auf Systemebene, die nach dem Plattformblock angefügt wird.

Verwenden Sie sie für Ton-, Richtlinien- oder Verhaltensvorgaben wie:

  • knapp formulieren,
  • Belege aus der Knowledge Base bevorzugen,
  • spekulative Aussagen vermeiden.

Belasse die eigentliche Kernaufgabe in Prompt Text.

Antwortschema​

Voreinstellungen für Antwortschemas​

Diese Aktion erzeugt ein Ausgangsschema für den aktuellen Modus oder die aktuelle Routing-Voreinstellung.

Verwenden Sie Apply routing preset, wenn das Schema des Routingvertrags aus der aktuellen Routingkonfiguration neu erstellt werden soll.

Response Constraint (JSON-Schema)​

Dies ist der JSON-Schemavertrag zur Laufzeit für die KI-Ausgabe.

Bei aktiviertem Routing muss er der von Flow erwarteten Routinghülle entsprechen. In der Praxis ist dies meist ein Stammobjekt mit routing.route, routing.confidence, routing.reason und routing.outcomes sowie optional routing.signals.

Bei aktiviertem Draft reply only muss das Schema stattdessen dem Vertrag für Antwortentwürfe entsprechen.

Wichtiges Verhalten:

  • Ungültiges JSON bleibt bis zur Korrektur im Editor.
  • Der Workflow bewahrt den Entwurfstext, statt ihn stillschweigend zu verwerfen.

Update Status on Dispatch​

Update Status on Dispatch ändert den Übermittlungsstatus unmittelbar nach der Veröffentlichung von ai.agent.requested.

Die Einstellung wartet nicht auf das endgültige KI-Ergebnis.

Verwenden Sie dies für sichtbare Übergänge wie new -> in-progress, nicht als Ersatz für das endgültige fachliche Ergebnis.

Empfohlene Ersteinrichtung​

Für einen ersten Workflow mit nachgelagerten Verzweigungen eignet sich folgende Einrichtung:

  • Mode: Classify
  • Internal routing: Route by category
  • eine kleine Menge von Route Keys,
  • optionale Signal Keys wie priority,
  • ein aus der Voreinstellung erzeugtes Routingschema,
  • ein knapper, aufgabenbezogener Prompt.

Damit erhalten Sie vorhersagbare Verzweigungen in der Prozesskarte, ohne von Anfang an ein umfangreiches eigenes Ausgabemodell festlegen zu müssen.

Häufige Fehler​

  • No internal routing wählen und trotzdem routenbasierte Verzweigungen der Prozesskarte erwarten,
  • ein älteres eigenes Schema beibehalten und annehmen, dass No internal routing die Ausgabe vollständig frei gestaltet,
  • mandantenspezifische boolesche Werte statt stabiler Routen- oder Ergebnisschlüssel verwenden,
  • Update Status on Dispatch als endgültige KI-Entscheidung statt als Übergang des Verarbeitungsstatus behandeln.