Konfiguration

Die Konfiguration einer Agent-Version ist in folgende Tabs unterteilt:

Grundeinstellungen

In den Grundeinstellungen werden die Basisinformationen und das Kernverhalten des Agents definiert.

Allgemein

• Versionsname: Der Name dieser Version, der in der Agentenliste angezeigt wird.
• Status: Der Status der Version (Entwurf, Aktiv, Inaktiv).
• Systemsprache(n): Die bevorzugten Sprachen des Agents. Der Agent versucht, in einer dieser Sprachen zu antworten, basierend auf der Sprache des Benutzers. Verfügbare Sprachen: Deutsch, Englisch, Französisch, Spanisch, Italienisch, Rumänisch.

Systemnachrichten

Die Systemnachrichten steuern das gesamte Verhalten des Agents. Änderungen in diesem Bereich können die Funktionsweise des Agents erheblich beeinflussen.

• Rolle und Ziel: Definiert den Zweck des Agents und stellt sicher, dass er hilfreich, relevant und auf die Bedürfnisse der Benutzer ausgerichtet bleibt.
• Antwortverhalten und Format (optional): Definiert Ton, Stil und Antwortstruktur, um Klarheit, Konsistenz und Übereinstimmung mit den Erwartungen der Benutzer zu gewährleisten.
• Einschränkungen und Limitierungen (optional): Definiert Grenzen für die Antworten des Agents und hilft, Spekulationen, Fehlinformationen und schädliche Inhalte zu vermeiden.
• Sicherheit und Bias (optional): Hilft, den Agent zu weniger voreingenommenen, schädlichen oder unethischen Inhalten und zu verantwortungsvolleren und faireren Interaktionen zu leiten.

tipp

Systemnachrichten können Few-Shot-Beispiele enthalten: Integrieren Sie Beispiel-Dialoge direkt in die Rolle oder Systemnachricht, um das Verhalten des Agents weiter zu schärfen — z. B. gewünschte Antwortformate oder Reaktionen auf bestimmte Fragetypen.

Datenquellen

Im Tab Datenquellen werden die verfügbaren Quellen des Agents konfiguriert. Alle hier aktivierten Quellen stehen anschließend im Flow zur Verwendung in Tool Nodes zur Verfügung.

Es gibt vier Typen von Datenquellen:

Standard-Tools

Integrierte Tools wie die Websuche, die der Agent zur Ergänzung seiner Antworten nutzen kann. Standard-Tools sind vordefiniert und können derzeit nicht kundenspezifisch erweitert werden.

info

Für kundenspezifische Logik (z. B. Anbindung eigener APIs oder Fachsysteme) wird empfohlen, eine MCP-Verbindung über eine MCP-fähige Middleware einzurichten.

warnung

Für die Websuche wird der externe Dienst Tavily verwendet. Im Zuge einer Suche können möglicherweise personenbezogene Daten übertragen werden.

Gepflegtes Wissen

Zugriff auf im AI Hub verwaltete Wissenssammlungen. Weitere Informationen unter Gepflegtes Wissen.

Verknüpftes Wissen

Zugriff auf synchronisierte externe Wissensquellen. Weitere Informationen unter Verknüpftes Wissen.

MCP-Verbindungen

Zugriff auf über das Model Context Protocol (MCP) angebundene Tools und Datenquellen. Weitere Informationen unter MCP-Verbindungen.

Einstellungen pro Datenquelle

Für jede Datenquelle können folgende Einstellungen angepasst werden:

• Anweisung: Spezifische Anweisung, wie diese Datenquelle verwendet werden soll.
• Anzahl abgerufener Dokumente: Maximale Anzahl der abgerufenen Dokumente (bei Wissensquellen).
• Suchtiefe: Basis, Erweitert oder Automatisch (bei Web-Tools).
• Node Updates senden: Aktiviert Echtzeit-Statusanzeigen bei der Verwendung dieser Quelle.

Flow

Im Tab Flow wird der Agentic Workflow definiert. Über einen visuellen Editor werden Nodes per Drag-and-Drop platziert und miteinander verbunden, um den Verarbeitungspfad einer Benutzeranfrage zu gestalten.

Eine vollständige Beschreibung aller verfügbaren Nodes finden Sie unter Flow.

Benutzeroberfläche

Im Tab Benutzeroberfläche wird das Erscheinungsbild und die Interaktionsmöglichkeiten des Agents konfiguriert.

Allgemein

• Verlauf anzeigen: Aktiviert die Anzeige der Konversationshistorie für Benutzer. Auch wenn deaktiviert, wird der Verlauf gespeichert, aber nicht angezeigt.
• Temporärer Chat aktivieren: Ermöglicht eine separate Option für temporäre Chats, bei denen Konversationen nicht gespeichert werden, Feedback-Funktionen deaktiviert sind und Chats nicht für spätere Überprüfung verfügbar sind.

Initiale Benutzerinteraktion

• Nachricht: Die Begrüßungsnachricht, die zu Beginn eines neuen Chats angezeigt wird.
• Vorschläge (optional): Vorschläge erscheinen vor der ersten Benutzereingabe und helfen häufige Anwendungsfälle abzudecken. Jeder Vorschlag besteht aus:
  • Titel: Wird im Chat angezeigt.
  • Prompt: Wird als Eingabe verwendet, wenn der Vorschlag angeklickt wird.
  • Beschreibung: Zusätzliche Erklärung des Vorschlags.

Eingabe

• Platzhaltertext: Der Text, der im Eingabefeld angezeigt wird, bevor der Benutzer tippt.
• Zeichenlimit: Maximale Anzahl an Zeichen, die ein Benutzer eingeben kann. Die Begrenzung der Eingabelänge hilft, den Token-Verbrauch und damit die Verarbeitungskosten zu reduzieren. Standard: 10.000 Zeichen.
• Sprache-zu-Text: Ermöglicht die Eingabe per Sprache.
  • Aus: Deaktiviert.
  • KI-basiert: Bessere Qualität und privat, erfordert ein konfiguriertes Speech-to-Text-Modell.
  • Browser-basiert: Schneller und günstiger, aber nicht privat und nicht in jedem Browser verfügbar.
• Dateieingabe aktivieren: Ermöglicht Benutzern das Hochladen von Dateien im Chat, die als Kontext für den Agent verwendet werden können.

Statusanzeige

• Node Updates aktivieren: Zeigt Echtzeit-Updates im Chat an, während der Agent längere Anfragen verarbeitet. Nützlich bei Flows mit Tools oder längerer Verarbeitungsdauer.
• Node-Update-Modus (wenn Node Updates aktiviert):
  • Basis: Zeigt immer das letzte Update an.
  • Debug: Eine strukturierte Übersicht aller Updates.

Feedback & Kommunikation

• Feedback aktivieren: Ermöglicht Benutzern, Feedback zu den Antworten des Agents zu geben (Daumen hoch/runter).
• Feedback-Hinweistext (wenn Feedback aktiviert): Hinweis, der Benutzern beim Einreichen von Feedback angezeigt wird und darüber informiert, dass das Feedback von Administratoren eingesehen werden kann.
• Feedback-E-Mails (wenn Feedback aktiviert): E-Mail-Adressen, die Benachrichtigungen über Benutzerfeedback erhalten. Mehrere Adressen werden durch Kommas getrennt.

Compliance

Im Tab Compliance werden rechtliche Hinweise und Regeln für die Anzeige von Erklärungstexten konfiguriert.

Rechtliches

• Haftungsausschluss-Text: Der Hinweistext, der vor der Nutzung des Agents angezeigt wird.
• Footer-Haftungsausschluss-Text: Der Hinweistext am unteren Rand des Agent-Fensters.

Regeln für Erklärungstexte (Disclaimer Rules)

Disclaimer Rules definieren Regeln, wann zusätzliche Erklärungstexte basierend auf den Ein- oder Ausgaben des Agents angezeigt werden sollen. Mehrere Regeln können gleichzeitig greifen (additiv). Die Hinweise werden nach der Antwort des Agents angezeigt.

Für jede Regel wird konfiguriert:

• Regex-Muster: Ein regulärer Ausdruck, der mit der Eingabe oder Ausgabe abgeglichen wird.
• Disclaimer-Text: Der Text, der am Ende der Chat-Antwort angezeigt wird, wenn das Muster zutrifft.

Qualität

Im Tab Qualität werden die Evaluierungseinstellungen und das Fehlermanagement des Agents konfiguriert.

Qualitätssicherung

• Evaluierungsanweisungen: Definiert den Systemprompt für den Evaluator, der festlegt, nach welchen Kriterien die Antworten des Agents bei automatisierten Evaluierungsläufen bewertet werden.

Fehlermanagement

• Fallback-Nachricht für verbotene Begriffe: Die Nachricht, die angezeigt wird, wenn eine Antwort des Agents aufgrund verbotener Begriffe blockiert wird. Dieser Text ersetzt die ursprüngliche Antwort.

Datenschutz

Im Tab Datenschutz werden Einstellungen zur Anonymisierung und zum Schutz personenbezogener Daten konfiguriert.

Chat-Verwaltung

• Admin-Chat-Zugriff aktivieren: Ermöglicht Administratoren, die Details einer Konversation in den Chat-Protokollen einzusehen, einschließlich Teilnehmer und Nachrichten. Unabhängig von dieser Einstellung behalten Administratoren den Zugriff für Moderations- und Verwaltungszwecke.

Anonymisierung

• Anonymisierung aktivieren: Wenn aktiviert, werden alle Konversationen dieser Version 24 Stunden nach Erstellung anonymisiert.
• Anonymisierungs-Anweisungen (wenn Anonymisierung aktiviert): Detaillierte Anweisungen für die KI, wie die Anonymisierung durchzuführen ist — welche Daten geschützt und welche Informationen beibehalten werden sollen.

Admin-Funktionen

• Benutzernamen verbergen: Verbirgt Benutzernamen in den Chat-Protokollen, um die Privatsphäre zu schützen und sicherzustellen, dass persönliche Identifikatoren für Administratoren nicht sichtbar sind.

Sicherheit

Im Tab Sicherheit werden Mechanismen zum Schutz vor unerwünschten Ausgaben und zur Verhinderung von Systemprompt-Leaks konfiguriert.

Verbotene Begriffe (Output Guard)

Der Output Guard prüft die generierten Antworten des Agents auf verbotene Begriffe. Wird ein verbotener Begriff erkannt, wird die Antwort unterdrückt und die im Tab Qualität konfigurierte Fallback-Nachricht angezeigt.

• Embeddings-Prüfung aktivieren: Aktiviert erweiterte Ähnlichkeitsprüfungen gegen verbotene Begriffe in der Ausgabe des Agents. Diese Prüfung erkennt auch semantisch ähnliche Formulierungen, nicht nur exakte Übereinstimmungen. Die Aktivierung kann die Performance beeinträchtigen.
• Begriffslisten: Liste der verbotenen Begriffe mit jeweiligem Ähnlichkeitsschwellenwert (in Prozent), der festlegt, ab welcher Übereinstimmung der Begriff als erkannt gilt.

info

Die hier konfigurierten Begriffslisten schützen die Ausgabe des Agents. Für den Schutz der Eingabe kann die Input Guard Node im Flow verwendet werden.

Systemprompt-Schutz

• Systemprompt-Leakage-Prüfung aktivieren: Prüft die Ausgabe des Agents auf Inhalte aus den definierten Systemprompts. Wird eine Übereinstimmung gefunden, wird die Generierung abgebrochen, um ein Leaken des Systemprompts zu verhindern.
• Schwellenwert (wenn aktiviert): Bestimmt, wie streng die Prüfung ist (0 = perfekte Übereinstimmung erforderlich, 1 = erkennt jede Ähnlichkeit). Standard: 0,3.

Verbotene Begriffe verwalten (Prohibited Terms)

Die Begriffslisten, die im Output Guard und in der Input Guard Node verwendet werden, werden hier im Tab Sicherheit verwaltet. Jede Liste besteht aus einzelnen Begriffen mit einem individuellen Ähnlichkeitsschwellenwert.

Begriffsliste erstellen:

• Name: Bezeichnung der Liste (z. B. „Vertrauliche Begriffe", „Wettbewerber").
• Beschreibung (optional): Erklärung zum Zweck der Liste.

Begriff hinzufügen:

• Begriff: Der unerwünschte Text.
• Ähnlichkeitsschwellenwert (%): Legt fest, ab welcher semantischen Übereinstimmung der Begriff als erkannt gilt.

Begriffslisten können in mehreren Kontexten wiederverwendet werden — sowohl im Output Guard (Tab Sicherheit) als auch in Input Guard Nodes im Flow.