Zum Inhalt springen

Menschliche Freigabe

Freigabe für KI-Aktionen: Dein Team entscheidet, dann handelt der Agent

Markiere eine API-Aktion oder einen Schritt eines Ablaufs mit Requires team approval, und der Agent führt sie nicht mehr selbst aus. Die Anfrage wartet mit genau ihren Eingaben auf der Seite Approvals, bis jemand aus deinem Team sie freigibt oder ablehnt, und der Besucher erfährt das Ergebnis im Chat.

Beispiel: eine Erstattung, die auf das Team wartet

Besucher: Meine Bestellung 48213 kam mit einem kaputten Deckel an. Ich hätte für diesen Artikel gern eine Erstattung.

Agent: Das tut mir leid. Ich habe eine Erstattungsanfrage für den Artikel aus Bestellung 48213 zur Prüfung an unser Team weitergegeben. Das Ergebnis siehst du direkt hier im Chat. Kann ich dir in der Zwischenzeit noch bei etwas helfen?

Besucher: Ja, liefert ihr auch nach Österreich?

Agent: Ja. Bestellungen nach Österreich kommen meist innerhalb von 3 bis 5 Werktagen an.

Agent: Gute Nachricht: Unser Team hat deine Anfrage freigegeben, und sie wurde ausgeführt.

Manche Aktionen sollten nicht allein auf das Wort der KI hin laufen

Ein KI-Agent, der deine API aufrufen kann, ist nützlich, weil er Dinge erledigt: eine Erstattung auslösen, ein Abo kündigen, eine Gutschrift buchen, eine Testphase verlängern. Genau das sind aber auch die Dinge, die eine Person prüfen soll, zumindest am Anfang oder ab einem bestimmten Betrag. Ohne Prüfschritt bleiben dir zwei schlechte Möglichkeiten: Du gibst dem Agenten die Aktion und hoffst, dass er sich nie irrt, oder du hältst sie von ihm fern und dein Team erledigt jede Anfrage von Hand. Die Freigabe durch das Team setzt eine Person zwischen die Entscheidung des Agenten und deine API. Der Agent sammelt die Angaben im Gespräch, dein Team gibt mit einem Klick frei oder lehnt ab, und nur eine freigegebene Anfrage erreicht deine Systeme.

Warum eine Person bei KI-Aktionen mitentscheiden sollte

Der Agent führt das Gespräch, dein Team behält das letzte Wort darüber, was sich ändert.

  • Nichts läuft allein auf das Wort des Agenten

    Ruft der Agent eine Aktion auf, die eine Freigabe braucht, wird nichts an deine API gesendet. Der Aufruf wird mit seinen Eingaben gespeichert und wartet auf dein Team. Abgelehnte und abgelaufene Anfragen laufen nie.

  • Genau das Freigegebene, genau einmal

    Eine Freigabe führt die Aktion mit genau den Eingaben aus, die auf der Seite stehen. Die KI wird nicht noch einmal gefragt, sie kann also Betrag oder Bestellnummer nach deiner Entscheidung nicht ändern, und eine Anfrage läuft nie zweimal.

  • Der Besucher bleibt informiert

    Der Agent sagt dem Besucher, dass seine Anfrage an dein Team ging, und hilft weiter bei allem anderen. Sobald du entscheidest, steht das Ergebnis im Chat, in seiner Sprache: Deutsch, Englisch, Französisch, Italienisch oder Spanisch.

  • Dein Team erfährt davon

    Alle, die entscheiden dürfen, bekommen eine E-Mail mit den Eingaben und einem Link. Dazu kannst du einen Slack-Hinweis und den Webhook action_approval.requested bekommen, und das Gespräch landet als Open in der Inbox.

  • Passt in deine Abläufe

    Auch ein Schritt eines Ablaufs, der eine Aktion aufruft, kann auf eine Freigabe warten. Nach der Freigabe geht der Ablauf mit dem nächsten Schritt weiter, eine Ablehnung oder ein Fristablauf beendet ihn.

So richtest du die Freigabe durch das Team ein

  1. Die API-Aktion anlegen

    Lege die Aktion im Tab Actions an, zum Beispiel einen Erstattungsaufruf an dein Shop- oder Abrechnungssystem, mit Eingaben und Authentifizierung. Nur serverseitige Aktionen können eine Freigabe verlangen, clientseitige Aktionen und Buttons nicht.

  2. Requires team approval einschalten

    Schalte unter 3. When the AI should use it die Option Requires team approval ein und wähle, wann eine wartende Anfrage abläuft: nach 1 Stunde, 4 Stunden, 24 Stunden (Standard) oder 3 Tagen. Die Aktion trägt dann in der Liste das Abzeichen Needs approval.

  3. Bei Bedarf in einen Ablauf einbauen

    Setze in einem Schritt Call an action den Haken bei Requires team approval. Kombiniere das mit Ask the visitor to confirm first: Der Besucher bestätigt, und erst danach geht die Anfrage an dein Team.

  4. Auf der Seite Approvals entscheiden

    Wartende Anfragen erscheinen auf der Seite Approvals in der Seitenleiste, mit einem Zähler. Jede zeigt Aktion, Agent, Eingaben, Ablaufzeit und einen Link zum Gespräch. Approve führt sie aus, Reject nimmt einen optionalen Grund auf, den der Besucher sieht.

Die Freigabe im Detail

  • Ablaufzeit nach deiner Wahl

    Jede Aktion und jeder Schritt hat eine eigene Ablaufzeit: 1 Stunde, 4 Stunden, 24 Stunden oder 3 Tage. Eine Anfrage, über die niemand rechtzeitig entscheidet, läuft nie, und der Besucher erfährt, dass das Team sie nicht rechtzeitig prüfen konnte.

  • Keine doppelten Anfragen

    In einem Gespräch können bis zu 3 Anfragen gleichzeitig warten. Ruft der Agent dieselbe Aktion mit denselben Eingaben erneut auf, während eine wartet, entsteht keine zweite Anfrage.

  • Eine Entscheidung zählt

    Klicken zwei Teammitglieder im selben Moment, entscheidet, wer zuerst klickt, und die andere Person sieht „Already decided“. Die Aktion läuft für eine Anfrage nie zweimal.

  • Ablehnen mit Begründung

    Reject fragt nach einem optionalen Grund mit bis zu 500 Zeichen. Der Besucher sieht ihn im Chat nach der Nachricht, dass das Team die Anfrage nicht freigeben konnte.

  • Zugangsdaten bleiben verborgen

    Eingaben, deren Name oder Wert nach Zugangsdaten aussieht, etwa api_key, password oder ein Bearer-Token, erscheinen auf der Seite, in E-Mails, in Slack und in Webhooks als Hidden. Header und Authentifizierung deiner Aktion werden nie mit einer Anfrage gespeichert.

  • Wer entscheiden darf

    Der Owner, Admins und Editors sowie alle anderen, deren Rolle die Aktionen des Agenten bearbeiten darf. Mitglieder mit Zugriff auf ausgewählte Agenten sehen nur deren Anfragen, Viewer können die Seite nicht öffnen.

  • Letzte Entscheidungen und Audit-Log

    Recent decisions zeigt die letzten 50, mit wer entschieden hat, wann, dem Grund und dem Ergebnis. Jede Freigabe und Ablehnung steht außerdem im Audit-Log.

  • Läuft so, wie der Agent sie ausgeführt hätte

    Eine freigegebene Aktion läuft aus der gespeicherten Aktion, innerhalb ihres 30-Sekunden-Timeouts, mit dem verifizierten Besucher und Kontakt des Gesprächs für die Platzhalter. Wurde die Aktion inzwischen gelöscht oder ausgeschaltet, schlägt die Freigabe fehl und der Besucher erfährt es.

Häufige Fragen

Was ist eine menschliche Freigabe für KI-Aktionen?

Ein Prüfschritt zwischen der Entscheidung des KI-Agenten und deinen Systemen. Will der Agent eine Aktion ausführen, die mit Requires team approval markiert ist, etwa eine Erstattung, wird der Aufruf mit seinen Eingaben gespeichert statt gesendet. Jemand aus deinem Team gibt ihn frei oder lehnt ihn ab, und nur eine freigegebene Anfrage wird ausgeführt. Das nennt man oft einen Human-in-the-Loop-Workflow.

Welchen Plan brauche ich?

Die Freigabe durch das Team ist Teil der Pläne Pro und Enterprise. In Free und Starter lässt sich der Schalter nicht einschalten. Nach einem Downgrade behalten Aktionen die Einstellung, aber der Agent führt sie aus dem Chat nicht aus, und Anfragen von vor dem Downgrade können weiter entschieden werden.

Welche Aktionen können eine Freigabe verlangen?

Jede serverseitige API-Aktion und jeder Schritt Call an action in einem Ablauf. Eine Aktion mit Requires team approval wartet in jedem Schritt, der sie aufruft, auf eine Freigabe, mit der Ablaufzeit der Aktion. Clientseitige Aktionen, die im Browser des Besuchers laufen, und Buttons können keine Freigabe verlangen.

Was sieht der Besucher, während eine Anfrage wartet?

Der Agent sagt ihm in seiner Sprache, dass die Anfrage an dein Team ging und das Ergebnis im Chat erscheint. Er kann währenddessen alles andere fragen. Ein offener Chat zeigt das Ergebnis innerhalb von etwa 15 Sekunden nach deiner Entscheidung, sonst sieht er es beim nächsten Öffnen des Chats.

Kann die KI die Angaben nach meiner Freigabe noch ändern?

Nein. Die Freigabe führt die gespeicherte Aktion einmal mit genau den Eingaben aus, die auf der Seite Approvals stehen. Die KI wird nicht noch einmal gefragt, und intoCHAT baut die Anfrage in diesem Moment aus der gespeicherten Aktion, also mit deinem aktuellen Endpunkt und deiner aktuellen Authentifizierung.

Wie erfährt mein Team davon?

Per E-Mail an alle, die über diesen Agenten entscheiden dürfen; jede Person kann das unter Notifications (Approval requests) abschalten. Pro Agent gehen bis zu 30 solcher E-Mails pro Stunde raus. Zusätzlich kannst du den Slack-Hinweis Approval request aktivieren, und Webhooks senden die Ereignisse action_approval.requested und action_approval.decided.

Was passiert in einem Ablauf, während ein Schritt wartet?

Der Schritt bleibt der aktuelle Schritt, und der Agent hilft weiter bei anderen Fragen. Wird die Anfrage freigegeben und gelingt sie, geht der Ablauf bei der nächsten Nachricht des Besuchers mit dem nächsten Schritt weiter. Bei Ablehnung, Fristablauf oder einem Fehler der Aktion endet der Ablauf. Endet der Ablauf vorher, wird die Anfrage zurückgezogen und läuft nie.

Funktioniert die Freigabe im Playground und in Tests?

Im Playground sind Anfragen echt: Sie erscheinen auf der Seite Approvals, benachrichtigen dein Team, und eine Freigabe führt deine echte Aktion aus. In Tests mit simulierten Kunden wird nichts angefragt, der Agent erfährt nur, dass die Anfrage gestellt wurde. In einem temporären Chat läuft eine Aktion mit Freigabepflicht gar nicht.

Der Agent fragt, dein Team entscheidet

Erstelle deinen Agenten kostenlos, lege deine erste API-Aktion an, schalte in Pro Requires team approval ein und probiere eine Anfrage im Playground aus.

Agent kostenlos erstellen

Kostenloser Plan, keine Kreditkarte nötig.