Web Search Confirmation¶
Die Komponente Web Search Confirmation pausiert die Flow-Ausführung und fragt den Nutzer im Karli-Studio-Chat, ob der Agent eine Websuche durchführen darf. Je nach Antwort läuft der Flow im Zweig on confirm oder on deny weiter.
Sie ist der Agentlab-Baustein für Human-in-the-Loop-Bestätigungen potenziell sensibler oder kostenintensiver Aktionen — typischerweise der Zugriff auf das öffentliche Web.
Inputs¶
| Feld | Beschreibung |
|---|---|
| Message | Der Text, der an den vom Nutzer gewählten Zweig weitergereicht wird. Typischerweise der Prompt oder die Suchanfrage, die der Agent ausführen möchte. |
| Default on Timeout | Die Entscheidung, die gilt, wenn der Nutzer nicht rechtzeitig antwortet. Standard: deny (false). |
| TTL (seconds) | Wartezeit auf eine Nutzerantwort, bevor Default on Timeout greift. Standard: 60. |
| Skip Value | Test-Override. Wenn gesetzt, überspringt die Komponente den Chat-Prompt komplett und löst sofort als confirm oder deny auf. Sinnvoll für Unit-Tests und skriptgesteuerte Läufe; in Produktion leer lassen. |
Outputs¶
Die Komponente hat zwei Outputs; beide tragen Message als Data-Payload:
| Output | Feuert, wenn |
|---|---|
| on confirm | der Nutzer bestätigt, oder der Timeout mit Default on Timeout = true abläuft, oder Skip Value zu confirm auflöst. |
| on deny | der Nutzer ablehnt, oder der Timeout mit Default on Timeout = false abläuft, oder Skip Value zu deny auflöst. |
Pro Aufruf läuft genau einer der beiden Zweige; der andere wird gestoppt.
Ablauf¶
Wenn die Komponente ausgeführt wird:
- Sendet sie ein
USER_INPUT_REQUIRED-Event über den Event-Stream des Flows, sodass der Karli-Studio-Chat dem Nutzer eine Confirm-/Deny-Abfrage zeigen kann. - Long-pollt sie die Karli-Studio-Middleware nach der Nutzerantwort.
- Die erste passende Antwort (oder ein Timeout) entscheidet den Fall; beide Output-Zweige teilen sich diese Entscheidung, sodass der Prompt dem Nutzer pro Aufruf nur einmal gezeigt wird.
Typischer Einsatz¶
Die Komponente unmittelbar vor jedes Websearch- oder externes API-Tool schalten und das Tool ausschließlich an den on confirm-Zweig hängen. Der on deny-Zweig kann dem Nutzer eine höfliche Absage geben, eine Alternative anbieten oder den Turn beenden.
