Context Input¶
Die Komponente Context Input (ContextInput) bietet einen konfigurierbaren Quellenauswähler für Agenten, die kontextbezogene Abfragen durchführen. Der Flow-Designer definiert eine Liste verfügbarer Quellen; der Nutzer wählt im Karli-Studio-Chat eine aus; der gewählte Wert wird als Data in den Flow gegeben.
Zweck¶
In vielen Workflows benötigt der Agent Kontext, der über die Chat-Nachricht hinausgeht — etwa welche Dokumentensammlung durchsucht, welches Projekt referenziert oder welche Wissensbasis abgefragt werden soll. Die Context-Input-Komponente erlaubt dem Flow-Designer, solche Optionen aufzulisten, und dem Endnutzer, eine davon vor dem Senden seiner Nachricht auszuwählen.
Funktionsweise¶
- Der Flow-Designer platziert eine Context-Input-Komponente auf der Canvas und füllt die Sources-Tabelle mit
label-/value-Zeilen. - Im Karli-Studio-Chat sieht der Nutzer einen Auswähler mit den definierten Labels und wählt einen aus.
- Karli Studio sendet die Chat-Nachricht gemeinsam mit der gewählten Quelle. Die Context-Input-Komponente mappt die Auswahl und gibt ein
Data-Objekt mitvalueundlabelan nachgelagerte Komponenten weiter.
Output¶
Der einzige Output der Komponente, Selected Value, ist ein Data der Form:
{ "value": "<gematchter value>", "label": "<gematchtes label>" }
Ist Required aktiviert und passt die Auswahl zu keiner Quelle, wirft die Komponente einen Validierungsfehler, der die verfügbaren Quellen auflistet. Ist Required deaktiviert, wird stattdessen ein leeres Data ausgegeben ({"value": "", "label": ""}).
Verwandte Seiten¶
- Konfiguration — Felder und Matching-Regeln
- Chat-Verhalten — wie der Auswähler in Karli Studio erscheint