# Willkommen im Handbuch Dieses Handbuch ist dein Nachschlagewerk für die Epic AI Platform. Dieses Handbuch ist dein Nachschlagewerk für die space.vars.PRODUCT\_NAME. Es richtet sich sowohl an neue Nutzer, die ihre ersten Schritte auf der Plattform machen, als auch an erfahrene Anwender, die gezielt nach bestimmten Funktionen suchen. ### Was erwartet dich? Das Handbuch ist thematisch in mehrere Bereiche gegliedert, die den Aufbau der Plattform widerspiegeln: * [Einführung](/epic-ai-platform/epic-ai-platform/einfuhrung): Login, Registrierung und die ersten Schritte bis zu deinem ersten funktionierenden space.vars.TERM\_AI\_AGENT. * [Inbox](/epic-ai-platform/epic-ai-platform/ai-agent/inbox): Alles rund um die Bearbeitung von Konversationen – von der Bereiche-Navigation über Kontakte und Organisationen bis hin zu Benachrichtigungen. * space.vars.TERM\_AI\_AGENT – Entwicklung: Der [Flow-Builder](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder), Flows, Blöcke, Elemente, Intentionen, Entitäten, FAQs, Variablen und alle weiteren Bausteine, mit denen du das Verhalten deines space.vars.TERM\_AI\_AGENTs gestaltest. * space.vars.TERM\_AI\_AGENT – Optimierung: [Modelle](/epic-ai-platform/epic-ai-platform/ai-agent/daten/modelle) trainieren, [Trainingsdaten](/epic-ai-platform/epic-ai-platform/ai-agent/daten/trainingsdaten) auswerten und die Erkennungsqualität deines space.vars.TERM\_AI\_AGENTs kontinuierlich verbessern. * Integration: [Apps](/epic-ai-platform/epic-ai-platform/workspace/apps), der Appstore und die Anbindung externer Systeme über REST-APIs. * [Wissen](/epic-ai-platform/epic-ai-platform/ai-agent/build/wissen): Externe Informationsquellen wie PDFs und Websites bereitstellen und über Wissensgruppen gezielt steuern. * [Einstellungen](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen): Sprachen, Benutzer, Teams, Kanäle, space.vars.TERM\_AI-Einstellungen und alle weiteren Konfigurationsmöglichkeiten. * [Workspace](/epic-ai-platform/epic-ai-platform/workspace): Workspace-Verwaltung, Rollen und die Erstellung eigener Apps. * [Statistiken & Export](/epic-ai-platform/epic-ai-platform/ai-agent/statistiken): Auswertung der Performance deines space.vars.TERM\_AI\_AGENTs und Export der Rohdaten. ### Wie nutzt du dieses Handbuch am besten? Jeder Artikel folgt einer einheitlichen Struktur: Eine kurze Einleitung erklärt, worum es geht. Danach erfährst du, wo du die Funktion in der Plattform findest, wie sie funktioniert und wie du sie einrichtest. Praxisbeispiele und Best Practices helfen dir, das Gelernte direkt anzuwenden. Wenn du gerade erst startest, empfehlen wir dir den Artikel [Einführung](/epic-ai-platform/epic-ai-platform/einfuhrung). Er führt dich kompakt durch die Einrichtung – vom Workspace bis zum ersten funktionierenden Kanal. Wenn du eine bestimmte Funktion suchst, nutze die thematische Gliederung oder die Suchfunktion, um direkt zum passenden Artikel zu springen. ### Support Solltest du im Handbuch nicht fündig werden, erreichst du unser Support-Team jederzeit über das [Support-Portal](/support). # Epic AI Platform Die space.vars.PRODUCT\_NAME ist eine Plattform zur Erstellung, Verwaltung und Optimierung von space.vars.TERM\_AI-gestützten space.vars.TERM\_AI\_AGENTs. Mit ihr baust du intelligente Assistenten, die Kundenanfragen automatisiert beantworten – per Telefon, Chat, E-Mail oder Messenger. *** ### Für wen ist die Plattform? Die space.vars.PRODUCT\_NAME richtet sich an Unternehmen und Teams, die ihre Kundenkommunikation automatisieren und skalieren möchten. Typische Einsatzbereiche sind Kundenservice, Support, Vertrieb und interne Prozessautomatisierung. Die Plattform ist so aufgebaut, dass Fachanwender – also Personen ohne technischen Hintergrund – space.vars.TERM\_AI\_AGENTs eigenständig erstellen und betreiben können. Für fortgeschrittene Anwendungsfälle bietet sie gleichzeitig API-Anbindungen, benutzerdefinierte Apps und flexible space.vars.TERM\_AI-Konfigurationen. *** ### Was kann die Plattform? Die space.vars.PRODUCT\_NAME deckt den gesamten Lebenszyklus eines space.vars.TERM\_AI\_AGENTs ab: von der Entwicklung über den Betrieb bis zur kontinuierlichen Optimierung. * **Konversationen gestalten:** Im visuellen space.vars.TERM\_FLOW\_BUILDER baust du per Drag & Drop Gesprächsabläufe auf – ohne Programmierkenntnisse. * **Kanalübergreifend kommunizieren:** Dein space.vars.TERM\_AI\_AGENT ist über verschiedene Kanäle erreichbar – darunter Telefon (Voice), Web-Widget, WhatsApp, Telegram, Facebook Messenger und E-Mail. * **Mensch und** space.vars.TERM\_AI **kombinieren:** Die Inbox ermöglicht es deinem Team, space.vars.TERM\_AI-geführte Gespräche nahtlos zu übernehmen, weiterzubearbeiten oder Kollegen zuzuweisen. * **Externe Systeme anbinden:** Über Apps und API-Schnittstellen verbindest du deinen space.vars.TERM\_AI\_AGENT mit CRM-Systemen, Shop-Plattformen, Versanddienstleistern und weiteren Diensten. * **Wissen bereitstellen:** Lade PDFs hoch oder binde Websites ein, damit dein space.vars.TERM\_AI\_AGENT Fragen auf Basis deiner Inhalte beantworten kann. * **Erkennungsqualität verbessern:** Über Trainingsdaten, Modellbewertungen und gezielte Nachbearbeitung wird dein space.vars.TERM\_AI\_AGENT mit der Zeit immer präziser. *** ### Erste Schritte Wenn du gerade erst startest, empfehlen wir dir den Artikel [Einführung](/epic-ai-platform/epic-ai-platform/einfuhrung). Er führt dich Schritt für Schritt von der Registrierung bis zu deinem ersten funktionierenden space.vars.TERM\_AI\_AGENT. Mache dich optional erst mit den nachfolgenden Konzepten vertraut. *** ### Kernkonzepte im Überblick Bevor du in die einzelnen Artikel eintauchst, helfen dir die folgenden Begriffe, die Plattform schnell einzuordnen. Jedes Konzept wird in einem eigenen Handbuch-Artikel ausführlich behandelt. #### Workspace Ein Workspace ist dein zentraler Arbeitsbereich. Er bündelt alle space.vars.TERM\_AI\_AGENTs, Apps und Teammitglieder eines Projekts oder Unternehmens. Du kannst mehrere Workspaces anlegen – z. B. einen pro Unternehmen oder Geschäftsbereich. (Siehe Artikel [Workspace](/epic-ai-platform/epic-ai-platform/workspace).) #### space.vars.TERM\_AI\_AGENT Ein space.vars.TERM\_AI\_AGENT ist ein eigenständiger, intelligenter Assistent innerhalb deines Workspaces. Er enthält die gesamte Konversationslogik, alle Einstellungen und die angebundenen Kanäle. Pro Workspace kannst du mehrere space.vars.TERM\_AI\_AGENTs anlegen – z. B. einen für den Kundenservice und einen für den Vertrieb. (Siehe Artikel [Anlegen eines AI Agents](/epic-ai-platform/epic-ai-platform/ai-agent).) #### space.vars.TERM\_FLOW\_BUILDER und Flows Der space.vars.TERM\_FLOW\_BUILDER ist die visuelle Arbeitsumgebung, in der du das Verhalten deines space.vars.TERM\_AI\_AGENTs gestaltest. Auf einem Canvas platzierst du Schritte – z. B. Nachrichten, Bedingungen oder API-Aufrufe – und verbindest sie miteinander. Jeder zusammenhängende Ablauf wird als Flow bezeichnet. Flows lassen sich in Subflows unterteilen, um komplexe Prozesse übersichtlich zu halten. (Siehe Artikel [space.vars.TERM\_FLOW\_BUILDER](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder) und [Flows](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/flows).) #### Blöcke und Elemente Ein Block ist der zentrale Baustein im space.vars.TERM\_FLOW\_BUILDER. Er definiert, was dein space.vars.TERM\_AI\_AGENT an einer bestimmten Stelle im Gespräch tut. Innerhalb eines Blocks kombinierst du Elemente – z. B. eine Textnachricht senden, eine Variable speichern oder ein Tag setzen. (Siehe Artikel [Block](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/block) und die Artikel zu den Element-Kategorien: [Basis](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/block/elemente-basis), [Aktionen](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/block/elemente-aktionen), [Dateien](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/block/elemente-dateien), [Voice Agent](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/block/elemente-voice-agent).) #### Intentionen und FAQs Intentionen ermöglichen es deinem space.vars.TERM\_AI\_AGENT, die Absicht hinter einer Nutzereingabe zu erkennen – z. B. „Ich möchte meine Bestellung stornieren" wird der Intention „Stornierung" zugeordnet. FAQs sind vordefinierte Frage-Antwort-Paare für häufig gestellte, statische Fragen wie Öffnungszeiten oder Kontaktdaten. (Siehe Artikel [Intentionen](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/intentionen) und [FAQs](/epic-ai-platform/epic-ai-platform/ai-agent/build/faqs).) #### Entitäten und Variablen Entitäten erkennen automatisch bestimmte Daten in Nutzereingaben – z. B. eine IBAN, eine Telefonnummer oder ein Datum. Variablen sind Speicherorte, in denen diese und weitere Werte während einer Konversation abgelegt und im Flow weiterverwendet werden können. (Siehe Artikel [Entitäten](/epic-ai-platform/epic-ai-platform/ai-agent/build/entitaten) und [Variablen](/epic-ai-platform/epic-ai-platform/ai-agent/build/variablen).) #### Inbox Die Inbox ist der zentrale Arbeitsplatz für dein Team. Hier laufen alle Konversationen kanalübergreifend zusammen. Mitarbeiter können space.vars.TERM\_AI-geführte Gespräche übernehmen, intern zusammenarbeiten, Konversationen zuweisen und space.vars.TERM\_AI-gestützte Funktionen wie Zusammenfassungen oder Antwortvorschläge nutzen. (Siehe Artikel [Inbox](/epic-ai-platform/epic-ai-platform/ai-agent/inbox) und die zugehörigen Unterartikel.) #### Kanäle Kanäle sind die Kommunikationswege, über die Nutzer mit deinem space.vars.TERM\_AI\_AGENT interagieren. Die Plattform unterstützt Telefonie (Voice), Web-Widget, WhatsApp, Telegram, Facebook Messenger und E-Mail. Jeder Kanal wird einer Bereitstellungsumgebung zugeordnet – Entwicklung, Test oder Produktiv. (Siehe Artikel [Kanäle](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/kanale) und die Artikel zu den einzelnen Kanaltypen.) #### Wissen Über die Funktion „Wissen" stellst du deinem space.vars.TERM\_AI\_AGENT externe Informationen zur Verfügung – z. B. als PDF oder über gecrawlte Websites. Diese Inhalte werden automatisch indexiert und stehen dem space.vars.TERM\_AI\_AGENT als Kontext zur Beantwortung von Anfragen bereit. (Siehe Artikel [Wissen](#wissen) und [Wissensgruppen](broken://pages/fbOEOuNppnXZspf87qJo).) #### Versionen und Bereitstellungsumgebungen Versionen sind Momentaufnahmen deines space.vars.TERM\_AI\_AGENTs. Sie sichern einen bestimmten Entwicklungsstand und bilden die Grundlage für die Bereitstellung. Die Plattform bietet drei Umgebungen: Entwicklung (DEV), Test (TEST) und Produktiv (PROD) – damit du Änderungen testen kannst, bevor sie für Endnutzer sichtbar werden. (Siehe Artikel [Versionen & Bereitstellungsumgebungen](/epic-ai-platform/epic-ai-platform/ai-agent/versionen-and-bereitstellungsumgebungen).) #### Apps und Appstore Apps verbinden deinen space.vars.TERM\_AI\_AGENT mit externen Systemen über REST-APIs. Du kannst fertige Apps aus dem Appstore installieren oder eigene Apps im Workspace erstellen. Die Module einer App lassen sich als Schritte im space.vars.TERM\_FLOW\_BUILDER einbinden oder als Tools in space.vars.TERM\_AI-gestützten Gesprächsschritten nutzen. (Siehe Artikel [Apps / Appstore](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/apps-appstore), [Meine Apps](broken://pages/LZyImpcwqBz0rZq1Ja53) und [Apps](/epic-ai-platform/epic-ai-platform/workspace/apps).) # Einführung In diesem Artikel erfährst du, wie du dich registrierst, anmeldest und die ersten Schritte bis zu deinem ersten funktionierenden AI Agent durchläufst. ### Anmeldung und Registrierung #### Account erstellen Nach Vertragsabschluss wirst du aufgefordert, einen Account auf der space.vars.PRODUCT\_NAME anzulegen. Auf der Anmeldeseite hast du zwei Möglichkeiten: * **Mit Google anmelden:** Klicke auf „Mit Google anmelden", um dich direkt mit deinem bestehenden Google-Konto zu registrieren. * **Mit E-Mail und Passwort:** Gib deine E-Mail-Adresse und ein Passwort ein und klicke auf „Jetzt registrieren". #### Anmelden Wenn du bereits einen Account besitzt, melde dich auf der Anmeldeseite mit deinen Zugangsdaten an – entweder über dein Google-Konto oder per E-Mail und Passwort. Falls du dein Passwort vergessen hast, klicke auf der Anmeldeseite auf „Passwort vergessen?" und folge den Anweisungen. *** ### Erste Schritte – Dein Weg zum ersten space.vars.TERM\_AI\_AGENT Der folgende Abschnitt führt dich Schritt für Schritt durch die Einrichtung; vom Workspace bis zum ersten funktionierenden Kanal. Jeder Schritt wird hier bewusst kompakt gehalten. Für Details zu den einzelnen Bereichen findest du Verweise auf die ausführlichen Handbuchartikel. #### Schritt 1: Workspace erstellen Nach dem ersten Login siehst du deine Platform-Übersicht. Da du noch keinen [Workspace](/epic-ai-platform/epic-ai-platform/workspace) hast, musst du zunächst einen anlegen. 1. Klicke auf „Neuen Workspace erstellen". 2. Vergib einen aussagekräftigen Namen – z. B. den Namen deines Unternehmens oder Projekts. Der Name kann nachträglich angepasst werden. 3. Klicke auf „Workspace erstellen". Ein Workspace ist dein zentraler Arbeitsbereich. Er bündelt alle space.vars.TERM\_AI\_AGENTs, Apps und Teammitglieder an einem Ort. *** #### Schritt 2: space.vars.TERM\_AI\_AGENT erstellen Nach der Workspace-Erstellung landest du in der space.vars.TERM\_AI\_AGENT-Übersicht. Hier [legst du deinen ersten AI Agent an](broken://pages/YLtDv45JrrQ80cdI0jG3). 1. Klicke auf die Karte „Neuen space.vars.TERM\_AI\_AGENT erstellen". 2. Vergib einen Namen für deinen space.vars.TERM\_AI\_AGENT – z. B. „Kundenservice" oder „Support Agent". Dieser Name ist nur intern sichtbar. 3. Lege die Standardsprache deines space.vars.TERM\_AI\_AGENT fest. Diese kann nachträglich nicht geändert werden. 4. Weise deinem space.vars.TERM\_AI\_AGENT einen Workspace zu. 5. Klicke auf „space.vars.TERM\_AI\_AGENT erstellen. Sobald dein space.vars.TERM\_AI\_AGENT bereit ist, kannst du auf "Jetzt konfigurieren" klicken um direkt im AI Agent zu landen. #### Schritt 3: Flow einrichten Wenn du deinen space.vars.TERM\_AI\_AGENT öffnest, landest du automatisch auf dem Dashboard. Wähle hier (oder aus der Navigationsleiste) die Option " space.vars.TERM\_FLOW\_BUILDER". Der [Flow Builder](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder) ist die zentrale Arbeitsumgebung, in der du das Verhalten deines space.vars.TERM\_AI\_AGENTs gestaltest. Beim ersten Aufrufen wirst du aufgefordert, deinen ersten Flow einzurichten. Dieser wird automatisch zum **Standard-Flow** und enthält zwei wichtige Schritte: * [**Einstieg**](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/flows#der-standard-flow-einstieg-and-fallback)**:** Hier beginnen alle Konversationen mit deinem space.vars.TERM\_AI\_AGENT. * [**Fallback**](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/flows#der-standard-flow-einstieg-and-fallback)**:** Hierhin wird die Konversation geleitet, wenn etwas schiefgeht oder keine Intention erkannt wird, oder unverbundene Enden durchlaufen werden. So richtest du deinen ersten Flow ein: 1. Klicke auf „Flow einrichten", um deinen Standard-Flow anzulegen. 2. Öffne den Flow, um auf den Canvas – die visuelle Arbeitsfläche – zu gelangen. 3. Füge über die rechte Seitenleiste einen [Block](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/block) hinzu (`Schritt hinzufügen → Häufig verwendet → Block`) und verbinde den Einstieg mit ihm. 4. Gib dem Block einen Namen – z. B. „Begrüßung". 5. Klicke auf „Element hinzufügen" und wähle [Textnachricht](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/block/elemente-basis#textnachricht). 6. Trage eine Begrüßungsnachricht ein – z. B. „Hallo! Wie kann ich dir helfen?" 7. Aktiviere die Option „Erwartet Nutzereingabe nach diesem Block". 8. Bestätige mit „Ok". 9. Verbinde den Block-Schritt mit deinem neuen Block, indem du vom Ausgangspunkt des Einstiegs eine Linie zu einem weiteren Block ziehst. Füge auch im zweiten Block eine Textnachricht ein. Damit sind die ersten Schritte getan! Dein Flow ist schon jetzt funktionsfähig. {% hint style="success" %} Richte auch den Fallback ein, damit dein space.vars.TERM\_AI\_AGENT bei nicht erkannten Eingaben eine sinnvolle Rückmeldung gibt – z. B. „Entschuldigung, das habe ich nicht verstanden. Kannst du deine Frage anders formulieren?" {% endhint %} #### Schritt 4: Flow im Debugging testen Bevor du einen Kanal einrichtest, solltest du deinen Flow testen. Das [Debugging-Tool](/epic-ai-platform/epic-ai-platform/ai-agent/debugging) ermöglicht dir, Gespräche zu simulieren, ohne, dass echte Nutzer betroffen sind. 1. Klicke in der Navigationsleiste links auf den Button „Debugging öffnen". 2. Es öffnet sich ein Chat-Fenster auf der rechten Seite. Hier erscheint nun die Bergrüßungsnachricht. 3. Schreibe eine Testnachricht – z. B. „Hallo" – und prüfe, ob dein space.vars.TERM\_AI\_AGENT wie erwartet mit dem nächsten Schritt fortfährt. 4. Nutze das Uhrensymbol „Nachrichten zurücksetzen", um die Konversation neu zu starten. {% hint style="info" %} Änderungen an Flows sind sofort im Debugging testbar – ohne, dass eine Version erstellt werden muss. Änderungen an Intentionen oder Entitäten erfordern jedoch ein neues Modelltraining. {% endhint %} #### Schritt 5: Kanal anlegen Damit dein space.vars.TERM\_AI\_AGENT für Nutzer erreichbar ist, musst du einen [Kanal](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/kanale) einrichten. Ein Kanal definiert den Kommunikationsweg – z. B. Telefon, Web-Widget, E-Mail oder WhatsApp. Du findest die Kanalverwaltung unter `Einstellungen → Kanäle`. Für einen schnellen Einstieg empfehlen wir das [Web-Widget](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/kanale/web-kanal). So richtest du es ein: 1. Wähle aus der Übersicht "Web-Widget" 2. Vergib einen Kanalnamen – z. B. „Web-Widget Test". 3. Wähle als Bereitstellungsumgebung zunächst **Entwicklung** oder **Test**. 4. Hinterlege die Domain deiner Website. Du kannst diese auch vorerst leer lassen. 5. Bestätige mit „Kanal erstellen". Über den Button "Widget" kannst du anschließend Farben, Texte und das Erscheinungsbild anpassen. Mit „Widget live testen" kannst du das Widget direkt in einem Testfenster öffnen und eine echte Konversation führen – ganz ohne Einbindung. {% hint style="info" %} Im Gegensatz zum Debug-Chat werden über das Web-Widget geführte Nachrichten dauerhaft in der [Inbox](/epic-ai-platform/epic-ai-platform/ai-agent/inbox) gespeichert. {% endhint %} #### Schritt 6: Testen und Weiterentwickeln Nach der Kanaleinrichtung kannst du deinen space.vars.TERM\_AI\_AGENT in der gewählten Bereitstellungsumgebung testen. 1. Öffne das Web-Widget über „Widget aufrufen" und führe eine Testkonversation. 2. Wechsle parallel in die **Inbox** (`Navigation → Inbox`), um die Konversation dort einzusehen und die Inbox-Funktionen kennenzulernen. (Tipp: Öffne die Inbox in einem neuen Tab). 3. Prüfe, ob der space.vars.TERM\_AI\_AGENT wie erwartet antwortet und ob die Konversation korrekt in der Inbox erscheint. Sobald dein Flow stabil läuft, kannst du ihn schrittweise erweitern: * [Weitere Schritte](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder) einfügen, etwa das KI-gestützte [Gespräch führen](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/gen-ai-gesprach-fuhren). * [Intentionen](/epic-ai-platform/epic-ai-platform/ai-agent/build/intentionen) anlegen, damit dein space.vars.TERM\_AI\_AGENT verschiedene Nutzeranliegen erkennt. * [Variablen](/epic-ai-platform/epic-ai-platform/ai-agent/build/variablen) nutzen, um Informationen zu speichern und personalisierte Antworten zu erzeugen. * [Entitäten](/epic-ai-platform/epic-ai-platform/ai-agent/build/entitaten) einrichten, um spezifische Daten wie IBANs oder Telefonnummern automatisch zu extrahieren. * [Wissen](/epic-ai-platform/epic-ai-platform/ai-agent/build/wissen) hinterlegen, damit dein space.vars.TERM\_AI\_AGENT auf Basis von Dokumenten oder Webseiten antworten kann. * [Versionen](/epic-ai-platform/epic-ai-platform/ai-agent/versionen-and-bereitstellungsumgebungen) erstellen, um einen stabilen Stand zu sichern und deinen space.vars.TERM\_AI\_AGENT in der Produktivumgebung bereitzustellen. *** ### Best Practices * **Klein anfangen:** Starte mit einem einfachen Flow und erweitere ihn schrittweise. Ein funktionierender Begrüßungs-Flow mit Fallback ist ein solider Ausgangspunkt. * **Regelmäßig testen:** Nutze das Debugging-Tool nach jeder Änderung. So erkennst du Fehler frühzeitig, bevor sie bei echten Nutzern auftreten. * **Erst testen, dann live gehen:** Richte deinen Kanal zunächst in der Test-Umgebung ein. Erst, wenn alles wie gewünscht funktioniert, erstellst du eine Version und stellst sie in der Produktivumgebung bereit. * **Inbox kennenlernen:** Öffne parallel (in einem neuen Tab oder Fenster) zu deinen Tests die Inbox. So bekommst du ein Gefühl dafür, wie Konversationen aus Mitarbeitersicht aussehen und welche Funktionen ihnen zur Verfügung stehen. * **Teammitglieder frühzeitig einbinden:** [Lade Kollegen über die Benutzerverwaltung ein](/epic-ai-platform/epic-ai-platform/workspace/benutzer) und weise ihnen passende Rollen zu – so kann dein Team von Anfang an mitarbeiten. # Workspace Ein Workspace ist dein zentraler Arbeitsbereich in der Epic AI Platform. Er bündelt alle AI Agents, Apps und Teammitglieder eines Projekts oder Unternehmens an einem Ort. ### Wo finde ich das? Die **Übersicht** ist die erste Seite, die du nach dem Login siehst. AI Agents und Workspaces werden hier gemeinsam aufgelistet. Über das Suchfeld **„Nach Name oder ID durchsuchen"** findest du gezielt einen Workspace oder AI Agent. Mit den Filtern **„AI Agents"** und **„Workspaces"** blendest du ein, was du sehen möchtest. Jeder Eintrag zeigt seinen Namen, die zugehörige Organisation und – bei AI Agents – ein Typ-Kennzeichen (z. B. „AI Agent"). *** ### Was ist ein Workspace? Ein Workspace ist eine Organisationseinheit, die mehrere AI Agents und Apps bündelt. Du kannst dir einen Workspace wie einen gemeinsamen Ordner vorstellen, in dem alles zusammengehört, was zu einem Projekt oder Unternehmen gehört. Innerhalb eines Workspace kannst du: * AI Agents erstellen und verwalten * [Apps](/epic-ai-platform/epic-ai-platform/workspace/apps) anlegen und konfigurieren * [Teammitglieder](/epic-ai-platform/epic-ai-platform/workspace/benutzer) einladen und deren [Rollen](broken://pages/17huXip5qUauGoDu8C23) verwalten * Workspace-Einstellungen anpassen {% hint style="info" %} Die Anzahl der Workspaces, die du erstellen kannst, hängt von deinem Vertrag bzw. Preismodell ab. {% endhint %} *** ### Workspace erstellen So legst du einen neuen Workspace an: 1. Wähle auf der Übersicht im Bereich **„Jetzt starten"** die Karte **„Neuen Workspace erstellen"**. 2. Trage im Feld **„Name des Workspace"** einen aussagekräftigen Namen ein. Der Name ist ein Pflichtfeld. Der Name kann in den Einstellungen angepasst werden. 3. Klicke auf **„Workspace erstellen"**. 4. Nach dem Anlegen erscheint die Bestätigung **„Dein Workspace ist bereit"**. Über **„Zum Workspace"** springst du direkt hinein. *** ### Workspace öffnen und verwalten Um einen Workspace einzusehen oder zu bearbeiten, wählst du ihn direkt aus der Übersichtsliste aus. Du landest direkt im **Workspace Dashboard**. Es gibt dir einen schnellen Überblick über deinen Workspace und bündelt die wichtigsten Bereiche an einem Ort. Hier siehst du auch direkt die Anzahl der Benutzer sowie der aktiven AI Agents. **Schnellzugriff** Über die Kacheln im Bereich "Schnellzugriff" erreichst du direkt: * [**Benutzer**](/epic-ai-platform/epic-ai-platform/workspace/benutzer)**:** Teammitglieder einladen und verwalten sowie Rollen zuweisen und verwalten. * [**Apps**](/epic-ai-platform/epic-ai-platform/workspace/apps)**:** Externe Systeme via REST-API anbinden * [**Einstellungen**](/epic-ai-platform/epic-ai-platform/workspace/einstellungen)**:** Workspace löschen * **Diese Dokumentation** – Anleitungen, API-Referenz und Best Practices (öffnet in einem neuen Tab) **AI Agents** Hier werden die im Workspace angelegten AI Agents aufgelistet. Wurde noch keiner erstellt, erscheint der Hinweis "Noch keinen AI Agent in diesem Workspace." **Neuigkeiten** Im Bereich "Was ist neu" (mit Versionsnummer) findest du die jüngsten Produktupdates, etwa neue Kanäle, Wissensquellen oder Personalisierungsoptionen. *** ### Best Practices * **Sprechende Namen vergeben:** Wähle einen Namen, der das Projekt oder Unternehmen klar beschreibt. So behältst du bei mehreren Workspaces den Überblick. * **Ein Workspace pro Projekt oder Kunde:** Trenne unterschiedliche Projekte in eigene Workspaces. Das erleichtert die Verwaltung und schützt Daten voneinander. * **Rollen bewusst vergeben:** Vergib beim Einladen zunächst die Rolle „Mitglied" und erweitere Rechte nur bei Bedarf. # Benutzer Im Bereich Benutzer verwaltest du alle Personen, die Zugriff auf deinen Workspace haben. Du kannst neue Mitglieder einladen, ihnen Rollen zuweisen und sie bei Bedarf wieder entfernen. ### Wo finde ich das? `Workspace → Benutzer` Die Benutzerübersicht ist über die Navigationsleiste sowie das Workspace Dashboard erreichbar. *** ### Erklärung – Was sind Benutzer? Benutzer sind Personen, die Mitglied in deinem Workspace sind. Jeder Benutzer hat eine oder mehrere Rollen, die bestimmen, welche Aktionen er im Workspace ausführen darf. *** ### Die Benutzerübersicht In der Übersicht siehst du alle Mitglieder des Workspace samt ihrer E-Mail-Adresse und Ihrem Beitrittsdatum. Mit Klick auf einen Benutzer öffnet sich dessen Detailseite, auf der du Profil und Rollen einsehen und verwalten kannst. *** ### Verwaltung – Einladen, Bearbeiten und Entfernen #### **Benutzer einladen** 1. Klicke oben rechts auf „Benutzer hinzufügen". 2. **Schritt 1 – Benutzer:** Trage für jede einzuladende Person den Namen, die E-Mail-Adresse und die gewünschte Rolle (Mitglied, Administrator oder Inhaber) ein. Über „Weiteren Benutzer hinzufügen" kannst du mehrere Personen in einem Durchgang einladen. Klicke auf „Weiter". 3. **Schritt 2 – AI Agents (optional):** Verknüpfe die eingeladenen Benutzer direkt mit einem oder mehreren AI Agents und lege die jeweilige Rolle fest. Diese Zuweisung gilt für alle Benutzer dieser Einladung. Über „Weiteren AI Agent hinzufügen" lassen sich mehrere Agents zuweisen. Der Schritt ist optional und kann übersprungen werden. Klicke auf „Weiter". 4. **Schritt 3 – Bestätigung:** Prüfe in der Zusammenfassung alle Einladungen und AI-Agent-Zuweisungen und klicke auf „Einladung senden". {% hint style="info" %} Eingeladene Benutzer, die ihre Registrierung noch nicht abgeschlossen haben, sind in der Übersicht mit einem **Badge** gekennzeichnet. So siehst du auf einen Blick, welche Mitglieder noch ausstehend sind. Eine Einladung ist **30 Tage** gültig. Ist sie abgelaufen, kannst du den Einladungslink über die Detailseite des Benutzers erneut versenden. {% endhint %} #### **Rollen** Rollen steuern, welche Aktionen ein Benutzer innerhalb eines Workspace ausführen darf.
RolleBeschreibung
WorkspaceOwnerEnthält alle Berechtigungen für diesen Workspace.
WorkspaceAdminEnthält alle Berechtigungen für diesen Workspace, außer das Löschen des Workspaces.
WorkspaceMemberKann andere Mitglieder sehen, aber keine Änderungen vornehmen.
#### Rollen zuweisen 1. Klicke in der Benutzerübersicht auf den gewünschten Benutzer. 2. Auf der Detailseite siehst du seine aktuellen Rollen in einer Tabelle. 3. Klicke auf „Rolle hinzufügen". 4. Wähle im Dialog eine Rolle aus dem Dropdown aus. Angezeigt werden nur Rollen, die der Benutzer noch nicht besitzt (Inhaber, Administrator oder Mitglied). 5. Klicke auf „Rolle hinzufügen", um die Zuweisung zu bestätigen. #### **Rolle entfernen** 1. Fahre in der Rollen-Tabelle der Detailseite mit der Maus über die zu entfernende Rolle. Es erscheint ein Lösch-Symbol. 2. Klicke auf das Lösch-Symbol. 3. Bestätige die Aktion im folgenden Dialog. #### **Benutzer entfernen** Benutzer können auf zwei Wegen aus dem Workspace entfernt werden: **Weg 1 – Über die Benutzerübersicht:** 1. Fahre in der Übersichtsliste mit der Maus über den gewünschten Benutzer. 2. Klicke auf das Lösch-Symbol, das am rechten Rand erscheint. **Weg 2 – Über die Benutzer-Detailseite:** 1. Klicke auf den gewünschten Benutzer in der Übersicht. 2. Klicke auf der Detailseite auf „Entfernen". In beiden Fällen öffnet sich der Dialog „Benutzer löschen". Gib zur Bestätigung den vollständigen Namen des Benutzers in das Textfeld ein und klicke auf „Benutzer löschen". {% hint style="warning" %} Wenn du einen Benutzer entfernst, verliert er sofort den Zugriff auf den Workspace und alle darin enthaltenen Inhalte. Er kann sich nicht mehr anmelden. Du kannst ihn jedoch jederzeit erneut einladen. {% endhint %} *** ### Best Practices * Weise neuen Teammitgliedern zunächst die Rolle Mitglied zu und erweitere die Rechte nur bei Bedarf. So behältst du die Kontrolle darüber, wer Änderungen vornehmen darf. * Vergib die Rolle Inhaber nur an Personen, die auch für Abrechnung und grundlegende Workspace-Einstellungen verantwortlich sind. * Entferne Benutzer zeitnah, wenn sie das Team verlassen, damit kein unbefugter Zugriff auf den Workspace bestehen bleibt. # Apps Apps integrieren externe Systeme via REST-API direkt in den AI Agent, um Daten abzurufen, zu validieren oder Systemänderungen auszulösen. Wo finde ich Apps? Apps werden auf Workspace-Ebene verwaltet. Du erreichst sie über die Navigationsleiste oder das Workspace Dashboard. `Workspace → Apps` In diesem Bereich siehst du alle Apps, die in deinem Workspace vorhanden sind. Jede App wird mit ihrem Namen und einer eindeutigen ID angezeigt. Über den Button **„Neue App anlegen"** erstellst du eine neue App. {% hint style="info" %} Im Workspace angelegte App müssen [im jeweiligen AI Agent noch installiert](broken://pages/LZyImpcwqBz0rZq1Ja53) werden. {% endhint %} *** ### Was sind Apps? Eine App ist eine strukturierte Verbindung zu einer externen REST-API. Sie bündelt alle Konfigurationen, die nötig sind, um Daten aus einem externen System abzurufen oder dorthin zu senden – von der Authentifizierung bis hin zur Definition einzelner API-Endpunkte. #### Typische Anwendungsfälle * **Informationsabfragen:** Abruf externer Daten, z. B. Sendungsstatus über eine zuvor erfragte Sendungsnummer oder offene Rechnungsbeträge. * **Datenvalidierung:** Überprüfung von IDs, Zugangsdaten oder Formularwerten auf Richtigkeit oder Existenz. * **Datenspeicherung:** Übermittlung von Änderungen, z. B. bei Adress- oder Kontaktdatenaktualisierungen oder Stornierungen von Bestellungen. #### Voraussetzungen Damit eine App funktioniert, muss die angebundene API folgende technische Anforderungen erfüllen: * **API-Typ:** REST (Representational State Transfer) * **Unterstützte HTTP-Methoden:** GET, POST, PATCH, PUT, DELETE * **Datenformat der Rückgabe:** JSON {% hint style="warning" %} Arrays in der API-Antwort eines einzelnen Endpunkts können aktuell nicht direkt verarbeitet werden. Als Workaround muss die Antwortstruktur „geflattert" werden – d. h. verschachtelte Array-Strukturen werden in eine flache Key-Value-Struktur umgewandelt. {% endhint %} *** ### Aufbau einer App Eine App besteht aus mehreren Bereichen, die jeweils eine eigene Funktion haben. Du navigierst zwischen ihnen über die linke Seitenleiste innerhalb der App oder das App Dashboard. Die Bereiche umfassen: Übersicht, Basisdaten, Verbindungen, Module, DataCards, Beschreibung, Veröffentlichen, Einstellungen. #### Basisdaten Basisdaten enthalten allgemeine, wiederverwendbare Werte der App – zum Beispiel die Basis-URL einer API. Diese Daten werden automatisch jedem Request der App hinzugefügt und stehen in allen Modulen und Verbindungen über die Syntax `{{schlüsselname}}` zur Verfügung. **Beispiel:** ```json { "baseUrl": "https://api.chucknorris.io" } ``` Dieser Wert kann anschließend in Modulen als `{{baseUrl}}` referenziert werden, z. B.: ```json { "url": "{{baseUrl}}/jokes/random", "method": "GET" } ``` *** #### Verbindungen Verbindungen steuern die Authentifizierung gegenüber der externen API. Jede Verbindung führt beim Installieren der App einen **Health Check** durch – ein automatischer Test-Request, der prüfen soll, ob die Verbindung funktioniert. Die Verbindung gilt als aktiv, wenn die API einen HTTP-Statuscode zwischen **200 und 299** zurückgibt. Mehrere Module können dieselbe Verbindung nutzen, sofern sie auf die gleiche Authentifizierung angewiesen sind. **Verbindungstypen** Beim Erstellen einer Verbindung wählst du einen von drei Typen: * **Api-Key:** Authentifizierung über einen API-Schlüssel. * **Basic Auth:** Authentifizierung über Benutzername und Passwort. * **Ohne Authentifizierung:** Für APIs, die keine Authentifizierung erfordern. **Verbindung konfigurieren** Jede Verbindung hat zwei Tabs: * **Verbindung:** Hier definierst du die Abfragestruktur für den Health Check als JSON – also URL und Methode des Test-Requests. Auf die Basisdaten kannst du auch hier über `{{schlüsselname}}` zugreifen. * **Parameter:** Hier kannst du Parameter als JSON hinterlegen, die in der Abfragestruktur verwendet werden können. Beispiel: ```json { "url": "{{baseUrl}}/api/health", "method": "GET", "headers": { "x-api-key": "{{parameters.apiKey}}" } } ``` *** #### Module Module definieren die eigentlichen API-Aufrufe. Jedes Modul entspricht einem bestimmten Endpunkt oder einer Aktion der API. Module werden [als Schritte im Flow-Builder](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/app-module) eingebunden und führen dort automatisierte Aktionen aus. Aktuell unterstützen Module den Typ **Action** – damit löst ein Modul eine definierte API-Anfrage aus, wenn es im Flow ausgeführt wird. #### **Modul konfigurieren** Ein Modul hat drei Tabs: **Request** Hier definierst du die Abfragestruktur des API-Calls als JSON. Die Struktur erbt automatisch die Werte aus den Basisdaten. Du kannst also direkt auf `{{baseUrl}}` und andere dort definierte Schlüssel zugreifen. Zusätzlich verknüpfst du hier das Modul mit einer Verbindung – diese liefert die Authentifizierungsinformationen für den Request. **Parameter** Hier legst du die Eingabeparameter des Moduls als JSON-Array fest. Diese Parameter können im Request verwendet werden – z. B. als Werte in der URL, im Body oder in Query-Parametern. **Output** Hier definierst du die Ausgabeparameter des Moduls als JSON-Array. Pro Ausgabeparameter gibst du Folgendes an: * `name`: Schlüsselname im API-Response * `type`: Datentyp (z. B. `text`) * `label`: Anzeigename im space.vars.TERM\_FLOW\_BUILDER/ Variablen-Picker Die definierten Ausgabeparameter stehen nach dem Ausführen des Moduls imspace.vars.TERM\_FLOW\_BUILDER als Variablen zur Verfügung. **Beispiel:** ```json [ { "name": "value", "type": "text", "label": "Witz" }, { "name": "id", "type": "text", "label": "ID" } ] ``` *** #### DataCards DataCards sind Informationskarten, die im Posteingang auf der rechten Seite in den Konversationsinformationen angezeigt werden. Sie zeigen automatisch Daten aus Apps an – z. B. Kunden- oder Bestellinformationen – und ermöglichen so einen schnellen Überblick, ohne den Chat verlassen zu müssen. Für jede DataCard hinterlegst du einen Namen und eine URL, von der die Daten geladen werden. *** #### Beschreibung Für jede App kann eine Beschreibung in Markdown hinterlegt werden. Der Editor zeigt links die Markdown-Eingabe und rechts eine Live-Vorschau der gerenderten Ausgabe. Die Beschreibung hilft dabei, den Zweck, die Funktionsweise und die Nutzung der App zu dokumentieren – und erleichtert anderen Nutzern die Einbindung im space.vars.TERM\_FLOW\_BUILDER. *** #### Veröffentlichen Über den Bereich „Veröffentlichen" kannst du eine Veröffentlichung deiner App oder deren neuen Version beantragen. Veröffentlichte Apps sind im App-Marktplatz für alle Nutzer der Plattform verfügbar. Der Prozess läuft wie folgt ab: 1. Du legst eine App an oder nimmst Änderungen an der App vor. 2. Du klickst im Navigationspunkt **„Veröffentlichen"** auf **„App veröffentlichen".** 3. Das Epic AI-Team prüft die App und gibt sie frei. 4. Nach der Freigabe ist die App im App-Marktplatz verfügbar. {% hint style="info" %} Änderungen, die nach einer Veröffentlichung vorgenommen werden, sind nicht automatisch öffentlich. Um Änderungen zu veröffentlichen, muss erneut eine Veröffentlichung beantragt werden. {% endhint %} Der Bereich zeigt dir den aktuellen Status deiner App sowie eine Versionshistorie deiner bisherigen Veröffentlichungen. Die möglichen Statuswerte sind: * **In der Warteschlange:** Die Anfrage wurde eingereicht und wartet auf Bearbeitung. * **In Bearbeitung:** Das Epic AI-Team prüft die App gerade. * **Angenommen:** Die App wurde freigegeben und ist im Marktplatz verfügbar. * **Zurückgezogen:** Die Veröffentlichung wurde zurückgezogen. *** #### Einstellungen In den Einstellungen kannst du folgende Konfigurationen vornehmen: * **Allgemein:** Den Namen der App ändern und speichern. * **Logo & Erscheinungsbild:** Logo hochladen oder entfernen (JPEG, PNG oder SVG, maximal 2 MB) sowie eine Hintergrundfarbe festlegen. Beides bestimmt, wie die App z. B. im Flow Builder dargestellt wird. * **Event-Emitter:** Eine URL hinterlegen, an die ausgelöste Events der App gesendet werden – z. B. wenn die App installiert wird. Jede Anfrage enthält die zugehörige space.vars.TERM\_AI\_AGENT-ID und App-ID als Query-Parameter. * **Details:** Technische Informationen zur App – App-ID (kopierbar), Erstellungsdatum und Datum der letzten Aktualisierung. * **App löschen:** Die App dauerhaft löschen. Alle Daten gehen dabei verloren und können nicht wiederhergestellt werden. {% hint style="warning" %} Das Löschen einer App kann nicht rückgängig gemacht werden. Prüfe vorher, ob die App noch in aktiven space.vars.TERM\_AI\_AGENTs eingebunden ist. {% endhint %} *** ### App erstellen und verwalten #### App erstellen 1. Navigiere zu `Workspace → Apps`. 2. Klicke auf **„Neue App anlegen"**. 3. Vergib einen Namen und bestätige mit „Erstellen". Du landest direkt in der App-Übersicht. 4. Konfiguriere die App über die Bereiche **Basisdaten**, **Verbindungen**, **Module**, **DataCards** und **Beschreibung**. #### Verbindung erstellen 1. Öffne die gewünschte App und navigiere zu **Verbindungen**. 2. Klicke auf **„Erstellen"**. 3. Vergib einen Namen und wähle den passenden Typ (Api-Key, Basic Auth oder Ohne Authentifizierung). 4. Klicke auf **„Verbindung erstellen"**, um die Verbindung anzulegen. 5. Konfiguriere anschließend den Health-Check-Request im Tab **Verbindung** und hinterlege bei Bedarf Parameter im Tab **Parameter**. 6. Speichere die Verbindung über **„Speichern"**. #### Modul erstellen 1. Öffne die gewünschte App und navigiere zu **Module**. 2. Klicke auf **„Modul erstellen"**. 3. Vergib einen Namen und bestätige mit „Erstellen". 4. Konfiguriere den Request im Tab Abfrage und verknüpfe das Modul über „Verbindung hinzufügen" mit einer Verbindung. 5. Lege bei Bedarf Eingabeparameter im Tab **Parameter** und Ausgabeparameter im Tab **Output** fest. 6. Speichere das Modul über **„Speichern"**. #### DataCard erstellen 1. Öffne die gewünschte App und navigiere zu **DataCards**. 2. Klicke auf **„DataCard erstellen"**. 3. Vergib einen Namen und hinterlege die URL, von der die Daten geladen werden sollen. 4. Klicke auf **„DataCard erstellen"**. #### Beschreibung bearbeiten 1. Öffne die gewünschte App und navigiere zu Beschreibung. 2. Schreibe deine Dokumentation im Markdown-Editor links; die Vorschau rechts aktualisiert sich live. 3. Klicke auf „Speichern", um die Änderungen zu übernehmen, oder „Zurücksetzen", um sie zu verwerfen. #### App löschen 1. Öffne die gewünschte App und navigiere zu **Einstellungen**. 2. Klicke auf **„Löschen"**. {% hint style="warning" %} Das Löschen ist endgültig. Alle Daten der App – inkl. Verbindungen, Module und DataCards – gehen unwiderruflich verloren. {% endhint %} *** ### Beispiel: Chuck Norris API anbinden Dieses Beispiel zeigt, wie du eine einfache öffentliche REST-API (ohne Authentifizierung) als App einrichtest und ein Modul erstellst, das einen zufälligen Witz abruft. #### 1. App erstellen Navigiere zu `Workspace → Apps` und lege eine neue App mit dem Namen **„Chuck Norris API"** an. #### 2. Basisdaten hinterlegen Navigiere zu **Basisdaten** und trage die Basis-URL der API ein: ```json { "baseUrl": "https://api.chucknorris.io" } ``` Speichere die Eingabe. #### 3. Verbindung erstellen Navigiere zu **Verbindungen** und erstelle eine neue Verbindung: * **Name:** Chuck Norris Status * **Typ:** Ohne Authentifizierung Konfiguriere den Health-Check-Request im Tab **Verbindung**: ```json { "url": "{{baseUrl}}", "method": "GET" } ``` Speichere die Verbindung. #### 4. Modul erstellen Navigiere zu **Module** und erstelle ein neues Modul: * **Name:** get\_joke Konfiguriere den Request im Tab **Request**: ```json { "url": "{{baseUrl}}/jokes/random", "method": "GET" } ``` Verknüpfe das Modul mit der Verbindung **„Chuck Norris Status"**. Wechsle zum Tab **Output** und definiere die Ausgabeparameter: ```json [ { "name": "value", "type": "text", "label": "Witz" }, { "name": "id", "type": "text", "label": "ID" } ] ``` Speichere das Modul. Das Modul **get\_joke** ist jetzt einsatzbereit und kann im space.vars.TERM\_FLOW\_BUILDER als Schritt eingebunden werden. Nach der Ausführung stehen die Variablen **Witz** und **ID** im Flow zur Verfügung. *** ### Arrays in der API-Response (Workaround) Arrays in der API-Antwort eines einzelnen Endpunkts können aktuell nicht direkt verarbeitet werden. Falls ein Endpunkt ein Array zurückgibt, muss die Antwortstruktur „geflattert" werden – d. h. die verschachtelten Einträge werden auf oberster Ebene mit einem Index als Präfix abgelegt. **Beispiel – Original (nicht verarbeitbar):** ```json { "total": 2, "results": [ { "id": "1001", "properties": { "name": "Firma A", "amount": "5000", "status": "offen" } }, { "id": "1002", "properties": { "name": "Firma B", "amount": "7500", "status": "abgeschlossen" } } ] } ``` **Beispiel – Geflattert (verarbeitbar):** ```json { "total": 2, "0_id": "1001", "0_name": "Firma A", "0_amount": "5000", "0_status": "offen", "1_id": "1002", "1_name": "Firma B", "1_amount": "7500", "1_status": "abgeschlossen" } ``` **Merkmale der geflatteten Struktur:** * Jeder Eintrag aus `results` erhält einen numerischen Index als Präfix (`0_`, `1_`, …). * Alle verschachtelten Felder werden auf oberster Ebene abgelegt. * Meta-Informationen wie `total` oder Paging-Angaben bleiben unverändert erhalten. *** ### Best Practices * **Basisdaten sinnvoll nutzen:** Hinterlege wiederkehrende Werte wie die Basis-URL in den Basisdaten. So musst du Änderungen – z. B. bei einem API-Versionswechsel – nur an einer Stelle vornehmen, statt in jedem Modul einzeln. * **Sprechende Namen vergeben:** Vergib für Module und Verbindungen Namen, die ihren Zweck klar beschreiben. Im space.vars.TERM\_FLOW\_BUILDER siehst du später nur den Modulnamen – ein Name wie `get_sendungsstatus` ist deutlich hilfreicher als `modul_1`. * **Beschreibung pflegen:** Nutze die Beschreibungsfunktion, um den Zweck der App und die Funktionsweise der einzelnen Module zu dokumentieren. Das erleichtert die Einbindung durch andere Teammitglieder erheblich. * **Health Check sorgfältig konfigurieren:** Der Health Check wird beim Installieren der App ausgeführt. Wähle einen Endpunkt, der zuverlässig erreichbar ist und keine Seiteneffekte hat – z. B. einen einfachen GET-Request auf die Basis-URL. * **Output-Parameter aussagekräftig benennen:** Das `label`-Feld im Output-Tab bestimmt, wie die Variable später im space.vars.TERM\_FLOW\_BUILDER und im Variablen-Picker angezeigt wird. Wähle Labels, die den Inhalt klar beschreiben – z. B. „Sendungsstatus" statt „value". # Einstellungen Im Bereich Einstellungen kannst du den Workspace dauerhaft löschen. ### Wo finde ich das? Du erreichst die Einstellungen über die Navigationsleiste oder das Workspace Dashboard. `Workspace → Einstellungen` *** ### **Allgemein** Im Bereich „Allgemein" kannst du den Namen deines Workspaces anpassen. Trage dazu einfach den gewünschten Namen in das Feld „Name des Workspaces" ein. *** ### **Details** Im Bereich „Details" findest du technische Informationen zu deinem Workspace: die Workspace-ID sowie das Erstellungsdatum. *** ### **Workspace löschen** {% hint style="info" %} Diese Funktion steht nur Benutzern mit der [Rolle](/epic-ai-platform/epic-ai-platform/workspace/benutzer#rollen) WorkspaceOwner zur Verfügung. {% endhint %} Über die Schaltfläche „Löschen" kannst du den gesamten Workspace unwiderruflich löschen. Es öffnet sich nach dem Klick ein Bestätigungsdialog. Gib dort den Namen des Workspaces in das Eingabefeld ein, um die Aktion zu bestätigen. {% hint style="danger" %} Das Löschen eines Workspace kann nicht rückgängig gemacht werden. Dabei werden unwiderruflich gelöscht: * alle space.vars.TERM\_AI\_AGENTs und Apps, die dem Workspace zugeordnet sind, * alle Daten innerhalb des Workspace, * die Zugänge aller Mitglieder zu diesem Workspace. {% endhint %} # AI Agent Ein AI Agent ist ein eigenständiger, intelligenter Assistent innerhalb deines Workspaces. Er enthält die gesamte Konversationslogik, alle Einstellungen und die angebundenen Kanäle. ### Wo finde ich den AI Agent? Nach dem Login gelangst du auf die Übersicht. Dort werden dir alle vorhandenen space.vars.TERM\_AI\_AGENTs und Workspaces angezeigt. Wähle hier direkt aus der Liste den gewünschten AI Agent aus. Wahlweise kannst du deinen AI Agent auch aus dem dazugehörigen Workspace öffnen. Dort kannst du über den Schnellzugriff auf dem Dashboard oder den Navigationsreiter "AI Agents" direkt in deinen AI Agent gelangen. ### Erklärung – Was ist ein space.vars.TERM\_AI\_AGENT? Ein space.vars.TERM\_AI\_AGENT ist ein eigenständiger Assistent innerhalb deines Workspaces. Er enthält die gesamte Konversationslogik, die du im space.vars.TERM\_FLOW\_BUILDER erstellst – also alle [Flows](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/flows), [Variablen](/epic-ai-platform/epic-ai-platform/ai-agent/build/variablen), [Entitäten](/epic-ai-platform/epic-ai-platform/ai-agent/build/entitaten) und [Einstellungen](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen). Jeder space.vars.TERM\_AI\_AGENT hat eine eindeutige **AI-Agent-ID** (ein alphanumerischer Code, z. B. `FT7z5oNrCuQU8fsfLwt6`). Diese ID ist nützlich für Support-Anfragen und wird für API-Aufrufe benötigt. {% hint style="info" %} Die maximale Anzahl an space.vars.TERM\_AI\_AGENTs pro Workspace richtet sich nach deinem Preismodell. {% endhint %} *** ### Wie funktioniert ein space.vars.TERM\_AI\_AGENT? Jede Konversation mit einem space.vars.TERM\_AI\_AGENT folgt einem definierten Ablauf: 1. **Einstieg** – Jede Konversation startet am Einstiegspunkt des Standard-Flows. Dieser existiert genau einmal pro space.vars.TERM\_AI\_AGENT. 2. **Verarbeitung** – Der space.vars.TERM\_AI\_AGENT durchläuft den Flow und führt die hinterlegten Schritte aus: Nachrichten senden, Nutzereingaben entgegennehmen, Intentionen erkennen, Variablen setzen, Bedingungen prüfen oder externe Dienste aufrufen. 3. **Fallback** – Wird keine Intention erkannt oder läuft ein Pfad ins Leere, greift der Fallback. Er gilt global für alle Flows und fängt unerwartete Situationen auf. {% hint style="info" %} Der Ablauf wird im space.vars.TERM\_FLOW\_BUILDER visuell per Drag & Drop aufgebaut – ohne Programmierkenntnisse. {% endhint %} ### Was kann ein space.vars.TERM\_AI\_AGENT tun? * **Konversationen gestalten** – Im space.vars.TERM\_FLOW\_BUILDER baust du Gesprächsabläufe auf. Schritte wie Nachrichten, Bedingungen, Variablen oder API-Aufrufe werden per Drag & Drop auf einem Canvas verbunden. (Siehe Artikel [Flow-Builder](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder) und [Flows](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/flows).) * **Nutzerabsichten erkennen** – Über Intentionen erkennt der space.vars.TERM\_AI\_AGENT, was ein Nutzer möchte – z.B. wird „Ich möchte meine Bestellung stornieren" der Intention „Stornierung" zugeordnet. (Siehe Artikel [Intentionen](/epic-ai-platform/epic-ai-platform/ai-agent/build/intentionen) und [FAQs](/epic-ai-platform/epic-ai-platform/ai-agent/build/faqs).) * **Daten aus Eingaben extrahieren** – Entitäten erkennen automatisch strukturierte Werte in Nutzereingaben, z.B. eine IBAN, ein Datum oder eine Telefonnummer. Variablen speichern diese Werte für die weitere Verwendung im Flow. (Siehe Artikel [Entitäten](/epic-ai-platform/epic-ai-platform/ai-agent/build/entitaten) und [Variablen](/epic-ai-platform/epic-ai-platform/ai-agent/build/variablen).) * **Kanalübergreifend kommunizieren** – Der space.vars.TERM\_AI\_AGENT ist über verschiedene Kanäle erreichbar: Telefonie (Voice), Web-Widget, WhatsApp, Telegram, Facebook Messenger und E-Mail. (Siehe Artikel [Kanäle](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/kanale).) * **Externe Systeme ansprechen** – Über Apps und REST-APIs verbindest du den space.vars.TERM\_AI\_AGENT mit CRM-Systemen, Shop-Plattformen, Versanddienstleistern und weiteren Diensten. (Siehe Artikel A[pps / Appstore](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/apps-appstore).) * **Wissen nutzen** – Lade PDFs hoch oder binde Websites ein, damit der space.vars.TERM\_AI\_AGENT Fragen auf Basis deiner Inhalte beantwortet. (Siehe Artikel [Wissen](/epic-ai-platform/epic-ai-platform/ai-agent/build/wissen) und [Wissensgruppen](broken://pages/fbOEOuNppnXZspf87qJo).) * **An menschliche Agenten übergeben** – Der space.vars.TERM\_AI\_AGENT kann Konversationen nahtlos an dein Team übergeben. Mitarbeitende können das Gespräch in der Inbox übernehmen, weiterbearbeiten oder an Kollegen zuweisen. (Siehe Artikel [Inbox](/epic-ai-platform/epic-ai-platform/ai-agent/inbox).) *** ### Einen neuen space.vars.TERM\_AI\_AGENT erstellen Es gibt zwei Wege, einen neuen AI Agent zu erstellen: * **Global über das Dashboard**: Klicke auf die Karte „Neuen AI Agent erstellen". Der Workspace muss hier im Dialog explizit zugewiesen werden. * **Direkt aus einem Workspace heraus**: Klicke in der AI-Agent-Übersicht des Workspace oben rechts auf „Agent erstellen". Der Workspace ist dann bereits vorausgewählt. In beiden Fällen öffnet sich derselbe mehrstufige Dialog „Neuen AI Agent erstellen": 1. **Name**: Vergib einen Namen für deinen AI Agent. Der AI Agent ist nur für dich und deine Teammitglieder sichtbar – er wird nicht öffentlich angezeigt. Du kannst den Namen später jederzeit ändern. 2. **Sprache**: Wähle die Standardsprache deines AI Agents aus den vorgeschlagenen Optionen (z. B. Deutsch, Englisch, Französisch, Italienisch, Spanisch, Niederländisch) oder öffne „Alle Sprachen anzeigen" für weitere Sprachen. 3. **Workspace zuweisen**: Wähle den Workspace, dem der AI Agent zugeordnet werden soll. Startest du die Erstellung direkt aus einem Workspace, ist dieser Schritt bereits vorausgefüllt. 4. Klicke auf „AI Agent erstellen". Die Konfiguration wird kurz vorbereitet. 5. Sobald dein AI Agent bereit ist, klicke auf „Jetzt konfigurieren", um direkt in den Flow-Builder zu gelangen und mit dem Aufbau deiner Konversationslogik zu beginnen. Nach der Erstellung wirst du direkt in den [Flow-Builder](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder) weitergeleitet und kannst mit dem Aufbau deiner Konversationslogik beginnen. {% hint style="info" %} Du kannst später in den Einstellungen des space.vars.TERM\_AI\_AGENTs weitere Sprachen hinzufügen. Die Standardsprache kann nachträglich nicht geändert werden. {% endhint %} *** ### Best Practices * **Aussagekräftigen Namen wählen:** Vergib einen Namen, der den Zweck des space.vars.TERM\_AI\_AGENTs klar beschreibt – z. B. „Kundenservice" oder „Booking Assistant". Das erleichtert die Orientierung, besonders wenn mehrere space.vars.TERM\_AI\_AGENTs im Workspace vorhanden sind. * **Sprache bewusst wählen:** Wähle als primäre Sprache die Sprache, in der die Mehrheit deiner Nutzer kommuniziert und in welcher du den Agent pflegen möchtest. Weitere Sprachen kannst du jederzeit nachträglich hinzufügen. * **AI-Agent-ID:** Wenn du API-Anbindungen planst oder den Support kontaktierst, ist die AI-Agent-ID hilfreich. Du findest sie jederzeit auf der Karte des space.vars.TERM\_AI\_AGENTs in der Übersicht oder in der URL. # Dashboard Bietet dir einen aktuellen Überblick über die wichtigsten Daten deines AI Agents. ### **Kennzahlen** Vier Kacheln fassen die wichtigsten Kennzahlen der letzten 30 Tage zusammen, jeweils mit Veränderung zur Vorperiode: * Anzahl geführter Konversationen * Anzahl ausgetauschter Nachrichten * Anzahl der Nutzerinteraktionen * Intentionsgenauigkeit: Median Score der erkannten Intentionen *** ### **Schnellzugriff** Über die Schnellzugriff-Kacheln gelangt man direkt zu den zentralen Bereichen des AI Agents: [Inbox](/epic-ai-platform/epic-ai-platform/ai-agent/inbox) (Konversationen anzeigen und beantworten), [Flow Builder](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder) (Flows im visuellen Editor bearbeiten), [Statistiken](/epic-ai-platform/epic-ai-platform/ai-agent/statistiken) (detaillierte Analysen und Auswertungen einsehen), [Einstellungen](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen) (Sprachen, Kanäle, API-Schlüssel und mehr konfigurieren) sowie die aktuellsten Releasenotes. *** ### **Wissensquellen** Zeigt die Gesamtzahl der hinterlegten [Wissensquellen](/epic-ai-platform/epic-ai-platform/ai-agent/build/wissen) sowie eine gekürzte Liste der hinterlegten Quellen (Websites, PDFs etc.) *** ### **Versionen** Zeigt den Bereitstellungsstatus der Produktiv- und Test-Version des AI Agents. *** ### Online Status von Inbox-Benutzern Ist ein Benutzer in der Inbox, wird er dir in dieser Ansicht (sofern du über die notwendigen Statistik-Berechtigungen verfügst) angezeigt. So weißt du immer, wer aus deinem Team gerade für deine Kunden erreichbar ist. # Inbox Die Inbox ist dein zentraler Arbeitsplatz für alle Konversationen deines AI Agents – kanalübergreifend und an einem Ort. ### Wo finde ich die Inbox? `Navigationsleiste → Inbox` ### Erklärung – Was genau ist die Inbox? Die Inbox bündelt alle eingehenden und ausgehenden Unterhaltungen deines space.vars.TERM\_AI\_AGENTs, unabhängig vom [Kanal](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/kanale) (Web-Widget, WhatsApp, E-Mail, Telefon). Von hier aus kannst du Konversationen sichten, bearbeiten, zuweisen und organisieren. Außerdem verwaltest du über die Inbox deine [Kontakte](/epic-ai-platform/epic-ai-platform/ai-agent/inbox/kontakte), [Organisationen](/epic-ai-platform/epic-ai-platform/ai-agent/inbox/organisationen) und [Benachrichtigungseinstellungen](/epic-ai-platform/epic-ai-platform/ai-agent/inbox/benachrichtigungen). *** ### Aufbau der Inbox Die Inbox besteht aus vier Kernbereichen: * [**Bereiche-Navigation (Linke Seite)**](/epic-ai-platform/epic-ai-platform/ai-agent/inbox/bereiche-navigation-linke-seite) : Dein Steuerungselement, um Konversationen nach Zuweisung, Status und Relevanz gefiltert aufzurufen. Unterteilt in: Dein Bereich, Global, Teams und Ansichten (siehe Artikel „Bereiche-Navigation"). Über das Icon oben links (☰) lässt sich die Navigation ein- und ausklappen: Im ausgeklappten Zustand siehst du alle Bezeichnungen und Zähler, im eingeklappten Zustand werden nur die Icons angezeigt – praktisch, wenn du mehr Platz für Konversationsliste und Nachrichtenverlauf brauchst. * [**Konversationsliste**](/epic-ai-platform/epic-ai-platform/ai-agent/inbox/konversationen) **(Mitte)**: Zeigt die Konversationen des aktuell ausgewählten Bereichs an. Über die Suchleiste „Alle durchsuchen…" kannst du gezielt nach Konversationen suchen. * [**Nachrichtenverlauf**](/epic-ai-platform/epic-ai-platform/ai-agent/inbox/konversationen) **(zentral)**: Der eigentliche Chat-Thread mit allen Nachrichten, Anhängen und internen Notizen (siehe Artikel „Konversationen"). * [**Konversationsdetails (Rechte Seite)**](/epic-ai-platform/epic-ai-platform/ai-agent/inbox/konversationsdetails-rechte-seite): Alle begleitenden Informationen wie Zuweisung, Tags, Kontaktdaten und Data-Cards auf einen Blick (siehe Artikel „Konversationsdetails"). *** ### Was kann man in der Inbox machen? Die wichtigsten Funktionen im Überblick: * Konversationen durchsuchen, filtern und nach Bereichen sortiert aufrufen * space.vars.TERM\_AI\_AGENT-geführte Gespräche übernehmen oder an Kollegen und Teams zuweisen * Nachrichten senden, Schnellantworten nutzen und Dateien aus der Mediathek versenden * Interne Notizen hinterlegen und Kollegen per @-Mention einbinden * Tags zur Kategorisierung vergeben und eigene Ansichten für wiederkehrende Filter erstellen * space.vars.TERM\_AI-gestützte Features nutzen: Texte umformulieren, Antwortvorschläge generieren und Chats zusammenfassen lassen * Kontakte und Organisationen pflegen und verknüpfen * Browser- und E-Mail-Benachrichtigungen individuell konfigurieren # Bereiche-Navigation (Linke Seite) Die Bereiche-Navigation ist das zentrale Inbox-Steuerungselement. Sie befindet sich auf der linken Seite und ermöglicht dir, Konversationen nach Zuweisung, Status und Relevanz gefiltert aufzurufen. ### Wo finde ich die Bereiche-Navigation? Öffne die Inbox über die Hauptnavigation `AI Agent → Inbox`. Die Bereiche-Navigation erscheint direkt links neben der Konversationsliste. Die Navigation ist in vier Hauptbereiche unterteilt: **Dein Bereich**, **Global**, **Teams** und **Ansichten**. Jeder Bereich enthält Unterbereiche, die als Filter auf deine Konversationen wirken. Neben jedem Unterbereich wird ein Counter angezeigt, der die aktuelle Anzahl der zutreffenden Konversationen darstellt. Oberhalb der Bereiche findest du den Button **Neue Konversation**, mit dem du eine neue Konversation starten kannst. Diese Funktion ist auf WhatsApp-Nachrichten beschränkt. In der Konversationsliste – dem mittleren Bereich neben der Bereiche-Navigation – werden die Konversationen des aktuell ausgewählten Bereichs angezeigt. Über die Suchleiste „Alle durchsuchen…" kannst du gezielt nach Konversationen suchen. {% hint style="info" %} Die numerischen Angaben (Counter) in den Bereichen werden alle 5 Minuten automatisch aktualisiert oder wenn du die Seite manuell neu lädst. Beachte dies, wenn du unmittelbar nach einer Zuweisung oder dem Abschluss eines Falles die aktuelle Zahl überprüfen möchtest. {% endhint %} *** ### Erklärung – Was genau sind Bereiche? Bereiche sind vordefinierte und anpassbare Filteransichten innerhalb deiner Inbox. Sie dienen zur Strukturierung und Priorisierung deiner täglichen Arbeit. Sie sortieren die große Menge an Konversationen deines space.vars.TERM\_AI\_AGENTs basierend auf Status, Zuweisung und Relevanz. Die vier Hauptbereiche im Überblick: * **Dein Bereich:** Dein persönlicher Arbeitsplatz. Hier findest du alle Konversationen, die dir zugewiesen sind oder deine Aufmerksamkeit erfordern. * **Global**: Die vollständige Übersicht aller Konversationen deines space.vars.TERM\_AI\_AGENTs, unabhängig von Zuweisung oder Status. Dient primär zur Überwachung und Archivsuche. * **Teams**: Team-Warteschlangen. Hier liegen Konversationen, die einem Team zugewiesen, aber noch von keinem einzelnen Mitarbeiter übernommen wurden. * **Ansichten**: Benutzerdefinierte, gespeicherte Filterkombinationen, die du selbst erstellst, um schnell auf eine spezifische Auswahl an Konversationen zuzugreifen. *** ### Dein Bereich „Dein Bereich" ist dein persönlicher Arbeitsplatz innerhalb der Inbox. Er bündelt alle Konversationen, die eine direkte oder indirekte Aktion von dir erfordern – weil du sie übernommen hast oder sie dir zugewiesen wurden. Die Konversationen sind automatisch nach Relevanz und Status vorsortiert. #### Unterbereiche * **Konversationen**: Alle dir zugewiesenen Konversationen auf einen Blick. * **Zurückgestellt**: Konversationen, die du auf Wiedervorlage gesetzt hast. Sie erscheinen hier wieder, sobald der eingestellte Zeitpunkt erreicht ist. * **Ungelesen**: Konversationen, die neue Nachrichten enthalten, aber noch nicht von dir als gelesen markiert wurden. * **Zu erledigen**: Alle offenen Konversationen, die dir persönlich zugewiesen sind und eine Aktion erfordern. * **Erwähnt**: Konversationen, in denen du von einem Kollegen über die interne Notizfunktion namentlich erwähnt wurdest. #### Wie gelangen Konversationen in „Dein Bereich"? Die Zuordnung erfolgt automatisch durch deine Aktionen oder die deines Teams:
AktionZuordnung in „Dein Bereich"
Ein Kollege weist dir eine Konversation zuZu erledigen
Ein Kollege erwähnt dich in einer internen NotizErwähnt
Du setzt eine Konversation auf einen späteren ZeitpunktZurückgestellt
Eine zugewiesene Konversation erhält eine neue NachrichtUngelesen
Du übernimmst eine Konversation aus dem Teams-BereichZu erledigen
Du schließt eine dir zugewiesene KonversationKonversation verschwindet
#### Beispiele * **Dringende Rückmeldung:** Du siehst in der Unteransicht „Erwähnt", dass dich ein Kollege um Input in einem komplexen Fall gebeten hat. Du priorisierst diesen Fall sofort. * **Abarbeiten der offenen Fälle:** Du beginnst deinen Tag im Unterbereich „Zu erledigen" und öffnest die älteste Konversation, um sicherzustellen, dass die Bearbeitungszeiten eingehalten werden. * **Follow-up:** Du hattest gestern einen Fall auf Wiedervorlage gesetzt. Er erscheint heute pünktlich in „Zurückgestellt" – du öffnest ihn und sendest das versprochene Dokument. * **Neue Nachrichten:** Während der Arbeit leuchtet der Counter im Unterbereich „Ungelesen" auf. Das signalisiert dir, dass ein Kunde auf eine deiner zugewiesenen Konversationen geantwortet hat. #### Best Practices für „Dein Bereich" * **Beginne immer mit „Erwähnt".** Diese Fälle erfordern oft schnelle interne Abstimmung und beschleunigen komplexe Fälle. * **Überprüfe als Nächstes „Ungelesen" und „Zurückgestellt".** Das gibt dir einen Überblick über neue Kundenaktivität und fällige Follow-ups. * **Arbeite dich durch „Zu erledigen".** Schließe Konversationen unmittelbar nach Abschluss der Bearbeitung. Das hält deine persönliche Arbeitslast übersichtlich. * **Vermeide es, in den Teams- oder Global-Bereichen zu arbeiten, bevor „Dein Bereich" leer ist.** *** ### Global Der Bereich „Global" ist das vollständige Archiv deines space.vars.TERM\_AI\_AGENTs. Er zeigt alle Konversationen an – unabhängig davon, ob sie geschlossen, offen, zugewiesen oder unbearbeitet sind. Er bietet eine System-Perspektive der gesamten Kommunikationslast. #### Unterbereiche * **Unzugewiesen**: Konversationen, die noch keinem Mitarbeiter oder Team zugewiesen wurden. * **Unbeantwortet**: Konversationen, die eine Kundenantwort enthalten, aber noch keine Antwort vom Agenten erhalten haben. * **Ungelesen**: Konversationen, die neue Nachrichten enthalten und noch nicht geöffnet wurden. * **Zu erledigen**: Alle Konversationen, die aktuell offen sind und eine Aktion erfordern (unabhängig von der Zuweisung). * **Offen**: Alle aktiven Konversationen, die noch in Bearbeitung sind. * **Abgeschlossen**: Alle Konversationen, deren Bearbeitung durch Schließen beendet wurde. * **Alle**: Die Gesamtheit aller Konversationen im System (offen, abgeschlossen, zurückgestellt etc.). #### Wie gelangen Konversationen in „Global"? Die Zuordnung erfolgt automatisch:
AktionZuordnung im Bereich „Global"
Neue Kundenanfrage kommt reinUnzugewiesen, Ungelesen, Offen und Alle
Ein Agent schließt einen FallAbgeschlossen und Alle
Ein Mitarbeiter übernimmt eine KonversationZu erledigen und Alle
Ein Mitarbeiter antwortet dem KundenZu erledigen und Alle
Ein Kunde antwortet, die Konversation ist einem Mitarbeiter zugewiesenZu erledigen, Unbeantwortet, Ungelesen und Alle
#### Verwendung Der Bereich „Global" wird hauptsächlich zur Überwachung, Archivsuche und strategischen Priorisierung genutzt. Er ist kein primärer Arbeitsbereich für die Fallbearbeitung. Hier kannst du: * **Gesamtübersicht erhalten:** Über die Unterbereiche „Offen", „Abgeschlossen" und „Alle" die allgemeine Arbeitslast und den Verlauf aller Konversationen einsehen. * **Prioritäten des Systems identifizieren:** Im Unterbereich „Unzugewiesen" potenzielle Engpässe erkennen und Fälle manuell dem richtigen Team zuweisen. * **Service-Qualität prüfen:** Über „Unbeantwortet" schnell feststellen, welche Kunden zu lange auf eine Antwort warten. * **Historische Daten suchen:** Den Bereich „Alle" zur Suche nach alten oder geschlossenen Konversationen verwenden. #### Beispiele * **Stichprobe für Audits:** Der Teamleiter navigiert in „Abgeschlossen", um stichprobenartig Protokolle von space.vars.TERM\_AI\_AGENT- oder Mitarbeiter-Interaktionen zu prüfen. * **Suchmaschine:** Ein Kunde ruft an und gibt nur vage Informationen über ein Problem von vor zwei Monaten. Du wechselst in „Alle" und nutzt die Suche, um die Konversation zu finden. * **Erkennen von Lücken:** Du bemerkst, dass der Zähler unter „Unzugewiesen" stark ansteigt, und weist diese Fälle proaktiv an das aktuell freie Team zu. * **KPI-Überwachung:** Du nutzt die Counter von „Offen" und „Abgeschlossen" als visuellen Indikator für die aktuelle Performance und Arbeitslast. #### Best Practices für „Global" * **Nicht direkt in „Global" bearbeiten.** Konversationen sollten immer übernommen oder zugewiesen werden. Der Bereich ist dafür zu unübersichtlich. Durch die Zuweisung wird der Fall in „Dein Bereich" oder „Teams" verschoben – die eigentlichen Arbeitsbereiche. * **Überwache „Unzugewiesen" und „Unbeantwortet" regelmäßig.** Dies sind die wichtigsten Indikatoren für potenzielle kritische Wartezeiten. * **Nutze die Status-Counter für Management-Berichte.** Sie bieten eine einfache Echtzeit-Grundlage für die Analyse des Gesamtaufkommens. * **Verwende „Alle" ausschließlich zur Archivsuche.** *** ### Teams Der Bereich „Teams" bildet in der Inbox die Warteschlangen für team-zugewiesene Konversationen ab. Hier liegen Konversationen, die vom space.vars.TERM\_AI\_AGENT oder von Kollegen einem bestimmten [Team](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/teams) zugewiesen, aber noch von keinem einzelnen Mitarbeiter übernommen wurden. #### Rollensteuerung Die Sichtbarkeit der einzelnen Team-Ordner (z. B. „Team Support", „Team Vertrieb") wird durch die Benutzerrollen und Team-Mitgliedschaften gesteuert. Du siehst nur die Team-Ordner, in denen du auch Mitglied bist. #### Verwendung Der Bereich „Teams" ist der primäre Ort, an dem du und deine Kollegen neue, team-zugewiesene Konversationen zur Bearbeitung übernehmen. Hier kannst du: * **Fälle übernehmen:** Wähle einen Team-Ordner, sieh dir die Liste der Konversationen an und übernimm die älteste oder dringlichste Konversation. Sie wird dadurch in deinen „Dein Bereich" verschoben. * **Priorität steuern:** Konversationen innerhalb der Team-Ordner können nach Wartezeit (älteste zuerst) oder Priorität sortiert werden, um die Einhaltung der Service Level Agreements (SLAs) zu gewährleisten. * **Gesamtauslastung prüfen:** Du kannst sehen, wie viele Konversationen aktuell noch in den jeweiligen Team-Warteschlangen liegen. * **Teamübergabe:** Konversationen, die in deinem „Dein Bereich" liegen, aber besser in ein anderes Team passen, kannst du direkt in einen Ordner im Bereich „Teams" verschieben. #### Teams verwalten (Ein-/Ausblenden und Bearbeiten) Im Bereich „Teams" stehen dir zwei Aktionen zur Verfügung: * **Auge-Icon:** Damit kannst du bestehende Teams in der Bereiche-Navigation ein- und ausblenden. Ein ausgeblendetes Team wird dir nicht mehr in der Inbox angezeigt, existiert aber weiterhin. * **Stift-Icon:** Ein Klick auf den Stift führt dich direkt zu den [Team-Einstellungen](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/teams), in denen Teams angelegt, bearbeitet und gelöscht werden können. #### Beispiele * **Arbeitsbeginn im Team:** Du hast deine persönlichen Aufgaben in „Dein Bereich" erledigt. Du navigierst zu „Teams" und siehst, dass im Ordner „Team Support" noch 15 Konversationen warten. Du übernimmst die ältesten drei. * **Fall-Eskalation:** Ein Kunde meldet ein Problem, das sofort den Vertrieb erfordert. Du schreibst eine interne Notiz und weist die Konversation dem Ordner „Team Vertrieb" zu, damit der nächste freie Vertriebsmitarbeiter sie übernehmen kann. * **Überwachung der Wartezeit:** Der Teamleiter prüft mehrmals täglich die Team-Ordner, um zu sehen, ob die Anzahl der wartenden Konversationen zu hoch wird. Bei Bedarf wird Personal aus weniger ausgelasteten Teams zur Unterstützung eingesetzt. #### Best Practices für „Teams" * **Arbeite nach dem FIFO-Prinzip (First In, First Out).** Übernimm zuerst die älteste, wartende Konversation. Das reduziert die durchschnittliche Bearbeitungszeit und hält die SLAs ein. * **Übernimm Konversationen sofort.** Klicke auf „Übernehmen", um den Fall in deinen „Dein Bereich" zu verschieben. Das vermeidet, dass mehrere Teammitglieder an derselben Konversation arbeiten („Double-Handling"). * **Nutze „Teams" nur zur Fallübernahme.** Die eigentliche Bearbeitung und Kommunikation erfolgt in „Dein Bereich". Das hält die Team-Warteschlange übersichtlich. * **Überprüfe zuerst den eigenen Bereich.** Erst wenn „Dein Bereich" abgearbeitet ist, solltest du neue Konversationen aus „Teams" übernehmen. *** ### Ansichten Ansichten sind benutzerdefinierte, gespeicherte Filterkombinationen, die du selbst erstellst. Sie ermöglichen dir, über die festen Unterteilungen der Hauptbereiche hinauszugehen und deine Inbox auf individuelle Bedürfnisse oder temporäre Arbeitsschwerpunkte zuzuschneiden. #### Verwendung Hier kannst du: * **Eigene Filter speichern:** Eine Kombination aus mehreren Kriterien ([Tags](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/tags-und-trigger), Status, Eigenschaften) erstellen und als neue Ansicht unter einem selbstgewählten Namen speichern. * **Spezialfälle abarbeiten:** Definiere Ansichten für wiederkehrende, aber nicht standardisierte Aufgaben (z. B. alle Eskalationsfälle oder alle Rückrufe). * **Eigene Konversationen filtern:** Über die Eigenschaft „Eigene Konversationen" kannst du eine Ansicht erstellen, die nur dir zugewiesene Fälle zeigt. * **Sortierung wählen:** Bestimme, wie die Ergebnisse angezeigt werden: * *Unsortiert* – Zeigt Konversationen in der Reihenfolge an, in der sie im System eingegangen sind. * *Aktivität* – Sortiert nach der letzten Interaktion (neueste Aktivität oben). #### Verwaltung – Ansichten erstellen, bearbeiten und löschen Der Bereich „Ansichten" ist der einzige Ort in der Bereiche-Navigation, den du vollständig selbst verwalten kannst. **Ansicht erstellen** 1. Klicke im Bereich „Ansichten" auf den Stift-Icon neben der Überschrift, um das Verwaltungsmenü zu öffnen. 2. Klicke auf **„Ansicht erstellen"**. 3. Vergib einen aussagekräftigen **Namen** für die Ansicht (z. B. „Dringende Reklamationen"). 4. Wähle die gewünschten Filter aus: * **Tags** – Filtere nach einem oder mehreren Tags (z. B. „Reklamation"). * **Eigenschaften** – Filtere nach Eigenschaften wie „Ungelesen" oder „Eigene Konversationen". * **Status** – Filtere nach „Offene Konversationen", „Abgeschlossene Konversationen" oder „In Bearbeitung". * **Sortierung** – Wähle zwischen „Unsortiert" und „Aktivität". 5. Klicke auf **„Ansicht erstellen"**, um die Ansicht zu speichern. Die neue Ansicht erscheint anschließend in der Bereiche-Navigation unter „Ansichten". **Ansicht bearbeiten**\ Eine bestehende Ansicht kann jederzeit aufgerufen und angepasst werden. Klicke dazu auf den **Stift-Icon** neben der Ansicht, um die Filter und den Namen zu ändern. **Ansicht löschen**\ Nicht mehr benötigte Ansichten können jederzeit gelöscht werden, um die Navigation übersichtlich zu halten. **Ansicht ein- und ausblenden**\ Ansichten, die vorübergehend nicht benötigt werden, können über das **Auge-Icon** ausgeblendet werden. Die Ansicht verschwindet aus der Inbox-Navigation, bleibt aber erhalten und kann jederzeit wieder eingeblendet werden. #### Beispiele * **Manager-Ansicht:** Ein Teamleiter erstellt eine Ansicht, die alle offenen Konversationen mit dem Tag „#Escalation" anzeigt, um kritische Fälle unabhängig von der Zuweisung zu überwachen. * **Nachbearbeitung von** space.vars.TERM\_AI\_AGENT**-Fällen:** Ein Mitarbeiter erstellt eine Ansicht, die alle Konversationen mit dem Tag „Konversation\_vom\_Bot\_abgeschlossen" anzeigt, um eine Stichprobe der vom space.vars.TERM\_AI\_AGENT erfolgreich gelösten Fälle zu prüfen. * **Fokus auf ungelesene Anfragen:** Du erstellst eine Ansicht, die alle offenen Konversationen mit der Eigenschaft „Ungelesen" und dem Tag „Wichtig" kombiniert, um sicherzustellen, dass keine dringende Kundenantwort übersehen wird. #### Best Practices für „Ansichten" * **Erstelle nur Ansichten für häufige oder komplexe Filter.** Für einmalige Suchen genügt die Filterung in „Global". Das vermeidet eine Überladung der Navigation. * **Wähle klare, beschreibende Namen** (z. B. „Dringende Reklamationen"). Das macht die Funktion der Ansicht sofort ersichtlich. * **Nutze die Sortierung „Aktivität" in Ansichten zur Fallbearbeitung.** So werden Fälle mit der neuesten Interaktion zuerst angezeigt, damit du schnell auf aktuelle Kundenantworten reagieren kannst. * **Nutze die Funktion zum Ein- und Ausblenden.** Das hält die Übersicht während spezieller Maßnahmen oder Kampagnen sauber, ohne die Ansicht dauerhaft zu verlieren. *** ### Best Practices – Übergreifend Empfehlung: Arbeite die Bereiche in dieser Reihenfolge ab, um effizient und strukturiert zu arbeiten: 1. **„Dein Bereich"** – Bearbeite zuerst deine persönlich zugewiesenen Fälle. Beginne dabei mit „Erwähnt", dann „Ungelesen" und „Zurückgestellt", dann „Zu erledigen". 2. **„Teams"** – Erst wenn dein persönlicher Bereich abgearbeitet ist, übernimm neue Fälle aus den Team-Warteschlangen. 3. **„Ansichten"** – Nutze deine gespeicherten Ansichten für spezielle oder wiederkehrende Aufgaben. 4. **„Global"** – Verwende diesen Bereich nur zur Überwachung, Archivsuche und KPI-Prüfung. Bearbeite Konversationen nicht direkt hier. # Konversationen Eine Konversation ist der komplette Nachrichten-Thread zu einem konkreten Anliegen. Sie kann über verschiedene Kanäle geführt werden – z. B. über das Web-Widget, WhatsApp, E-Mail oder Telefon. ### Wo finde ich Konversationen? Einzelne Konversationen kannst du über verschiedene Wege aufrufen: * **Inbox:** `AI Agent → Inbox` : Hier werden Konversationen nach Bereichen angezeigt. * **Suche:** `AI Agent → Inbox → Alle Chats durchsuchen` : Durchsuche Konversationen anhand der letzten Nachricht, dem Namen des Kontakts oder der Rufnummer (bei Telefonie). * **Über den Kontakt:** `AI Agent → Inbox → Kontakte → Kontakt auswählen und öffnen → Konversationen des Kontakts` In der Konversationsübersicht wird neben jeder Konversation ein Icon angezeigt, das den jeweiligen Kanal symbolisiert (z. B. Telefon-Symbol für Voice, Web-Symbol für Web-Widget, Brief-Symbol für E-Mail-Konversationen). *** ### Erklärung – Was genau sind Konversationen? Eine Konversation bündelt alle Informationen zu einem bestimmten Anliegen an einem Ort. Sie enthält: * **Teilnehmende:** Kunde, space.vars.TERM\_AI\_AGENT und Mitarbeitende. * **Nachrichten & Anhänge:** Der gesamte Nachrichtenverlauf inklusive gesendeter Dateien. * **Metadaten:** Konversations-ID, Kanal, Zeitstempel, Status und Zuweisung. * **Interne Notizen & Erwähnungen:** Nur für das Team sichtbare Anmerkungen. #### Konversations-Status Jede Konversation hat einen Status, der in der Kopfleiste der Konversation angezeigt wird: * **Offen:** Die Konversation wurde noch nicht von einem Mitarbeiter übernommen. * **In Arbeit:** Ein Mitarbeiter bearbeitet die Konversation aktiv. * **Zurückgestellt:** Die Konversation wurde für eine spätere Bearbeitung zurückgestellt. * **Abgeschlossen:** Das Anliegen wurde gelöst und die Konversation ist geschlossen. *** ### Verwendung – Was kann man mit Konversationen machen? Innerhalb einer Konversation stehen dir zahlreiche Werkzeuge zur effizienten Bearbeitung zur Verfügung. #### Konversation übernehmen Wenn ein space.vars.TERM\_AI\_AGENT eine Konversation führt und du als Mitarbeiter eingreifen möchtest, kannst du die Konversation manuell übernehmen. 1. Öffne die gewünschte Konversation. 2. Klicke unten auf den Button **„Konversation übernehmen"**. 3. Es erscheint ein Bestätigungsdialog mit dem Hinweis, dass der space.vars.TERM\_AI\_AGENT aktiv ist und die Übernahme den space.vars.TERM\_AI\_AGENT unterbricht. 4. Bestätige mit **„Übernehmen"**, um die Konversation zu übernehmen. {% hint style="info" %} Ist der space.vars.TERM\_AI\_AGENT in der Unterhaltung noch aktiv, unterbricht die Übernahme einer Konversation den space.vars.TERM\_AI\_AGENT. Der space.vars.TERM\_AI\_AGENT wird in dieser Konversation nicht mehr automatisch antworten, bis die Konversation abgeschlossen wird oder ein [Trigger](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/tags-und-trigger#tags-als-trigger-verwenden) gesetzt wird. {% endhint %} #### Nachrichten senden Nachdem du eine Konversation übernommen hast, kannst du direkt im Antwortfenster Nachrichten an den Kunden verfassen. * Gib deine Nachricht in das Eingabefeld ein (Tab **„Antworten"**). * Sende die Nachricht mit einem Klick auf das Senden-Symbol oder per Tastenkombination `Strg + Enter` (bzw. `Ctrl + Enter`). **Schnellantworten** Gib `/` im Nachrichtenfeld ein, um die [Schnellantworten](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/schnellantworten) zu öffnen. Damit kannst du vordefinierte Textbausteine schnell einfügen und versenden. **Anhänge und Dateien senden** Im unteren Bereich des Antwortfensters findest du mehrere Icons für zusätzliche Funktionen: * **Anhang senden:** Lade eine Datei von deinem Computer hoch und sende sie direkt an den Kunden. * **Datei aus Mediathek senden:** Wähle eine Datei aus der zentralen [Mediathek](/epic-ai-platform/epic-ai-platform/ai-agent/build/mediathek) aus und sende sie an den Kunden. *** #### space.vars.TERM\_AI-Features {% hint style="info" %} Die [AI-Features müssen in den Einstellungen ](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/ki-einstellungen)zuvor aktiviert werden. {% endhint %} Die space.vars.TERM\_AI unterstützt dich bei der Bearbeitung von Konversationen mit folgenden Funktionen direkt im Antwortfenster: * **Text umformulieren:** Optimiert eingegebene Texte auf Knopfdruck. Die space.vars.TERM\_AI schlägt alternative Formulierungen vor, um Tonalität und Stil zu verbessern. Du kannst das Nachrichtenfenster hier als Prompt begreifen. Schreibe beispielsweise eine Nachricht vor und ergänze "übersetze auf Englisch". Klicke auf den Button um den Prompt auszuführen. * **Antwortvorschlag generieren:** Basierend auf dem Kontext der eingehenden Nachrichten schlägt das System passende Antworten vor. Diese Entwürfe können geprüft, angepasst und direkt übernommen werden. * **Chat zusammenfassen:** Generiert eine prägnante Zusammenfassung des bisherigen Gesprächsverlaufs. Besonders nützlich bei langen Dialogen oder bei der Übernahme einer Konversation. *** #### Interne Notizen Neben der direkten Kommunikation mit dem Kunden kannst du interne Notizen hinterlegen, die nur für dein Team sichtbar sind. Werden im Flow [Notiz-Elemente](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/block/elemente-aktionen#notiz-erstellen) genutzt, tauchen auch diese im Konversationsverlauf auf. 1. Wechsle im Antwortbereich auf den Tab **„Notiz"**. 2. Gib deine Notiz in das Eingabefeld ein. 3. Speichere die Notiz. Notizen eignen sich besonders für: * Interne Absprachen oder Rückfragen an Kollegen. * Dokumentation von Zwischenergebnissen oder Entscheidungen. * Erwähnungen von Kollegen über **@-Mentions**, um diese direkt in die Konversation einzubinden. Die Konversation erscheint dann beim erwähnten Kollegen im Ordner „Erwähnt". *** #### Konversation als ungelesen markieren Wenn du eine Konversation zu einem späteren Zeitpunkt bearbeiten möchtest, kannst du sie als ungelesen markieren. Klicke dazu auf das **Briefumschlag-Symbol** in der Kopfleiste der Konversation. #### Konversation zurückstellen Wenn du auf eine Rückmeldung wartest oder die Konversation zu einem bestimmten Zeitpunkt wieder aufgreifen möchtest, kannst du sie zurückstellen. 1. Klicke in der Kopfleiste auf **„Zurückstellen"**. 2. Wähle einen vordefinierten Zeitraum aus: 3 Stunden, 6 Stunden, Morgen, 2 Tage, 3 Tage, 7 Tage, 14 Tage oder 28 Tage. 3. Alternativ kannst du über **„Individuell"** ein konkretes Datum im Kalender auswählen. Die Konversation verschwindet aus deiner aktiven Inbox und erscheint automatisch zum gewählten Zeitpunkt wieder. {% hint style="info" %} Bei einer zurückgestellten Konversation wird in der Konversationsansicht auf der Rechten Seite das Datum und die Uhrzeit angezeigt, zu der sie wieder erscheinen wird. {% endhint %} #### Konversation abschließen Wenn das Anliegen gelöst ist, klicke in der Kopfleiste auf **„Abschließen"**. Die Konversation wird als abgeschlossen markiert und verschwindet aus der aktiven Inbox. #### Konversation wieder öffnen Eine abgeschlossene Konversation kannst du jederzeit wieder öffnen. Klicke dazu auf das **„Wieder öffnen"-Symbol** in der Kopfleiste der abgeschlossenen Konversation. #### Konversation zuweisen Konversationen können gezielt an einzelne Mitarbeiter oder gesamte Teams übergeben werden. Die Zuweisung erfolgt über das Zuweisungsfeld in der rechten Seitenleiste. #### Nachrichtendetails und Tags pro Nachricht Wenn du mit der Maus über eine einzelne Nachricht fährst, erscheinen zwei Symbole: * **Info-Symbol (i):** Zeigt die Details der jeweiligen Nachricht an – z. B. Erstellungszeitpunkt, Sendezeitpunkt, Verarbeitungsstatus, Zustellstatus und ob die Nachricht gelesen wurde. {% hint style="info" %} Hier werden auch eventuelle Fehlermeldungen angezeigt, etwa wenn bei WhatsApp eine Zustellung gescheitert ist, weil der Kunde nicht zugestimmt hat. {% endhint %} * **Tag-Symbol:** Ermöglicht es, einer einzelnen Nachricht Tags zuzuweisen. Diese Tags können anschließend über den Filter in der Kopfleiste der Konversation gefiltert werden. #### Nachrichten filtern Du kannst Nachrichten innerhalb einer Konversation nach Tags filtern, um bestimmte Inhalte schneller zu finden. 1. Klicke auf das **Filter-Symbol** in der Kopfleiste der Konversation. 2. Es öffnet sich ein Filterbereich, in dem du nach vorhandenen Tags filtern kannst. *** ### Beispiele #### 1. Praxisbeispiel: Zusammenarbeit via @-Mention Ein Support-Mitarbeiter erhält eine komplexe technische Anfrage. 1. Er wechselt auf den Tab **„Notiz"** und schreibt: `@Jannis Kannst du prüfen, ob dieser Fehler mit dem Update von gestern zusammenhängt?` 2. Die Konversation erscheint bei Jannis im Ordner **„Erwähnt"**. 3. Der IT-Techniker gibt Feedback in einer weiteren Notiz. 4. Sobald die Antwort feststeht, antwortet der Support-Mitarbeiter dem Kunden und schließt die Konversation ab. #### 2. Praxisbeispiel: space.vars.TERM\_AI-Zusammenfassung bei Schichtwechsel Ein Fall zieht sich über mehrere Tage und viele Nachrichten hin. Ein neuer Mitarbeiter übernimmt am nächsten Morgen. 1. Statt 20 Nachrichten zu lesen, klickt er auf **„Chat zusammenfassen"**. 2. Die space.vars.TERM\_AI generiert eine kurze Zusammenfassung wie z. B.: „Kunde beschwert sich über defektes Display. Fotos wurden geschickt, Prüfung durch Technik steht noch aus. Kunde erwartet Rückruf bis 14 Uhr." 3. Der Mitarbeiter ist sofort arbeitsfähig und kann gezielt weiterarbeiten. #### 3. Praxisbeispiel: Nutzung der Mediathek für Standardprozesse Ein Kunde fragt nach einer Bedienungsanleitung. 1. Der Mitarbeiter klickt auf das Symbol **„Datei aus Mediathek senden"** im Antwortfenster. 2. Er wählt das aktuelle PDF-Handbuch aus der Mediathek aus. 3. Mit nur zwei Klicks ist das Dokument versendet – und es ist sichergestellt, dass immer die aktuellste Version herausgegeben wird. *** ### Best Practices * **Status konsequent pflegen:** Schließe Konversationen ab, sobald das Anliegen gelöst ist. Das hält die Inbox aller Beteiligten sauber. * **Zurückstellen statt vergessen:** Wenn du auf eine Rückmeldung wartest, nutze die „Zurückstellen"-Funktion. So geht keine Konversation unter. * **Interne Notizen nutzen:** Dokumentiere bei komplexen Fällen kurz das Ergebnis in einer Notiz. Falls der Kunde später erneut schreibt und ein anderer Kollege den Fall übernimmt, ist der Kontext sofort verfügbar. * **Transparente Zuweisung:** Wenn ein Kollege den Fall komplett übernehmen soll, nutze immer die Zuweisungsfunktion in der Seitenleiste. Eine interne Notiz allein reicht oft nicht aus, da der Fall sonst in deiner Inbox-Statistik bleibt. * **Tags konsequent verwenden:** Setze Labels ein, um Konversationen zu kategorisieren und später gezielt auswerten zu können. * space.vars.TERM\_AI**-Zusammenfassung bei Übernahmen lesen:** Lies bei der Übernahme einer space.vars.TERM\_AI\_AGENT-Konversation zuerst die space.vars.TERM\_AI-Zusammenfassung. Nichts frustriert Kunden mehr, als alles, was sie gerade dem space.vars.TERM\_AI\_AGENT erzählt haben, dem Menschen noch einmal erklären zu müssen. * space.vars.TERM\_AI\_AGENT**-Performance prüfen:** Reserviere dir wöchentlich 30 Minuten, um 5–10 zufällige space.vars.TERM\_AI\_AGENT-Konversationen zu prüfen. Nutze interne Notizen und Erwähnungen, um Feedback zur space.vars.TERM\_AI\_AGENT-Performance zu dokumentieren. # Konversationsdetails (Rechte Seite) Die Konversationsdetails bündeln alle begleitenden Informationen einer Unterhaltung – wie Zuweisung, Tags, Kontaktdaten und interne Notizen – kompakt in der rechten Seitenleiste. ### Wo finde ich die Konversationsdetails? Die Seitenleiste wird automatisch auf der rechten Seite angezeigt, sobald du eine Konversation öffnest. *** ### Was genau ist die Seitenleiste? Während die Mitte der Inbox den Nachrichtenverlauf zeigt, bündelt die rechte Seite alle begleitenden Informationen zur Konversation. Die Seitenleiste gliedert sich in folgende Bereiche: * **Konversations-ID und Name:** Die interne ID sowie der Name der Konversation. Der Name wird kanalabhängig vergeben, kann aber per Freitexteingabe aktualisiert werden. * **Mitarbeiter-Zuweisung:** Zeigt den aktuell zugewiesenen Mitarbeiter an. Über dieses Feld kann die Konversation einem anderen Mitarbeiter zugewiesen werden. * **Team-Zuweisung:** Zeigt das zugewiesene Team an und ermöglicht eine Zuordnung zu einem bestimmten Team. * **Widget-Karten:** Aufklappbare Karten mit konversationsbezogenen Variablenwerten – darunter Standard-Karten (Tags, Kontaktdaten, Organisationen, Notizen), benutzerdefinierte [Widgets](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/inbox-widgets) sowie App-Karten. Welche Karten angezeigt werden, ist pro Benutzer und pro space.vars.TERM\_AI\_AGENT konfigurierbar. * **Data-Cards:** Individuelle Karten, die über Schnittstellen externe Daten in Echtzeit abrufen und direkt in der Seitenleiste anzeigen. *** ### Verwendung #### Mitarbeiter zuweisen Du kannst eine Konversation einem bestimmten Mitarbeiter zuweisen, um die Zuständigkeit klar zu regeln. 1. Klicke in der Seitenleiste auf das Feld mit dem aktuell zugewiesenen Mitarbeiter (oder auf den leeren Zuweisungsbereich). 2. Es öffnet sich ein Dropdown mit der Überschrift „Mitarbeiter zuweisen". 3. Wähle den gewünschten Mitarbeiter aus der Liste aus. Die Konversation erscheint anschließend in der Inbox des ausgewählten Mitarbeiters. #### Konversation verlassen Wenn du selbst einer Konversation zugewiesen bist und die Zuweisung aufheben möchtest, klicke auf das **Verlassen-Symbol** (Pfeil-Icon) neben deinem Namen in der Seitenleiste. Deine Zuweisung wird damit aufgehoben. #### Team zuweisen 1. Klicke auf das Feld „Keinem Team zugewiesen" (oder auf das aktuell zugewiesene Team). 2. Es öffnet sich ein Dropdown mit der Überschrift „Team zuweisen". 3. Wähle das gewünschte Team aus. Die Konversation erscheint anschließend bei allen Mitgliedern des zugewiesenen Teams. Um die Team-Zuweisung wieder aufzuheben, wähle „Keinem Team zuweisen". #### Tags verwalten Über Tags kannst du Konversationen kategorisieren, um sie später gezielt filtern und auswerten zu können. **Tag hinzufügen:** 1. Klicke im Bereich „Tags" auf das Plus-Symbol (+). 2. Es öffnet sich ein Dropdown mit der Überschrift „Konversation taggen". 3. Wähle einen vorhandenen Tag aus der Liste oder suche nach einem bestimmten Tag. **Tag entfernen:** Klicke auf das **X-Symbol** direkt am jeweiligen Tag. #### Kontaktdaten einsehen und bearbeiten Im Bereich „Kontaktdaten" werden folgende Informationen zum zugehörigen Kontakt angezeigt: * **Name:** Bei unbekannten Kontakten wird ein anonymisierter Name angezeigt (z. B. „Anon. Krokodil #4a5888"). * **Telefonnummer:** Falls vorhanden, sonst „Telefonnummer hinzufügen". * **E-Mail-Adresse:** Falls vorhanden, sonst „E-Mail-Adresse hinzufügen". * **Erstellt:** Das Datum, an dem der Kontakt angelegt wurde. Über den Button **„Kontakt öffnen"** springst du direkt in die vollständige Kontaktansicht, um weitere Details einzusehen oder Stammdaten zu ergänzen. #### Notizen Im Bereich „Notizen" kannst du interne Anmerkungen zur Konversation hinterlegen. Diese Notizen sind nur für dein Team sichtbar – der Kunde sieht sie nicht. Gib deine Notiz in das Eingabefeld ein und speichere sie mit **Strg + Enter**. Hinweis: Die Seitenleisten-Notiz dient als schneller Kontexthinweis zur gesamten Konversation. Der **Notiz-Tab im Antwortbereich** ist hingegen für ausführlichere interne Kommunikation und @-Mentions gedacht. #### Data-Cards Data-Cards sind individuelle Informationskarten, die über Schnittstellen externe Daten abrufen und in Echtzeit in der Seitenleiste anzeigen. So sind relevante Informationen aus externen Systemen direkt in der Konversation verfügbar, ohne das Programm wechseln zu müssen. Ein typisches Beispiel: Ein E-Commerce-Unternehmen hat eine Schnittstelle zum Shop-System eingerichtet. Wenn ein Kunde schreibt „Wo bleibt meine Bestellung?", zeigt die Data-Card automatisch die letzten Bestellungen inklusive Sendungsstatus an. {% hint style="info" %} [Data-Cards ](/epic-ai-platform/epic-ai-platform/workspace/apps#datacard-erstellen)müssen über Schnittstellen eingerichtet werden und sind nicht standardmäßig verfügbar. {% endhint %} *** ### Widgets verwalten Widgets sind benutzerdefinierte Karten, die konversationsbezogene Variablenwerte in der Seitenleiste anzeigen. Agenten können Werte direkt in der Karte einsehen und bei Bedarf manuell anpassen. Ändert sich ein Variablenwert im laufenden Flow, wird er automatisch in der Karte aktualisiert. {% hint style="info" %} Widgets werden von Administratoren oder Inhabern unter `Einstellungen (⚙) → Inbox → Widgets` erstellt. Zur Erstellung und Konfiguration von Widgets siehe. {% endhint %} #### Karten ein- und ausblenden Nicht jede Karte muss für jeden Benutzenden sichtbar sein. Über „Einstellungen" am unteren Rand der Seitenleiste öffnest du die Übersicht „Widgets ein-/ausblenden". Dort werden alle verfügbaren Karten in drei Gruppen angezeigt: * **Standard** (z. B. Tags, Kontaktdaten, Organisationen, Notizen) * **Benutzerdefiniert** (manuell erstellte Widgets) * **App-Karten** (aus integrierten Apps) Setze oder entferne das Häkchen neben einer Karte, um sie ein- oder auszublenden. Die blaue Zahl neben dem Widget-Titel zeigt an, an welcher Position die Karte in der Seitenleiste eingeblendet wird. {% hint style="info" %} Die Einblende- und Positionseinstellungen gelten **pro Benutzer und pro** space.vars.TERM\_AI\_AGENT und werden individuell gespeichert. {% endhint %} #### Werte anzeigen und bearbeiten Felder, für die noch kein Wert gesetzt ist, zeigen einen grauen Platzhaltertext an (z. B. „Name hinzufügen"). Um einen Wert zu bearbeiten: 1. Klicke auf das gewünschte Feld. 2. Trage den neuen Wert ein oder wähle ihn aus: * **Text/Zahl:** Direkte Texteingabe. * **Checkbox:** Häkchen setzen oder entfernen. * **Dropdown:** Wähle einen der vordefinierten Werte aus der Auswahlliste. * **Datum:** Es öffnet sich ein Kalender. Wähle das Datum und bestätige mit „Übernehmen". 3. Bestätige die Eingabe mit **Enter**, um den Wert zu speichern. {% hint style="info" %} Solange ein Wert noch nicht gespeichert wurde, erscheint ein **oranges Warndreieck** neben dem Feld. Das Speichern eines beliebigen Feldes speichert dabei alle ausstehenden Änderungen der Karte gleichzeitig. Um eine Änderung zu verwerfen, klicke das entsprechende Feld an und drücke **ESC**. {% endhint %} #### Karte kopieren Über das **Kopieren-Symbol** (⧉) neben dem Kartentitel kannst du den gesamten Inhalt der Karte in die Zwischenablage kopieren – also alle sichtbaren Felder mit ihren Labels und aktuellen Werten. Das ist praktisch, um Konversationsdaten schnell in ein anderes Tool (z. B. ein CRM oder Ticketsystem) zu übertragen. *** ### Best Practices * **Zuweisung immer nutzen:** Wenn ein Kollege einen Fall komplett übernehmen soll, verwende die Zuweisungsfunktion. Eine interne Notiz mit „@Max, mach du das mal" reicht nicht aus – der Fall bleibt sonst in deiner Inbox-Statistik. * **Tags konsequent vergeben:** Vergib Tags bereits während der Bearbeitung, nicht erst nachträglich. So bleiben Konversationen von Anfang an strukturiert und filterbar. * **Kontaktdaten frühzeitig pflegen:** Ergänze fehlende Stammdaten direkt während der Konversation über „Kontakt öffnen". Vollständige Kontaktdaten erleichtern spätere Zuordnungen. * **Organisationen verknüpfen:** Ordne Kontakte einer Organisation zu, sobald bekannt ist, zu welchem Unternehmen sie gehören. * **Notizen für Kontext nutzen:** Hinterlege bei komplexen Fällen eine kurze Notiz in der Seitenleiste. Wenn ein Kollege den Fall später übernimmt, ist der Kontext sofort verfügbar. * **Widget-Werte immer bestätigen:** Das orange Warndreieck zeigt ungespeicherte Änderungen an. Drücke **Enter** zum Speichern – oder **ESC**, um die Änderung zu verwerfen. * **Widgets gezielt einblenden:** Blende nur die Karten ein, die für deinen Arbeitsbereich relevant sind. Das hält die Seitenleiste übersichtlich. # Kontakte Kontakte sind die zentrale Anlaufstelle, um alle Informationen zu Personen zu verwalten, die mit deinem AI Agent interagieren. Jeder Kontakt bündelt Stammdaten und Konversationshistoire. ### Wo finde ich die Kontakte? Navigiere über die linke Seitenleiste zu `Inbox > Kontakte`. Dort werden alle vorhandenen Kontakte in einer Tabelle aufgelistet. Die Tabelle zeigt folgende Spalten: **Name**, **E-Mail**, **Telefonnummer**, **Adresse** und **Erstellt am**. Über die Suchleiste oben kannst du gezielt nach einem bestimmten Kontakt suchen. {% hint style="info" %} Kontaktdaten lassen sich auch direkt aus der Inbox heraus pflegen. Wenn du eine Konversation öffnest, werden auf der rechten Seite die Kontaktdaten des jeweiligen Gesprächspartners angezeigt. Dort kannst du Daten einsehen, bearbeiten und den Kontakt mit einer Organisation verknüpfen. {% endhint %} *** ### Erklärung – Was genau sind Kontakte? Ein Kontakt ist ein Datensatz, der eine einzelne Person repräsentiert, die mit deinem space.vars.TERM\_AI\_AGENTkommuniziert hat. Kontakte werden automatisch angelegt, sobald eine erste Konversation startet. Dabei werden bekannte Datenfelder vorausgefüllt – die Informationen sind jedoch zunächst oft unvollständig und sollten manuell ergänzt werden. Kontaktiert eine Person deinen space.vars.TERM\_AI\_AGENT über mehrere Kanäle (z. B. Chat und Telefon), werden die Konversationen einem gemeinsamen Kontakt zugeordnet, sofern es einen gemeinsamen Nenner wie E-Mail-Adresse oder Telefonnummer gibt. #### Kontaktdaten Für jeden Kontakt stehen folgende Datenfelder zur Verfügung: * **Name:** Der Name der Person. * **Telefonnummer:** Die Telefonnummer des Kontakts. * **E-Mail-Adresse:** Die E-Mail-Adresse des Kontakts. * **Sprache:** Die Sprache des Kontakts (z. B. „DE"). * **Hausnummer:** Hausnummer der Adresse. * **Straße:** Straßenname der Adresse. * **Postleitzahl:** PLZ der Adresse. * **Stadt/Ort:** Stadt oder Ort der Adresse. * **Land:** Land der Adresse. #### Organisationen Im Bereich [Organisationen](#organisationen) eines Kontakts siehst du, welchen Organisationen dieser Kontakt zugeordnet ist. Falls noch keine Verknüpfung besteht, wird der Hinweis „Der Kontakt ist mit keiner Organisation verknüpft" angezeigt. Über den Button **„Organisation verknüpfen"** kannst du den Kontakt einer bestehenden Organisation zuordnen. #### Konversationen Im Bereich [Konversationen](#konversationen) werden alle Konversationen aufgelistet, die dieser Kontakt bisher geführt hat. Du siehst das Datum, die Konversations-ID sowie eine Vorschau auf die letzte Nachricht. Durch Klicken auf einen Eintrag kannst du die jeweilige Konversation direkt öffnen und den Verlauf einsehen. Über den Button **„Mehr laden"** kannst du ältere Konversationen laden. *** ### Verwendung – Wofür werden Kontakte verwendet? **Wichtige Informationen speichern**\ Kontakte bündeln alle relevanten Informationen zu einer Person an einem zentralen Ort. So kannst du bei eingehenden Anfragen schnell auf Name, Telefonnummer, E-Mail-Adresse oder Spracheinstellung zugreifen. **Interaktionshistorie nachverfolgen**\ Über den Bereich „Konversationen" in der Kontaktansicht siehst du chronologisch alle bisherigen Chats und Telefonate, die ein Kontakt mit deinem space.vars.TERM\_AI\_AGENT geführt hat. Das hilft dir, den Kontext früherer Gespräche schnell nachzuvollziehen. **Schnellzugriff auf Konversationen**\ Du kannst jede Konversation direkt aus dem Kontaktprofil heraus öffnen. So musst du nicht in der Inbox nach einzelnen Gesprächen suchen. **Organisatorische Zuordnung**\ Kontakte lassen sich mit Organisationen verknüpfen. So wird auf einen Blick sichtbar, welche Personen zu welchem Unternehmen gehören. Die Verknüpfung ist in beide Richtungen nutzbar: Vom Kontakt zur Organisation und von der Organisation zum Kontakt. **Kontaktdaten direkt in der Inbox pflegen**\ Wenn du in der Inbox eine Konversation öffnest, werden auf der rechten Seite die Kontaktdaten des Gesprächspartners angezeigt. Dort kannst du Daten direkt bearbeiten, Tags vergeben, Organisationen verknüpfen und Notizen hinterlegen – ohne den Bereich `Kontakte` separat aufrufen zu müssen. *** ### Verwaltung – Erstellung, Bearbeitung und Löschen #### Automatische Erstellung Ein Kontakt wird automatisch angelegt, sobald die erste Konversation mit einer neuen Person startet. Dabei werden bekannte Datenfelder (z. B. Telefonnummer bei einem Anruf) vorausgefüllt. Die restlichen Felder sind zunächst leer und können manuell ergänzt werden. #### Kontakt manuell erstellen 1. Navigiere über die linke Seitenleiste zu `Kontakte`. 2. Klicke unten rechts auf den Button **„Kontakt erstellen"**. 3. Fülle die gewünschten Felder aus (z. B. Name, Telefonnummer, E-Mail-Adresse). 4. Speichere den Kontakt. #### Kontakt bearbeiten Es gibt zwei Wege, einen Kontakt zu bearbeiten: **Über die Kontaktansicht:** 1. Navigiere zu `Kontakte` und wähle den gewünschten Kontakt aus der Liste aus. 2. Klicke in der Detailansicht auf das jeweilige Feld (z. B. „Telefonnummer hinzufügen"), um den Wert einzugeben oder zu ändern. **Direkt aus der Inbox:** 1. Öffne eine Konversation in der Inbox. 2. Die Kontaktdaten werden auf der rechten Seite angezeigt. 3. Klicke auf **„Kontakt öffnen"**, um zur vollständigen Detailansicht zu wechseln, oder bearbeite die sichtbaren Felder direkt. #### Organisation verknüpfen 1. Öffne den gewünschten Kontakt in der Detailansicht. 2. Scrolle zum Bereich **Organisationen**. 3. Klicke auf **„Organisation verknüpfen"**. 4. Suche nach der gewünschten Organisation und wähle sie aus. #### Kontakt löschen Kontakte können über die Tabellenansicht mit Klick auf das Mülltonnen-Symbol gelöscht werden. Die Kontaktkarte wird unwiederruflich gelöscht – Konversationen bleiben jedoch erhalten. *** ### Beispiele #### Beispiel: Kontakt nach einem Erstgespräch vervollständigen **Szenario:** Ein Kunde ruft zum ersten Mal an. Der space.vars.TERM\_AI\_AGENT erfasst automatisch die Telefonnummer. Nach dem Gespräch möchtest du die restlichen Kontaktdaten ergänzen. 1. Navigiere zu `Kontakte`. 2. Suche in der Liste nach der Telefonnummer des Anrufers (z. B. „+4946193069108"). 3. Klicke auf den Kontakt, um die Detailansicht zu öffnen. 4. Ergänze die fehlenden Daten: * Name: **Thomas Schmidt** * E-Mail-Adresse: **** * Straße: **Hauptstraße** * Hausnummer: **5** * Postleitzahl: **20095** * Stadt/Ort: **Hamburg** * Land: **Deutschland** 5. Scrolle zum Bereich **Organisationen** und klicke auf **„Organisation verknüpfen"**. 6. Suche nach **„Muster GmbH"** und wähle die Organisation aus. Ab sofort ist der Kontakt vollständig gepflegt und der Organisation zugeordnet. Bei zukünftigen Anrufen wird der Kontakt automatisch erkannt. *** ### Best Practices * **Hybride Datenpflege:** Nutze einen zweistufigen Prozess für die Kontaktverwaltung, um eine persönliche Kundenansprache sicherzustellen: * **Automatisierte Erfassung durch den** space.vars.TERM\_AI\_AGENT**:** Beim Erstkontakt (z. B. Anruf oder Chat) erfragt der space.vars.TERM\_AI\_AGENT fehlende Stammdaten wie Name, E-Mail-Adresse oder Sprache. Diese Daten werden automatisch im Kontakt hinterlegt, sofern die Felder einen validen Wert besitzen. * **Manuelles Überschreiben nach dem Gespräch:** Sobald ein Gespräch abgeschlossen ist, können die vom space.vars.TERM\_AI\_AGENT erfassten Daten über die Kontaktbearbeitung final überprüft und bei Bedarf korrigiert werden. So ist beim nächsten Kontakt sofort eine persönliche Anrede möglich. * **Kontaktdaten zeitnah pflegen:** Ergänze fehlende Kontaktdaten möglichst direkt nach dem ersten Gespräch. Je vollständiger die Daten sind, desto besser funktioniert die automatische Zuordnung bei zukünftigen Kontaktaufnahmen über verschiedene Kanäle. * **Organisationszuordnung nutzen:** Verknüpfe Kontakte frühzeitig mit der zugehörigen Organisation. So hast du jederzeit einen vollständigen Überblick über alle Ansprechpartner eines Unternehmens und deren gesamte Kommunikationshistorie. # Organisationen Organisationen ermöglichen es dir, Unternehmen, Firmen oder Gruppen zentral zu verwalten und mit bestehenden Kontakten zu verknüpfen. So hast du alle Informationen und Konversationen an einem Ort. ### Wo finde ich die Organisationen? Navigiere über die linke Seitenleiste zu `Inbox > Orgas`. Dort werden alle angelegten Organisationen in einer durchsuchbaren Liste dargestellt. Über die Suchleiste oben kannst du gezielt nach einer bestimmten Organisation suchen. *** ### Erklärung – Was genau sind Organisationen? Eine Organisation ist ein Datensatz, der eine Firma, ein Unternehmen oder eine Gruppe repräsentiert. Jede Organisation kann mit verschiedenen Informationen angereichert und mit Kontakten verknüpft werden. #### Organisationsdaten Für jede Organisation stehen folgende Datenfelder zur Verfügung: * **Name:** Der Name der Organisation (Pflichtfeld bei der Erstellung). * **Branche:** Die Branche, in der die Organisation tätig ist. * **E-Mail-Adresse:** Die zentrale E-Mail-Adresse der Organisation. * **Website:** Die Webadresse der Organisation. * **Mitarbeiter:** Anzahl oder Namen der Mitarbeiter. * **Hausnummer:** Hausnummer der Geschäftsadresse. * **Straße:** Straßenname der Geschäftsadresse. * **Postleitzahl:** PLZ der Geschäftsadresse. * **Stadt/Ort:** Stadt oder Ort der Geschäftsadresse. * **Land:** Land der Geschäftsadresse. #### Kontakte Im Bereich [Kontakte](/epic-ai-platform/epic-ai-platform/ai-agent/inbox/kontakte) einer Organisation siehst du, welche Kontakte dieser Organisation zugeordnet sind. Falls noch keine Verknüpfung besteht, wird der Hinweis „Der Organisation sind noch keine Kontakte zugeordnet" angezeigt. Über den Button **„Kontakt verknüpfen"** kannst du bestehende Kontakte mit der Organisation verbinden. #### Konversationen Im Bereich **Konversationen** werden alle Konversationen aufgelistet, die die verknüpften Kontakte bisher geführt haben. Du siehst den Zeitpunkt der letzten Nachricht sowie eine Vorschau auf die letzte Nachricht und den Absender. Durch Klicken auf einen Eintrag kannst du die jeweilige Konversation direkt öffnen. *** ### Verwendung – Wofür werden Organisationen verwendet? **Wichtige Informationen bündeln**\ Organisationen ermöglichen es dir, alle relevanten Daten zu einem Unternehmen an einem zentralen Ort zu speichern. So kannst du bei Anfragen schnell auf Branche, Adresse oder Kontaktdaten zugreifen, ohne in verschiedenen Systemen suchen zu müssen. **Kontakte zuordnen**\ Du kannst einzelne Kontakte einer Organisation zuweisen. So wird auf einen Blick sichtbar, welche Personen zu welchem Unternehmen gehören. Das ist besonders hilfreich, wenn mehrere Ansprechpartner derselben Firma mit deinem space.vars.TERM\_AI\_AGENT kommunizieren. **Interaktionshistorie nachverfolgen**\ Über den Bereich „Konversationen" in der Organisationsansicht siehst du chronologisch alle bisherigen Chats und Gespräche, die verknüpfte Kontakte geführt haben. Du kannst jede [Konversation](broken://pages/GHWFNr0nveRJvL5cvn6g) direkt aus der Organisationsansicht heraus öffnen und den Verlauf einsehen. *** ### Verwaltung – Erstellung, Bearbeitung und Löschen {% hint style="info" %} Die Verwaltung von Organisationen erfolgt ausschließlich über die Ansicht `Orgas` in der linken Seitenleiste. {% endhint %} #### Organisation erstellen 1. Navigiere über die linke Seitenleiste zu `Orgas`. 2. Klicke unten rechts auf den Button **„Organisation erstellen"**. 3. Gib im Dialogfeld den **Namen** der Organisation ein. 4. Klicke auf **„Organisation erstellen"**, um die Organisation anzulegen. Nach der Erstellung wirst du zur Detailansicht weitergeleitet. Dort kannst du die weiteren Organisationsdaten wie Branche, Adresse oder Website ergänzen. #### Organisation bearbeiten 1. Navigiere zu `Orgas` und wähle die gewünschte Organisation aus der Liste aus. 2. Klicke in der Detailansicht auf das jeweilige Feld (z. B. „Branche hinzufügen"), um den Wert einzugeben oder zu ändern. 3. Die Änderungen werden bei Herausklicken oder Druck der `Enter-Taste` gespeichert. #### Kontakt verknüpfen 1. Öffne die gewünschte Organisation in der Detailansicht. 2. Scrolle zum Bereich **Kontakte**. 3. Klicke auf **„Kontakt verknüpfen"**. 4. Suche im Suchfeld nach dem gewünschten Kontakt. 5. Wähle den Kontakt aus, um ihn der Organisation zuzuordnen. {% hint style="info" %} Es können nur bereits bestehende Kontakte verknüpft werden. Falls noch keine Kontakte vorhanden sind, wird der Hinweis „Es wurden keine Kontakte gefunden. Lege einen Kontakt an, um diesen mit einer Organisation zu verknüpfen" angezeigt. {% endhint %} #### Organisation löschen Organisationen können in der Tabellenübersicht mit Klick auf das Mülltonnen-Symbol gelöscht werden. *** ### Beispiele #### Beispiel: Kundenfirma anlegen und Ansprechpartner zuordnen **Szenario:** Ein Kunde der Firma „Muster GmbH" kontaktiert deinen space.vars.TERM\_AI\_AGENT. Du möchtest die Firma im System anlegen und den Kontakt zuordnen. 1. Navigiere zu `Orgas`. 2. Klicke auf **„Organisation erstellen"**. 3. Gib als Namen **„Muster GmbH"** ein und bestätige mit **„Organisation erstellen"**. 4. Ergänze in der Detailansicht die Organisationsdaten: * Branche: **Maschinenbau** * E-Mail-Adresse: **** * Website: **[www.muster-gmbh.de](http://www.muster-gmbh.de)** * Straße: **Industriestraße** * Hausnummer: **12** * Postleitzahl: **80333** * Stadt/Ort: **München** * Land: **Deutschland** 5. Scrolle zum Bereich **Kontakte** und klicke auf **„Kontakt verknüpfen"**. 6. Suche nach dem Kontakt **„Max Müller"** und wähle ihn aus. Ab sofort siehst du unter der Organisation „Muster GmbH" alle Konversationen, die Max Müller mit deinem space.vars.TERM\_AI\_AGENT geführt hat. *** ### Best Practices * **Aussagekräftige Namen verwenden:** Nutze den vollständigen Firmennamen inklusive Rechtsform (z. B. „Muster GmbH" statt „Muster"), damit Organisationen eindeutig identifizierbar sind. * **Daten vollständig pflegen:** Fülle möglichst viele Felder aus. Vollständige Organisationsdaten erleichtern die Zuordnung und spätere Suche erheblich. * **Kontakte zeitnah zuordnen:** Verknüpfe Kontakte direkt nach der Erstellung einer Organisation. So gehen keine Konversationen verloren und die Interaktionshistorie ist von Anfang an vollständig. * **Regelmäßig prüfen:** Überprüfe in regelmäßigen Abständen, ob Organisationsdaten noch aktuell sind und ob alle relevanten Kontakte zugeordnet wurden. # Benachrichtigungen Mit Benachrichtigungen wirst du über wichtige Ereignisse in der Inbox informiert. ### Wo finde ich die Benachrichtigungseinstellungen? Die Benachrichtigungseinstellungen findest du in der Inbox. Klicke dazu unten links auf das **Glocken-Symbol**. Es öffnet sich ein Dialogfenster, in dem du alle Benachrichtigungsoptionen konfigurieren kannst. {% hint style="info" %} Die Einstellungen beziehen sich immer nur auf den aktuell geöffneten space.vars.TERM\_AI\_AGENT. Wenn du Benachrichtigungen für mehrere space.vars.TERM\_AI\_AGENTs erhalten möchtest, musst du die Einstellungen für jeden space.vars.TERM\_AI\_AGENT separat vornehmen. Die Inbox muss in einem Tab aktiv sein, damit Benachrichtigungen ausgelöst werden. {% endhint %} ### Welche Benachrichtigungen gibt es? Es stehen vier Benachrichtigungstypen zur Verfügung. Für jeden Typen kannst du unabhängig voneinander festlegen, ob du per **Browser** und/oder per **E-Mail** benachrichtigt werden möchtest. **Nicht zugewiesene Konversationen, die vom** space.vars.TERM\_AI\_AGENT **übergeben werden**\ Du wirst benachrichtigt, wenn der space.vars.TERM\_AI\_AGENT eine Konversation über das Element [Übergabe an Agent (Chat)](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/block/elemente-aktionen#ubergabe-an-agent-chat) an die Inbox übergibt und diese noch keinem Teammitglied zugewiesen ist. Das ist besonders nützlich, um neue Anfragen schnell zu erkennen und zu übernehmen. **Konversationen, die dir vom** space.vars.TERM\_AI\_AGENT **zugewiesen werden**\ Du wirst benachrichtigt, wenn der space.vars.TERM\_AI\_AGENT eine Konversation über das Element [Mitarbeiter zuweisen](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/block/elemente-aktionen#mitarbeiter-zuweisen) direkt an dich persönlich übergibt. So verpasst du keine Konversation, für die du verantwortlich bist. **Aktivitäten in Konversationen, die dir zugewiesen sind**\ Du wirst benachrichtigt, wenn in einer dir bereits zugewiesenen Konversation eine neue eingehende Nachricht eintrifft. Damit bleibst du bei laufenden Gesprächen immer auf dem aktuellen Stand. **Konversationen, die deinem Team zugewiesen sind**\ Du wirst benachrichtigt, wenn der space.vars.TERM\_AI\_AGENT eine Konversation über das Element [Team zuweisen](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/block/elemente-aktionen#team-zuweisen) an ein Team übergibt, in welchem du Mitglied bist. *** ### Benachrichtigungskanäle **Browser-Benachrichtigungen**\ Browser-Benachrichtigungen erscheinen als Push-Benachrichtigungen auf deinem Gerät – auch wenn du gerade nicht aktiv in der Inbox arbeitest. {% hint style="info" %} Beim ersten Öffnen der Inbox wirst du von deinem Browser aufgefordert, Push-Benachrichtigungen zu erlauben. Du musst diese Berechtigung erteilen, damit Browser-Benachrichtigungen funktionieren. Falls du die Berechtigung abgelehnt hast, kannst du sie nachträglich in den Einstellungen deines Browsers wieder aktivieren. Bei längerer Inaktivität des Inbox-Tabs können Browser-Benachrichtigungen aussetzen. **Empfehlung:** Füge die Plattform in den Leistungseinstellungen deines Browsers als dauerhaft aktive Seite hinzu, um eine zuverlässige Zustellung sicherzustellen. {% endhint %} **E-Mail-Benachrichtigungen**\ E-Mail-Benachrichtigungen werden an die E-Mail-Adresse deines Benutzerkontos gesendet. Jede Benachrichtigung wird sofort als einzelne E-Mail verschickt – es gibt keine gebündelte Zustellung. ### Benachrichtigungen einrichten 1. Öffne die **Inbox** des gewünschten space.vars.TERM\_AI\_AGENTs. 2. Klicke unten links auf das **Glocken-Symbol**. 3. Aktiviere die gewünschten Checkboxen für die jeweiligen Benachrichtigungstypen und Kanäle (Browser und/oder E-Mail). 4. Klicke auf **Schließen**, um die Einstellungen zu übernehmen. {% hint style="info" %} Standardmäßig sind alle Benachrichtigungen deaktiviert. Du musst die gewünschten Optionen aktiv einschalten. {% endhint %} *** ### Best Practices * Aktiviere für alle space.vars.TERM\_AI\_AGENTs, die du betreust, mindestens die Benachrichtigung für **Konversationen, die dir zugewiesen werden**. So stellst du sicher, dass du keine persönlich an dich gerichtete Übergabe verpasst. * Wenn du im Team arbeitest und regelmäßig nicht zugewiesene Konversationen übernimmst, aktiviere zusätzlich die Benachrichtigung für **nicht zugewiesene Konversationen**. Das verkürzt die Reaktionszeit für deine Nutzer. * Nutze **Browser-Benachrichtigungen**, wenn du schnell reagieren möchtest, und **E-Mail-Benachrichtigungen** als zusätzliches Backup – z. B. wenn du nicht dauerhaft im Browser eingeloggt bist. * Denke daran, die Einstellungen für jeden space.vars.TERM\_AI\_AGENT separat zu konfigurieren. Wenn du einen neuen space.vars.TERM\_AI\_AGENT anlegst oder Zugriff auf einen weiteren erhältst, sind die Benachrichtigungen dort zunächst deaktiviert. # Versionen & Bereitstellungsumgebungen Versionen erfassen den exakten Entwicklungsstand deines AI Agents zu einem bestimmten Zeitpunkt. Sie bilden die Grundlage für jede Bereitstellung. ### Wo finde ich Versionen? Den Bereich für Versionen erreichst du über `AI Agent → Versionen`. Dort findest du: * **Umgebungskacheln** (oben): Drei farbige Kacheln zeigen dir auf einen Blick, welche Version mit welchem zugrundeliegenden [Modell](/epic-ai-platform/epic-ai-platform/ai-agent/daten/modelle) derzeit in welcher Umgebung bereitgestellt ist und seit wann. * **Versionsliste** (unten): Eine Tabelle aller existierenden Versionen mit Versionsnummer, Name, Erstellungszeitpunkt, Modell, Bereitstellungsstatus und ID. *** ### Erklärung – Was genau sind Versionen? Eine Version ist ein Snapshot – also eine Momentaufnahme – deines space.vars.TERM\_AI\_AGENTs. Sie speichert den gesamten Entwicklungsstand genau so, wie er im Moment der Erstellung aussieht. Spätere Änderungen im [Flow Builder](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder) fließen nicht in eine bereits erstellte Version ein. #### Voraussetzung: Trainiertes Modell Jeder Version liegt ein trainiertes Modell zugrunde. Bevor du eine Version erstellen kannst, muss mindestens ein Modell trainiert worden sein. Es wird automatisch das zuletzt trainierte Modell als Grundlage verwendet. #### Warum brauche ich Versionen? Um deinen space.vars.TERM\_AI\_AGENT in einer Umgebung (Test oder Produktiv) bereitzustellen, muss eine Version erstellt worden sein. #### Vergabe von Versionsnummern Das System nutzt ein numerisches Format (z. B. 1.0, 2.2) und unterscheidet automatisch zwischen zwei Arten: | **Typ** | **Beschreibung** | **Kriterium** | | ------------ | -------------------------------------------- | --------------------------------------------- | | Major Update | Die erste Ziffer erhöht sich (z. B. `2.0`). | Ein neues Modell liegt der Version zugrunde. | | Minor Update | Die zweite Ziffer erhöht sich (z. B. `1.1`). | Änderungen am Flow/Inhalt ohne Modellwechsel. | Die Versionsnummer wird beim Erstellen automatisch zugewiesen und ist im Erstellungsdialog sichtbar. #### Die drei Bereitstellungsumgebungen Es existieren drei getrennte Umgebungen, um einen sicheren Release-Zyklus zu gewährleisten: * **Entwicklungsumgebung (DEV):** Wenn du ein neues Modell trainierst, wird dieses automatisch in der Entwicklungsumgebung bereitgestellt. Diese Umgebung dient der internen Entwicklung und dem [Debugging](/epic-ai-platform/epic-ai-platform/ai-agent/debugging). * **Testumgebung (TEST):** Stelle eine Version in der Testumgebung bereit, damit du und andere Benutzer den space.vars.TERM\_AI\_AGENT auf einem realen [Kanal](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/kanale) testen können – z. B. über das Web-Widget oder eine intern bekannte Telefonnummer. * **Produktivumgebung (PROD):** Stelle eine Version in der Produktivumgebung bereit, damit alle Nutzer darauf zugreifen können. Diese Version ist über alle Kanäle erreichbar.
UmgebungCharakteristik
EntwicklungSpiegelt den aktuellen Live-Stand im space.vars.TERM_FLOW_BUILDER wider.
TestZur internen Qualitätssicherung von stabilen Versionen.
ProduktivDie finale Instanz für Endbenutzer.
{% hint style="info" %} Kanäle können in jeder der Bereitstellungsumgebungen angelegt werden. Achte darauf, dass nur die Kanäle für Endkunden erreichbar gemacht werden, die in der Produktivumgebung operieren. {% endhint %} *** ### Verwendung – Was kann man mit Versionen machen? #### Neue Version erstellen und bereitstellen 1. Klicke oben rechts auf **„Version erstellen"**. 2. **Name:** Vergib einen aussagekräftigen Namen. * Beispiel: „Black Week 2026" 3. **Beschreibung (optional):** Beschreibe die vorgenommenen Änderungen, um Transparenz und Nachvollziehbarkeit zu gewährleisten. * Beispiel: „Hinzufügen des Lieferverzögerungshinweises, Erweiterung der FAQs um Informationen zur Black Week." 4. **Vorgesehenes Modell:** Es wird automatisch das aktuellste Modell als Grundlage genutzt. Eine manuelle Auswahl ist nicht möglich. 5. **Bereitstellung:** Wähle die Zielumgebung aus (Test oder Produktiv). Wähle „Keine Bereitstellung", wenn die Version erst einmal nur gesichert werden soll. 6. Bestätige mit **„Version veröffentlichen"**. #### Version nachträglich bereitstellen Du kannst eine bereits erstellte Version auch nachträglich in einer Umgebung bereitstellen: 1. Wähle die gewünschte Version aus der Liste aus. 2. Klicke auf **„Bereitstellen"**. 3. Wähle die Zielumgebung: „Keine Bereitstellung" (Version nur erstellen), „Test" (zum Testen vor dem Go-Live) oder „Produktiv" (für alle Nutzer erreichbar). 4. Bestätige mit **„Bereitstellen"**. In der Übersicht erscheint kurz der Status „In Bereitstellung". Der Zeitstempel wird gesetzt, sobald die Version erfolgreich bereitgestellt wurde. Es kann einige Minuten dauern, bis eine Version erfolgreich bereitgestellt und das Umgebungslabel aktualisiert wird. {% hint style="info" %} Es kann einige Minuten dauern, bis eine Version erfolgreich bereitgestellt und das Umgebungslabel aktualisiert wird. {% endhint %} #### **Versionsdetails einsehen** Durch Klick auf eine beliebige Version in der Liste öffnest du die Detailansicht. Diese ist in zwei Bereiche unterteilt: **Details:** Name der Version, Versionsnummer, zugrundeliegende Modell-ID, aktueller Bereitstellungsstatus und Versions-ID. Wurde beim Erstellen eine Beschreibung hinterlegt, wird sie hier ebenfalls angezeigt. **Bereitstellung:** Zeitstempel für Erstellung und (falls bereitgestellt) Bereitstellung sowie die zugehörige Deployment-ID. #### **Auf eine Version zurücksetzen** Über den Button **„Zurücksetzen"** im Bereich „Auf Version zurücksetzen" kannst du den Flow Builder auf den Entwicklungsstand der gewählten Version zurücksetzen. Im Bestätigungsdialog kannst du zusätzlich per Schalter **„Einstellungen ebenfalls zurücksetzen"** festlegen, ob auch die allgemeinen Einstellungen deines AI Agents auf den Stand dieser Version zurückgesetzt werden sollen. Ist der Schalter deaktiviert, bleiben deine aktuellen Einstellungen erhalten und nur der Flow-Stand wird zurückgesetzt. {% hint style="danger" %} Nicht gespeicherte Änderungen im Flow Builder gehen beim Zurücksetzen verloren. Erstelle bei Bedarf vorher eine neue Version, um den aktuellen Stand zu sichern. {% endhint %} *** ### Verwaltung – Löschen von Versionen #### Einzelne Version löschen 1. Öffne die Detailansicht der gewünschten Version. 2. Klicke auf **„Löschen"** (roter Button unten rechts). 3. Bestätige den Löschvorgang im Bestätigungsdialog. #### Mehrere Versionen löschen 1. Markiere die gewünschten Versionen per Checkbox in der Versionsliste. 2. Klicke auf den **Mülleimer-Button** oben rechts. 3. Bestätige den Löschvorgang. {% hint style="danger" %} Wenn du eine Version löschst, die aktuell bereitgestellt ist, wird die Bereitstellung sofort abgebrochen. Dein space.vars.TERM\_AI\_AGENT ist für Benutzer auf dem entsprechenden Kanal dann vorübergehend nicht mehr erreichbar. Der Löschvorgang kann nicht rückgängig gemacht werden. {% endhint %} *** ### Beispiel: Version erstellen, testen und live stellen Das folgende Beispiel zeigt den empfohlenen Ablauf von der Entwicklung bis zur Live-Schaltung: **Szenario:** Du hast neue FAQs zur Black Week hinzugefügt und einen Hinweis auf Lieferverzögerungen ergänzt. 1. **Modell trainieren:** Trainiere ein neues Modell, um die Änderungen an Intentionen und Entitäten zu übernehmen. Das neue Modell wird automatisch in der Entwicklungsumgebung (DEV) bereitgestellt. 2. **Testen im Debug:** Teste die Änderungen direkt in der Plattform über die Entwicklungsumgebung. 3. **Version erstellen:** Gehe zu Hauptnavigation → Versionen und klicke auf „Version erstellen". Vergib den Namen „Black Week 2026" und die Beschreibung „Hinzufügen des Lieferverzögerungshinweises, Erweiterung der FAQs um Informationen zur Black Week." Wähle als Bereitstellung die Testumgebung aus. 4. **Interner Test:** Teste die Version auf einem realen Kanal in der Testumgebung – z. B. über das Web-Widget oder eine intern bekannte Telefonnummer. 5. **Live stellen:** Nach erfolgreicher Abnahme öffnest du die Detailansicht der Version und stellst sie in der Produktivumgebung bereit. 6. **Iteration:** Bei weiteren Änderungen beginnst du den Prozess wieder bei Schritt 1. *** ### Best Practices * **Immer zuerst testen:** Stelle neue Versionen zunächst in der Testumgebung bereit und prüfe sie auf einem realen Kanal, bevor du sie in der Produktivumgebung live schaltest. * **Aussagekräftige Namen und Beschreibungen verwenden:** Benenne Versionen so, dass du auch nach Wochen noch weißt, welche Änderungen sie enthalten. Nutze die Beschreibung, um konkrete Änderungen zu dokumentieren. * **Vor dem Zurücksetzen absichern:** Erstelle eine neue Version, bevor du den Flow Builder auf einen älteren Stand zurücksetzt. So geht kein aktueller Entwicklungsstand verloren. * **Bereitgestellte Versionen nicht leichtfertig löschen:** Prüfe vor dem Löschen, ob eine Version aktuell bereitgestellt ist. Das Löschen einer bereitgestellten Version macht deinen space.vars.TERM\_AI\_AGENT für Endnutzer unerreichbar. * **Kanäle bewusst zuordnen:** Achte darauf, dass nur Kanäle, die in der Produktivumgebung operieren, für Endkunden erreichbar sind (siehe Artikel „Kanäle"). # Debugging Das Debugging-Tool ist eine integrierte Testumgebung, mit der du Gespräche und einzelne Interaktionen deines AI Agents simulieren kannst – ohne dass echte Nutzer betroffen sind. ### Wo finde ich das Debugging-Tool? Das Tool lässt sich auf zwei Arten öffnen: 1. **Global:** Über den Button „Debugging öffnen" in der Navigationsleiste. 2. space.vars.TERM\_FLOW\_BUILDER**:** Direkt aus einem Schritt heraus über das Käfer-Symbol oben rechts. In diesem Fall startet die Konversation exakt an dieser Stelle im Flow. {% hint style="info" %} Beim Öffnen aus einem Schritt heraus musst du den vorherigen Flow-Verlauf nicht erneut durchlaufen. Die Simulation setzt direkt am gewählten Schritt an. {% endhint %} *** ### Erklärung – Was genau ist das Debugging-Tool? Das Debugging-Tool ist eine isolierte Umgebung, in der du ganze Gespräche oder einzelne Interaktionen deines space.vars.TERM\_AI\_AGENTs simulieren kannst. Es dient dazu, Flows, Bedingungen und Variablen in Echtzeit zu testen, bevor sie produktiv eingesetzt werden. #### Wichtige Eigenschaften * **Sichtbarkeit:** Das Tool öffnet sich als Overlay auf der rechten Seite des Bildschirms. * **Umgebung:** Die Konversation findet ausschließlich in der Entwicklungsumgebung statt. Sie wird nicht dauerhaft gespeichert und erscheint nicht in der Inbox. * **Live-Testing:** Änderungen an Flows sind sofort und ohne Versionierung testbar. {% hint style="info" %} Änderungen an Intentionen oder Entitäten erfordern weiterhin die Erstellung eines neuen [Modells](/epic-ai-platform/epic-ai-platform/ai-agent/daten/modelle) bevor sie im Debugging-Tool wirksam werden. {% endhint %} #### Debug-Kanal Bei der ersten Nutzung des space.vars.TERM\_FLOW\_BUILDERs wird automatisch ein interner Debug-Kanal im Hintergrund erstellt. Dieser Kanal ist in den Kanaleinstellungen sichtbar und dient ausschließlich der Kommunikation im Debugging-Tool. *** ### Verwendung – Was kann man mit dem Debugging-Tool machen? #### Debug-Chat nutzen Der Debug-Chat simuliert einen Endnutzer-Kanal. Du kannst darin Nachrichten eingeben, als wärst du ein Nutzer deines space.vars.TERM\_AI\_AGENTs. * Die Konversation startet standardmäßig mit dem globalen Einstiegspunkt, sofern sie nicht aus einem spezifischen Schritt heraus gestartet wurde. * Die Unterhaltung bleibt erhalten, bis sie manuell zurückgesetzt wird. Du kannst das Overlay schließen und die Konversation später an derselben Stelle fortführen. * Um die Konversation zurückzusetzen, wähle das Uhrensymbol „Nachrichten zurücksetzen". {% hint style="warning" %} Nach dem Zurücksetzen kann die Konversation nicht wiederhergestellt werden. {% endhint %} #### Variablen-Monitor verwenden Ein entscheidender Vorteil des Debug-Chats ist die Einsicht in das „Gedächtnis" deines space.vars.TERM\_AI\_AGENTs. Der Variablen-Monitor zeigt dir alle definierten Variablen und ihre aktuellen Echtzeit-Werte an. **Variablen-Monitor öffnen:** 1. Öffne den Debug-Chat. 2. Klicke auf das Icon „Variablen" in der linken Seitenleiste des Chats. 3. Die Variablen-Übersicht der aktuellen Konversation wird angezeigt. **Variablen zurücksetzen:** Wähle das Uhrensymbol „Variablen zurücksetzen", um alle Variablen zu löschen bzw. auf ihre Standardwerte zurückzusetzen. **Werte manuell überschreiben:** Du kannst Variablenwerte direkt im Variablen-Monitor überschreiben, um verschiedene Szenarien zu testen. Das ist besonders nützlich, um Bedingungen mit unterschiedlichen Werten zu prüfen, ohne den gesamten Flow erneut durchlaufen zu müssen. *** ### Beispiele #### Flow-Logik mit manipulierten Variablen testen Angenommen, dein Flow enthält eine Bedingung, die prüft, ob die Variable `Anzahl Artikel (Benutzerdefiniert - Konversation)` größer als 3 ist. Statt den gesamten Flow durchzuspielen, kannst du den Wert direkt im Variablen-Monitor ändern: 1. Öffne den Debug-Chat. 2. Öffne den Variablen-Monitor über das Icon „Variablen" in der linken Seitenleiste. 3. Suche die Variable `Anzahl Artikel (Benutzerdefiniert - Konversation)`. 4. Überschreibe den Wert manuell – z. B. mit `5`. 5. Setze die Konversation fort und beobachte, ob die Bedingung korrekt den erwarteten Pfad wählt. 6. Wiederhole den Test mit einem anderen Wert – z. B. `2` –, um auch den alternativen Pfad zu prüfen. #### Entitäts-Erkennung überprüfen Du möchtest testen, ob die Entität `IBAN` korrekt erkannt und in einer benutzerdefinierten Variable gespeichert wird: 1. Öffne den Debug-Chat über das Käfer-Symbol im entsprechenden Schritt, in dem die IBAN-Eingabe erwartet wird. 2. Gib eine Nachricht mit einer Test-IBAN ein, z. B. `DE89370400440532013000`. 3. Öffne den Variablen-Monitor und prüfe, ob die Entität `IBAN (Entität)` den Wert korrekt enthält. 4. Prüfe anschließend, ob der Wert wie erwartet in die benutzerdefinierte Variable `IBAN (Benutzerdefiniert - Kontakt)` übernommen wurde (siehe Artikel „Variablen", Abschnitt „Werte von Entitäten in Variablen speichern"). {% hint style="info" %} Entitätswerte werden nach jeder neuen Benutzereingabe zurückgesetzt. Stelle sicher, dass der Wert rechtzeitig in einer benutzerdefinierten Variable gespeichert wird. {% endhint %} *** ### Best Practices * **Gezielter Einstieg nutzen:** Starte den Debug-Chat direkt aus einem Schritt heraus über das Käfer-Symbol. So kannst du komplexe Logiken am Ende eines langen Flows testen, ohne den gesamten Flow durchlaufen zu müssen. * **Bedingungen systematisch testen:** Nutze die Möglichkeit, Variablenwerte im Variablen-Monitor manuell zu ändern. Prüfe damit, ob Wenn-Dann-Bedingungen korrekt reagieren – z. B. wenn eine Variable leer ist, einen bestimmten Wert enthält oder einen Grenzwert über- bzw. unterschreitet. * **Entitäten-Erkennung prüfen:** Kontrolliere im Variablen-Monitor, ob Regex- oder Listen-Entitäten wie erwartet extrahiert werden. Beachte dabei, dass Entitätswerte sich nach jeder neuen Eingabe zurücksetzen, sofern sie nicht in benutzerdefinierten Variablen gespeichert werden (siehe Artikel „Variablen"). * **Debug-Chat und Web-Widget gezielt einsetzen:** Verwende den Debug-Chat für schnelle Logik-Tests in der Entwicklungsumgebung. Nutze das [Web-Widget](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/kanale/web-kanal) für Tests, die in der Inbox erhalten bleiben sollen. # Build # Flow-Builder Der Flow-Builder ist die zentrale Arbeitsumgebung, in der du das Verhalten deines AI Agents gestaltest. Auf einem Canvas ordnest du Schritte an, verbindest sie miteinander und definierst den Prozess. ### Wo finde ich den space.vars.TERM\_FLOW\_BUILDER? Du erreichst den space.vars.TERM\_FLOW\_BUILDER über `AI Agent → Entwicklung → Flow-Builder`. Dort wird zunächst die [Flow-Übersicht](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/flows) angezeigt – eine Tabellenansicht aller vorhandenen Flows. Mit einem Klick auf einen Flow gelangst du in den jeweiligen Canvas, also die visuelle Arbeitsfläche des space.vars.TERM\_FLOW\_BUILDERs. *** ### Erklärung – Was genau ist der space.vars.TERM\_FLOW\_BUILDER? Der space.vars.TERM\_FLOW\_BUILDER ist ein visueller Editor, in dem du den Gesprächsablauf deines space.vars.TERM\_AI\_AGENTs per Drag & Drop zusammenbaust. Die Arbeitsfläche wird als Canvas bezeichnet. Auf diesem Canvas platzierst du sogenannte Schritte – also die einzelnen Bausteine eines Flows – und verbindest sie über Verbindungslinien miteinander. Jeder Flow hat einen eigenen Canvas. Innerhalb dieses Canvas bestimmst du, was der space.vars.TERM\_AI\_AGENT tun soll: Nachrichten senden, auf Nutzereingaben warten, Bedingungen prüfen, Variablen setzen, externe Dienste aufrufen und vieles mehr. Die Benutzeroberfläche des space.vars.TERM\_FLOW\_BUILDERs besteht aus drei Bereichen: * **Navigation (links):** Die Hauptnavigation der Plattform bleibt dauerhaft sichtbar und ermöglicht dir jederzeit den Wechsel zu anderen Bereichen. * **Canvas (Mitte):** Die zentrale Arbeitsfläche, auf der du Schritte platzierst, verbindest und bearbeitest. * **Seitenleiste „Schritt hinzufügen" (rechts):** Hier findest du alle verfügbaren Schritttypen, gruppiert nach Kategorien. Die Seitenleiste lässt sich bei Bedarf ein- und ausklappen. *** ### Navigation und Bedienung im Canvas #### Canvas bewegen und zoomen Du kannst den Canvas frei bewegen und zoomen, um auch bei komplexen Flows den Überblick zu behalten: * **Verschieben (Panning):** Halte die Maustaste auf einer freien Fläche gedrückt und ziehe den Canvas in die gewünschte Richtung. * **Zoomen:** Nutze das Mausrad, um rein- oder rauszuzoomen. Alternativ stehen in der Toolbar am unteren Rand des Canvas die Schaltflächen **+** und **–** sowie eine prozentuale Zoom-Anzeige zur Verfügung. * **Alles anzeigen:** Passt den Bildausschnitt automatisch an, damit alle eingefügten Schritte sichtbar sind. * **Anordnen:** Ordnet die Schritte auf dem Canvas automatisch an. #### Sprache wechseln In der Toolbar findest du außerdem ein Sprach-Dropdown. Darüber wählst du die [Sprache](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/sprache) aus, für die du aktuell Inhalte konfigurierst – z. B. „Deutsch". Die Sprachauswahl betrifft sprachabhängige Inhalte wie Textnachrichten in Blöcken. #### Tastenkürzel Der space.vars.TERM\_FLOW\_BUILDER unterstützt einige gängige Tastenkürzel, die deine Arbeit beschleunigen: * `Strg + C` / `Strg + V` – Schritt(e) kopieren und einfügen * `Backspace` – Ausgewählte Schritte löschen * `Shift + Mausklick` – Mehrere Schritte auswählen (Mehrfachauswahl) * `Strg + F` – Browser-Suche öffnen (um Text auf dem Canvas zu finden) *** ### Schritte – Die Bausteine deines Flows Schritte sind die einzelnen Bausteine, aus denen ein Flow aufgebaut ist. Jeder Schritt erfüllt eine bestimmte Aufgabe – z. B. eine Nachricht senden, eine Bedingung prüfen oder einen externen Dienst aufrufen. #### Verfügbare Schritttypen Die Schritttypen sind in der rechten Seitenleiste nach Kategorien gruppiert. Die wichtigsten Kategorien im Überblick: * **Häufig verwendet:** [Block](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/block), [Intention](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/intentionen), [Kontext](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/kontext), [Flow](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/flow-subflow) – die am häufigsten genutzten Schritte für den schnellen Zugriff. * **Flow-Kontrolle:** [Bedingung](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/bedingung), [Verzögerung](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/verzogerung), [A/B-Split](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/a-b-split), [Ende](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/ende) – Schritte, die den Ablauf steuern und verzweigen. * **Gen AI:** [Entitätserkennung](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/gen-ai-entitatserkennung), [Prompt ausführen](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/gen-ai-prompt-ausfuhren), [Gespräch führen](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/gen-ai-gesprach-fuhren) – space.vars.TERM\_AI-gestützte Schritte für dynamische Dialoge. * **Erweiterte Kontrolle:** [Flow (Subflow)](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/flow-subflow), [Ausstieg](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/ausstieg) – Schritte für die Strukturierung in Subflows. * **Interne Funktionen:** [Kontakt bearbeiten](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/kontakt-bearbeiten) – Schritt um die Kontaktkarte eines Kunden zu pflegen. * **Trigger:** [Tag hinzugefügt](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/tag-hinzugefugt), [Tag entfernt](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/tag-entfernt), [Variable geändert](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/variable-geandert), [Benutzerdefiniertes Event](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/benutzerdefiniertes-event) – Schritte, die Flows automatisch auslösen. * **App-Module:** Installierte [Apps](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/app-module) mit ihren Modulen, die als eigenständige Schritte eingebunden werden können. #### Schritte hinzufügen 1. Klicke in der rechten Seitenleiste auf den gewünschten Schritttyp und ziehe in auf den Canvas. 2. Klicke auf den neuen Schritt, um ihn zu konfigurieren – der jeweilige Bearbeitungsdialog öffnet sich. #### Schritte bearbeiten Klicke auf einen Schritt im Canvas, um seinen Bearbeitungsdialog zu öffnen. Je nach Schritttyp stehen unterschiedliche Konfigurationsmöglichkeiten zur Verfügung – z. B. Name, Beschreibung, Elemente, Bedingungen oder Prompt-Eingaben. #### Schritte verschieben Schritte lassen sich per Drag & Drop frei auf dem Canvas positionieren. Ziehe einen Schritt einfach an die gewünschte Stelle. Bestehende Verbindungen bleiben dabei erhalten. Um mehrere Schritte gleichzeitig zu verschieben, nutze die Mehrfachauswahl: Halte `Shift` gedrückt und klicke die gewünschten Schritte an. Anschließend kannst du die gesamte Auswahl gemeinsam verschieben. #### Schritte kopieren: Innerhalb eines space.vars.TERM\_AI\_AGENTs Du kannst einen oder mehrere Schritte kopieren und an anderer Stelle im Canvas einfügen: * **Per Tastenkürzel:** Wähle einen oder mehrere Schritte aus und drücke `Strg + C` zum Kopieren, dann `Strg + V` zum Einfügen. * **Per Rechtsklick:** Wähle einen oder mehrere Schritte aus, klicke mit der rechten Maustaste und wähle „Kopieren" aus dem Kontextmenü. Beim Kopieren werden die Schritte inklusive ihrer Konfiguration dupliziert. Sofern verbundene Schritte mitkopiert werden, werden auch die Verbindungen dupliziert. {% hint style="info" %} Trigger und Intentionen sowie Einstieg und Fallback können nicht kopiert werden, da sie im space.vars.TERM\_AI\_AGENT einzigartig sind. {% endhint %} #### Schritte kopieren: In einen anderen space.vars.TERM\_AI\_AGENT Du kannst Blöcke nicht nur innerhalb eines space.vars.TERM\_AI\_AGENTs kopieren, sondern auch von einem space.vars.TERM\_AI\_AGENT in einen anderen einfügen – unabhängig davon, ob sich beide im selben Workspace befinden. Beim Kopieren zwischen space.vars.TERM\_AI\_AGENTs gelten jedoch einige Einschränkungen: **Was wird nicht mitkopiert:** * **Variablen, Entitäten und Tags:** Diese werden nicht automatisch übertragen. Sie können im Ziel-space.vars.TERM\_AI\_AGENT als Platzhalter oder gelöschte Elemente angezeigt werden. Stelle sicher, dass die benötigten Ressourcen im Ziel-space.vars.TERM\_AI\_AGENT vorhanden sind, oder lege sie dort nachträglich an. * **Intentionen und Trigger:** Diese können grundsätzlich nicht kopiert werden. * **App-Module:** Auch App-Module werden nicht mit übertragen. {% hint style="danger" %} **Sprache beachten:** Die Ausgangssprache des kopierten Blocks sollte im Ziel-space.vars.TERM\_AI\_AGENT **vor dem Einfügen** aktiviert werden. Andernfalls können die Textinhalte nicht übernommen werden. {% endhint %} #### Schritte löschen Es gibt mehrere Wege, einen Schritt zu löschen: * **Über den Bearbeitungsdialog:** Öffne den Schritt und klicke auf das Papierkorb-Symbol. * **Per Tastatur:** Wähle einen oder mehrere Schritte aus und drücke `Backspace`. * **Per Rechtsklick:** Wähle einen oder mehrere Schritte aus, klicke mit der rechten Maustaste und wähle „Löschen" aus dem Kontextmenü. {% hint style="warning" %} Das Löschen eines Schritts entfernt auch alle Verbindungen, die von oder zu diesem Schritt führen. Überprüfe nach dem Löschen den Flow auf fehlende Verbindungen oder Logiklücken. {% endhint %} *** ### Schritte verbinden Verbindungen zwischen Schritten legen fest, in welcher Reihenfolge der AI Agent die Schritte durchläuft. Verbindungen werden als Linien zwischen den Schritten dargestellt und zeigen die Richtung des Gesprächsflusses an. {% hint style="info" %} Unverbundene Schritte und Ausgänge führen automatisch in den Fallback. {% endhint %} #### Verbindung erstellen 1. Bewege die Maus über den Ausgangspunkt (den kleinen Kreis) am rechten Rand eines Schritts. 2. Klicke und ziehe eine Linie zum Eingangspunkt des gewünschten Zielschritts. 3. Lasse die Maustaste los, um die Verbindung herzustellen. Verfügt ein Schritt über mehrere Ausgänge – z. B. bei einer Bedingung (Wahr/Falsch) oder einem Kontext-Schritt –, wird beim Ziehen einer Verbindung ein Auswahlmenü mit den verfügbaren Ausgängen angezeigt. Wähle den gewünschten Ausgang aus, um die Verbindung zuzuordnen. Die Verbindungslinien werden automatisch mit dem Namen des jeweiligen Ausgangs beschriftet, sodass du auf einen Blick erkennst, welcher Pfad wohin führt. #### Verbindung entfernen Um eine bestehende Verbindung zu entfernen, klicke direkt auf die Verbindungslinie. Die Verbindung wird dadurch gelöscht. #### Verbindung neu zuweisen Du kannst einen Ausgang auch direkt neu verbinden, ohne die alte Verbindung vorher zu löschen. Ziehe dazu eine neue Linie vom Ausgangspunkt des Schritts zum gewünschten neuen Zielschritt. Die bisherige Verbindung wird automatisch durch die neue ersetzt. *** ### IDs im space.vars.TERM\_FLOW\_BUILDER Innerhalb deines space.vars.TERM\_AI\_AGENTs sind alle Elemente über eindeutige IDs identifizierbar. Das betrifft Flows, Schritte, Tags, Variablen und weitere Objekte. Für Flows und Schritte gilt dabei folgendes System: * **Flow-IDs** sind pro space.vars.TERM\_AI\_AGENT einmalig. Jeder Flow hat eine eindeutige ID, die in der Flow-Tabellenansicht angezeigt wird. * **Schritt-IDs** sind pro Flow einmalig. Ein Schritt hat innerhalb seines Flows eine eindeutige ID. Dieselbe ID kann aber in einem anderen Flow erneut vorkommen. Durch die Kombination aus Flow-ID und Schritt-ID bleibt jeder Schritt im gesamten space.vars.TERM\_AI\_AGENTeindeutig identifizierbar. {% hint style="info" %} IDs sind vor allem dann relevant, wenn du mit der API arbeitest, die [Rohdaten](/epic-ai-platform/epic-ai-platform/ai-agent/statistiken/export-and-datenmodell) auswertest oder bei [Support-Anfragen](/support) einen bestimmten Schritt oder Flow referenzieren möchtest. {% endhint %} *** ### Best Practices * **Schritte logisch anordnen:** Platziere Schritte auf dem Canvas so, dass der Gesprächsfluss von links nach rechts oder von oben nach unten verläuft. Das erleichtert die Orientierung – besonders bei größeren Flows. * **Aussagekräftige Namen vergeben:** Benenne jeden Schritt so, dass sein Zweck auf einen Blick erkennbar ist – z. B. „IBAN abfragen" statt „Block 1". Das spart Zeit bei der späteren Wartung. * **Subflows für Struktur nutzen:** Lagere wiederkehrende oder thematisch abgegrenzte Abläufe in Subflows aus. Das hält den Hauptflow übersichtlich und macht einzelne Teile wiederverwendbar. * **Verbindungen regelmäßig prüfen:** Stelle sicher, dass alle Ausgänge mit einem Folgeschritt verbunden sind. Unverbundene Ausgänge können dazu führen, dass der [Fallback](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/flows#der-standard-flow-einstieg-and-fallback) ausgelöst wird oder der Flow unerwartet endet. * **Beschreibungsfelder nutzen:** Viele Schritte bieten ein optionales Beschreibungsfeld. Nutze es, um den Zweck eines Schritts zu dokumentieren – besonders bei komplexen Flows oder wenn mehrere Personen am space.vars.TERM\_AI\_AGENT arbeiten. * **Mehrfachauswahl für Effizienz:** Nutze `Shift + Klick` und die Kopier-Funktion, um ähnliche Schritte schnell zu duplizieren und anzupassen, anstatt sie einzeln neu zu erstellen. # Flows Flows sind die zentrale Struktur, in der du das Verhalten deines AI Agents aufbaust. Jeder Flow enthält einen eigenen Canvas, auf dem du Schritte anordnest, um Konversationsabläufe zu gestalten. ### Wo finde ich die Flows? Du findest die Flow-Übersicht unter `AI Agent → Entwicklung → Flow-Builder`. Dort werden alle vorhandenen Flows in einer Tabellenansicht angezeigt. Die Tabelle zeigt für jeden Flow den Namen, das Erstelldatum, das Datum der letzten Änderung sowie eine eindeutige ID. Eingerückte Einträge in der Tabelle sind sogenannte [Subflows](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/flow-subflow). Wenn noch kein Flow eingerichtet wurde, siehst du einen leeren Zustand mit der Schaltfläche **„Flow einrichten"**, über die du deinen ersten Flow – den Standardflow – anlegen kannst. *** ### Erklärung – Was genau sind Flows? Flows bilden die Grundstruktur deines space.vars.TERM\_AI\_AGENTs. Sie bestehen aus je einem Canvas, auf dem du Schritte wie Nachrichten, Bedingungen, Aktionen und weitere Elemente anordnest. Mit einem Klick auf einen Flow in der Tabellenansicht gelangst du in den jeweiligen Canvas. Flows lassen sich auf zwei Ebenen organisieren: * **Flows auf oberster Ebene** erscheinen direkt in der Tabellenansicht. Sie sind gleichwertig zueinander und können unabhängig voneinander genutzt werden. Da sie – ausgenommen vom Standard Flow – keine nativen Einstiegspunkte haben, sollten Sie einen [Trigger](/epic-ai-platform/epic-ai-platform/ai-agent/build/trigger) oder eine [Intention](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/intentionen) als Einstiegspunkt erhalten. * **Subflows** sind Flows, die innerhalb eines anderen Flows über einen [Flow-Schritt](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/flow-subflow) im space.vars.TERM\_FLOW\_BUILDER eingefügt werden. In der Tabellenansicht werden sie eingerückt unter ihrem übergeordneten Flow dargestellt. #### Der Standard-Flow: Einstieg & Fallback Der erste Flow, den du einrichtest, ist der sogenannte **Standard-Flow**. Er hat eine besondere Rolle und unterscheidet sich von allen anderen Flows: * Der Standard-Flow kann **nicht umbenannt** und **nicht gelöscht** werden. * Er enthält zwei einmalige, automatisch angelegte Schritte: * **Einstieg:** Hier beginnen standardmäßig alle Konversationen mit dem space.vars.TERM\_AI\_AGENT. Der Einstieg existiert nur einmal pro space.vars.TERM\_AI\_AGENT. * **Fallback:** Wenn im Flow etwas schiefgeht, ein Ausgang unverbunden ist oder eine Intention nicht getroffen wird, wird die Konversation ab dem Fallback weitergeführt. Der Fallback gilt **global für alle Flows** – er ist pro space.vars.TERM\_AI\_AGENT einmalig. {% hint style="info" %} Sowohl der Einstieg als auch der Fallback sind feste Bestandteile des Standard-Flows und können nicht entfernt oder in andere Flows verschoben werden. {% endhint %} #### Was sind Subflows? Ein Subflow ist ein Flow, der innerhalb eines anderen Flows eingebettet wird. Du erstellst einen Subflow, indem du im space.vars.TERM\_FLOW\_BUILDER einen Schritt vom Typ „Flow" einfügst und ihm einen Namen gibst. Subflows eignen sich besonders gut, um wiederkehrende oder thematisch abgegrenzte Konversationsteile auszulagern – zum Beispiel eine Produktberatung, einen Reklamationsprozess oder eine Lieferstatusabfrage. In der Tabellenansicht erkennst du Subflows an ihrer Einrückung unter dem übergeordneten Flow. Beispiel: * 1\. Produktberatung * 2\. Bestellthemen * 2.1 Lieferung * 2.2 Reklamation * 2.2.3 Widerruf/Retoure *** ### Verwaltung – Erstellung, Bearbeitung und Löschen #### Flow erstellen 1. Navigiere zur Flow-Übersicht unter `AI Agent → Entwicklung → Flow-Builder`. 2. Klicke oben rechts auf die Schaltfläche **„Flow erstellen"**. 3. Es öffnet sich ein Dialog, in dem du einen Namen für den Flow eingibst. 4. Klicke auf **„Flow erstellen"**, um den neuen Flow anzulegen. Der Flow erscheint nun in der Tabellenansicht und kann über einen Klick auf seinen Namen geöffnet werden. {% hint style="info" %} Wenn du den allerersten Flow einrichtest, wird dieser automatisch zum Standard-Flow. Er enthält dann die Schritte „Einstieg" und „Fallback". {% endhint %} #### Subflow erstellen Subflows werden nicht über die Tabellenansicht erstellt, sondern direkt im space.vars.TERM\_FLOW\_BUILDER eines bestehenden Flows. Füge dazu einen Schritt vom Typ [Flow](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/flow-subflow) ein und vergib einen Namen. Der Subflow erscheint anschließend eingerückt in der Tabellenansicht. #### Flow löschen Flows auf oberster Ebene (außer dem Standard-Flow) kannst du über die Tabellenansicht löschen: 1. Fahre mit der Maus über den gewünschten Flow in der Tabelle. 2. Klicke auf das **Papierkorb-Symbol** am rechten Rand der Zeile. 3. Es erscheint ein Bestätigungsdialog mit dem Hinweis, dass alle Schritte im Flow sowie alle untergeordneten Flows (Subflows) gelöscht werden. 4. Klicke auf **„Flow löschen"**, um den Vorgang zu bestätigen – oder auf **„Abbrechen"**, um den Löschvorgang abzubrechen. Subflows können auf zwei Wegen gelöscht werden: * Über die Tabellenansicht (wie oben beschrieben). * Durch das Löschen des zugehörigen „Flow"-Schritts im übergeordneten space.vars.TERM\_FLOW\_BUILDER. {% hint style="warning" %} Beim Löschen eines Flows werden **alle Schritte darin sowie alle untergeordneten Subflows** unwiderruflich entfernt. Stelle sicher, dass der Flow und seine Subflows nicht mehr benötigt werden, bevor du ihn löschst. {% endhint %} #### Flows umbenennen Flows auf oberster Ebene sowie der Standard-Flow können **nicht umbenannt** werden. Nur Subflows lassen sich umbenennen – über den zugehörigen „Flow"-Schritt im space.vars.TERM\_FLOW\_BUILDER. *** ### Beispiele #### Beispiel: Flow-Struktur für einen Kundenservice-space.vars.TERM\_AI\_AGENT Ein typischer Kundenservice-space.vars.TERM\_AI\_AGENT könnte folgende Flow-Struktur nutzen: * **Standard** (Standard-Flow mit Einstieg und Fallback) * **1. Produktberatung** (Subflow für Beratungsgespräche; Trigger oder Intention als Einstieg) * **2. Bestellthemen** (Subflow als Überkategorie; Trigger oder Intention als Einstieg) * **2.1 Lieferung** (Subflow für Lieferstatus-Anfragen) * **2.2 Reklamation** (Subflow für Reklamationsabwicklung) * **2.3 Widerruf/Retoure** (Subflow für Widerrufs- und Retourenprozesse) Der Standard-Flow dient als Einstiegspunkt. Von dort wird der Nutzer je nach Anliegen in den passenden Subflow weitergeleitet. Falls keine Intention erkannt wird, greift der Fallback im Standard-Flow und fängt die Konversation auf. *** ### Best Practices * **Nutze eine klare Namenskonvention für Flows und Subflows:** Nummeriere zusammengehörige Flows (z. B. „2.1 Lieferung", „2.2 Reklamation"), damit die Tabellenansicht übersichtlich bleibt und die Hierarchie sofort erkennbar ist. * **Halte Flows thematisch fokussiert:** Lagere eigenständige Themen wie „Reklamation" oder „Produktberatung" in eigene Subflows aus, anstatt alles in einem einzigen Flow zu bauen. Das verbessert die Übersichtlichkeit und erleichtert spätere Anpassungen. * **Prüfe den Fallback regelmäßig:** Da der Fallback global für alle Flows greift, sollte er eine sinnvolle Auffangnachricht enthalten – z. B. eine freundliche Rückfrage oder die Weiterleitung an einen Mitarbeiter. * **Lösche Flows mit Bedacht:** Da beim Löschen auch alle Subflows entfernt werden, solltest du vorher sicherstellen, dass keine wichtigen Konversationsabläufe betroffen sind. # Block Ein Block ist der zentrale Baustein im Flow-Builder. Er definiert, was der AI Agent an einer bestimmten Stelle im Gesprächsfluss tut – bspw. Nachrichten senden, Variablen speichern oder Tags setzen. ### Wo finde ich Blöcke? Blöcke werden direkt im space.vars.TERM\_FLOW\_BUILDER erstellt und verwaltet. Du fügst einen neuen Block über die rechte Seitenleiste hinzu: `Flow-Builder → Seitenleiste rechts → Schritt hinzufügen → Häufig verwendet → Block` *** ### Was genau ist ein Block? Ein Block ist ein Schritt im Gesprächsfluss, der eine oder mehrere Aktionen ausführt. Er wird im space.vars.TERM\_FLOW\_BUILDER als eigenständiger Knoten dargestellt und kann mit anderen Schritten verbunden werden. Innerhalb eines Blocks kannst du beliebig viele Elemente kombinieren – z.B. zuerst eine Textnachricht senden, dann eine Variable speichern und anschließend ein Tag setzen. *** ### Aufbau eines Blocks Wenn du einen Block bearbeitest, öffnet sich das Bearbeitungspanel. Es besteht aus folgenden Bereichen: #### Name Gib dem Block einen aussagekräftigen Namen. Der Name ist im space.vars.TERM\_FLOW\_BUILDER sichtbar und hilft dabei, den Überblick im Gesprächsfluss zu behalten. **Empfehlung:** Wähle einen Namen, der die Funktion des Blocks beschreibt – z. B. „IBAN abfragen" oder „Begrüßung senden". #### Beschreibung (optional) Über das Stift-Symbol kannst du dem Block eine interne Beschreibung hinzufügen. Diese ist im space.vars.TERM\_FLOW\_BUILDER sichtbar und hilft, den Zweck des Blocks zu dokumentieren. #### Sprache Das Sprach-Dropdown-Menü zeigt die aktive Sprache an, für die du gerade Elemente konfigurierst (z. B. „Deutsch"). Wenn in deinem space.vars.TERM\_AI\_AGENT mehrere Sprachen aktiviert sind, kannst du pro Sprache eigene Inhalte hinterlegen. {% hint style="info" %} Wenn für eine Sprache kein Inhalt hinterlegt wird, greift das System automatisch auf die Standardsprache zurück – sofern „Automatisches Übersetzen" in den Spracheinstellungen aktiviert ist. (Weitere Informationen findest du im Artikel [Sprachen](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/sprache).) {% endhint %} *** ### Elemente Über den Button „Element hinzufügen" fügst du dem Block Inhalte und Aktionen hinzu. Elemente werden der Reihe nach ausgeführt. Du kannst beliebig viele Elemente kombinieren. Elemente können über das Symbol mit den Verschieben-Symbol (sechs Punkte) beliebig in der Reihenfolge verändert werden. Die verfügbaren Elemente sind in Kategorien eingeteilt. Ausführlichere Informationen zu jedem Element findest du in den Artikeln zu den Kategorien. #### [**Basis**](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/block/elemente-basis) * **Textnachricht:** Sendet dem Nutzer eine Textnachricht. Unterstützt Variablen für personalisierte Inhalte. * **Buttons:** Zeigt dem Nutzer klickbare Auswahloptionen an.\ *Hinweis*: Aufgrund von WhatsApp-Limitationen kann der Button-Name maximal 20 Zeichen umfassen. * **WhatsApp Template:** Sendet eine vordefinierte WhatsApp-Template-Nachricht. #### [**Aktionen**](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/block/elemente-aktionen) * **Konversation als ungelesen markieren:** Markiert die aktuelle Konversation als ungelesen im Posteingang. * **Konversation zurückstellen:** Stellt die Konversation für eine spätere Bearbeitung zurück. * **Tag hinzufügen:** Fügt der Konversation ein Tag hinzu (z.B. zur Kategorisierung). * **Tag entfernen:** Entfernt ein bestehendes Tag von der Konversation. * **Variable festlegen:** Speichert einen Wert in einer benutzerdefinierten Variable. (Weitere Informationen findest du im Artikel „Variablen".) * **Notiz erstellen:** Erstellt eine interne Notiz zur Konversation. * **Übergabe an Agent (Chat):** Übergibt die Konversation an einen menschlichen Agenten. * **Team zuweisen:** Weist die Konversation einem bestimmten Team zu. * **Mitarbeiter zuweisen:** Weist die Konversation einem bestimmten Mitarbeiter zu. #### [**Dateien**](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/block/elemente-dateien) * **Bild senden:** Sendet dem Nutzer ein Bild. * **Video senden:** Sendet dem Nutzer ein Video. * **Audio senden:** Sendet dem Nutzer eine Audiodatei. * **Dokument senden:** Sendet dem Nutzer ein Dokument (z. B. PDF). #### [**Voice Agent**](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/block/elemente-voice-agent) * **Sprachausgabe:** Gibt einen Text als Sprache aus (für space.vars.TERM\_VOICE\_AGENT-Flows). * **Gespräch beenden:** Beendet das Gespräch (Event: *voice\_hangup*). * **Gespräch übertragen:** Überträgt das Gespräch an eine andere Rufnummer (Event: *voice\_transfer*). Nummern müssen mit vorangehendem `+` sowie der Länderkennung (z. B. +49) beginnen. * **Einstellungen ändern:** Erlaubt es, Kanaleinstellungen für die nächste Benutzereingabe zu ändern. Näheres zu den möglichen Einstellungen findest du in den [Kanaleinstellungen](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/kanale/voice-kanal#konfiguration-und-spracheinstellungen). *** #### Weitere Optionen: Nutzereingabe erwarten Im Bereich „Weitere Optionen" findest du die Checkbox **„Erwartet Nutzereingabe nach diesem Block"**. Wenn diese Option aktiviert ist, wartet der space.vars.TERM\_AI\_AGENT nach Ausführung aller Elemente des Blocks auf eine Eingabe des Nutzers. Der Flow pausiert an dieser Stelle. Die eingehende Nutzereingabe dient dann als Verbindungspunkt zu nachfolgenden Schritten. Wenn die Option nicht aktiviert ist, führt der space.vars.TERM\_AI\_AGENT den nächsten Schritt im Flow direkt und automatisch aus, ohne auf eine Nutzereingabe zu warten. **Hinweis:** Aktiviere diese Option überall dort, wo der space.vars.TERM\_AI\_AGENT auf eine Antwort des Nutzers angewiesen ist, bevor er weitermacht – z.B. nach einer Frage oder einer Dateneingabe. {% hint style="info" %} Ist die Option nicht aktiviert und der Block ist nicht mit einem weiteren Schritt verbunden, löst die nächste Benutzereingabe automatisch die Intentionserkennung aus. {% endhint %} *** ### Block erstellen 1. Öffne den space.vars.TERM\_FLOW\_BUILDER und klicke in der rechten Seitenleiste auf **„Schritt hinzufügen"**. 2. Wähle unter „Häufig verwendet" den Eintrag **„Block"** aus. 3. Der neue Block erscheint im space.vars.TERM\_FLOW\_BUILDER und das Bearbeitungspanel öffnet sich. 4. Vergib einen aussagekräftigen **Namen** für den Block. 5. Wähle bei Bedarf eine **Sprache** aus der Dropdown aus. 6. Klicke auf **„Element hinzufügen"**, um dem Block Inhalte oder Aktionen hinzuzufügen. 7. Konfiguriere die hinzugefügten Elemente nach deinen Anforderungen. 8. Aktiviere die Option **„Erwartet Nutzereingabe nach diesem Block"**, falls der space.vars.TERM\_AI\_AGENT an dieser Stelle auf eine Nutzereingabe warten soll. 9. Klicke auf **„Ok"**, um den Block zu speichern. *** ### Block bearbeiten 1. Klicke im space.vars.TERM\_FLOW\_BUILDER auf den Block, den du bearbeiten möchtest. 2. Das Bearbeitungspanel öffnet sich. 3. Nimm deine Änderungen vor – z.B. Namen anpassen, Elemente hinzufügen oder entfernen. 4. Klicke auf **„Ok"**, um die Änderungen zu speichern. *** ### Block löschen 1. Öffne den Block, den du löschen möchtest. 2. Klicke oben rechts im Bearbeitungspanel auf das **Papierkorb-Symbol**. 3. Bestätige das Löschen. **Achtung:** Das Löschen eines Blocks entfernt ihn aus dem Flow. Bestehende Verbindungen zu anderen Schritten (z. B. Intentionen oder Blöcken, die auf diesen Block zeigen) werden dabei getrennt. Überprüfe nach dem Löschen den Flow auf fehlende Verbindungen oder Logikfehler. *** ### Beispiel: Block zur IBAN-Abfrage erstellen In diesem Beispiel soll der space.vars.TERM\_AI\_AGENT den Nutzer nach seiner IBAN fragen und anschließend auf die Eingabe warten. 1. Klicke in der Seitenleiste auf **„Schritt hinzufügen" → „Block"**. 2. Benenne den Block: **„IBAN abfragen"**. 3. Klicke auf **„Element hinzufügen"** und wähle **„Textnachricht"** aus. 4. Trage folgende Nachricht ein: `Bitte teile uns deine IBAN mit.` 5. Aktiviere die Checkbox **„Erwartet Nutzereingabe nach diesem Block"**. 6. Klicke auf **„Ok"**. 7. Verbinde den Block im Flow mit dem nächsten Schritt – z.B. mit einem Block, der die erkannte IBAN in einer Variable speichert. (Weitere Informationen findest du im Artikel „Variablen".) *** ### Best Practices * Gib jedem Block einen beschreibenden Namen. Ein Name wie „Begrüßung senden" ist im space.vars.TERM\_FLOW\_BUILDER auf einen Blick verständlich – anders als ein generischer Name wie „Block 1". * Nutze das Beschreibungsfeld, um den Zweck eines Blocks zu dokumentieren – besonders bei komplexen Flows mit vielen Schritten. So behältst du auch später noch den Überblick. * Aktiviere „Erwartet Nutzereingabe nach diesem Block" bewusst und gezielt. Ist die Option unnötig aktiviert, wartet der space.vars.TERM\_AI\_AGENT auf eine Eingabe, obwohl keine erwartet wird – das kann den Flow ungewollt pausieren. * Kombiniere mehrere Elemente innerhalb eines Blocks, wenn sie logisch zusammengehören – z. B. eine Textnachricht senden und gleichzeitig ein Tag setzen. So bleibt der Flow übersichtlich und die Anzahl der Schritte gering. # Elemente: Basis Die Kategorie „Basis" enthält die grundlegenden Elemente für die Ausgabe von Nachrichten und die Steuerung von Nutzerinteraktionen. ### Textnachricht Eine Textnachricht sendet einen einfachen Text an den Nutzer. Gib den gewünschten Text direkt in das Eingabefeld ein. Du kannst Variablen über den [Variablen-Picker ](/epic-ai-platform/epic-ai-platform/ai-agent/build/variablen#variablen-picker)einfügen, um den Text dynamisch zu gestalten – eingefügte Variablen werden automatisch blau hervorgehoben (siehe Artikel [Variablen](/epic-ai-platform/epic-ai-platform/ai-agent/build/variablen)). **Beispiel:** `Hallo {{Vorname (Benutzerdefiniert - Kontakt)}}, wie kann ich dir helfen?` {% hint style="info" %} Die Textnachrichten sind mit allen Kanälen kompatibel. {% endhint %} *** ### Buttons Das Buttons-Element zeigt dem Nutzer eine oder mehrere klickbare Schaltflächen an. Jeder Button führt bei Klick eine definierte Aktion aus. #### **Button hinzufügen** Füge über das Button-Element einen neuen Button hinzu. Für jeden Button kannst du folgendes festlegen: * **Name:** Die Beschriftung des Buttons, die dem Nutzer angezeigt wird. Der Name kann maximal 20 Zeichen lang sein – Grund dafür sind Limitationen seitens WhatsApp. * **Typ:** Legt fest, was beim Klick passiert. Es gibt zwei Typen: * **Block:** Der Klick leitet den Nutzer zu einem anderen Block im Flow weiter. Du wählst den Ziel-Block aus dem Flow aus, indem du eine Verbindung ziehst. * **URL:** Der Klick öffnet eine externe Webseite. Du gibst die gewünschte URL ein. * **Payload:** Legt einen Wert fest, der beim Klick auf den Button automatisch in der Systemvariable `Payload des zuletzt geklickten Buttons (Unterhaltung)` gespeichert wird. Du kannst entweder einen Freitext oder den Wert einer bestehenden Variable angeben.\ Da der Payload-Wert automatisch gespeichert wird, musst du anschließend keine eigene Variable setzen. Stattdessen kannst du die Systemvariable `Payload des zuletzt geklickten Buttons (Unterhaltung)` direkt im weiteren Flow verwenden – zum Beispiel in Bedingungen oder Nachrichten. Klicke auf **Übernehmen**, um den Button zu speichern. #### **Mehrere Buttons** Du kannst mehrere Buttons in einem Element anlegen. Die Buttons werden dem Nutzer nebeneinander oder untereinander angezeigt, abhängig vom Kanal. #### **Beispiel** Ein Block fragt den Nutzer nach seinem Anliegen und bietet drei Optionen als Buttons an: * Button 1: **„Bestellung verfolgen"** → Typ: Block → Ziel: Block „Sendestatus abfragen" * Button 2: **„Rechnung anfragen"** → Typ: Block → Ziel: Block „Rechnung" * Button 3: **„Zur Website"** → Typ: URL → `https://www.beispiel.de` {% hint style="info" %} Buttons sind ausschließlich mit Textkanälen kompatibel. {% endhint %} *** #### WhatsApp Template Ein [WhatsApp Template](broken://pages/5YYPI6awFMSrR6V97EiT) sendet eine vorab genehmigte Nachrichtenvorlage an den Nutzer über WhatsApp. WhatsApp schreibt vor, dass Nachrichten, die außerhalb eines aktiven Gesprächsfensters (24 Stunden nach der letzten Nutzernachricht) gesendet werden, ein genehmigtes Template verwenden müssen. Über dieses Element wählst du das gewünschte Template aus. Klicke auf **„Template auswählen"**, um ein verfügbares Template auszuwählen . {% hint style="info" %} Das WhatsApp Template ist ausschließlich mit dem WhatsApp-Kanal kompatibel. {% endhint %} *** ### Best Practices * **Textnachrichten kurz halten:** Formuliere Nachrichten präzise und auf den Punkt. Lange Texte werden auf mobilen Geräten schlecht lesbar. Teile komplexe Informationen lieber auf mehrere Blöcke auf. * **Variablen in Textnachrichten nutzen:** Personalisierte Nachrichten erhöhen die Qualität des Gesprächs. Verwende Variablen wie `{{Vorname (Benutzerdefiniert - Kontakt)}}`, um Nutzer direkt anzusprechen. * **Buttons sparsam einsetzen:** Biete nicht mehr Buttons an, als nötig. Zu viele Optionen überfordern den Nutzer. Drei bis vier Buttons sind in der Regel ausreichend. * **Button-Namen klar formulieren:** Der Button-Name sollte eindeutig beschreiben, was nach dem Klick passiert – z. B. „Bestellung verfolgen" statt „Weiter". # Elemente: Aktionen Aktionen sind Elemente innerhalb eines Blocks, die während des Gesprächsflows automatisch ausgeführt werden. Sie steuern keine Ausgaben an den Nutzer, sondern wirken im Hintergrund. #### Konversation als ungelesen markieren Markiert die aktuelle Konversation in der Inbox als ungelesen. Es sind keine weiteren Einstellungen notwendig. **Typischer Anwendungsfall:** Die Konversation soll nach dem space.vars.TERM\_AI\_AGENTen-Durchlauf für einen Agenten sichtbar als „neu" markiert werden, damit sie nicht übersehen wird. *** #### Konversation zurückstellen Stellt die aktuelle Konversation für eine definierte Zeitspanne zurück. Gib die gewünschte Zeitspanne in den Feldern **Tage**, **Stunden**, **Minuten** und **Sekunden** ein. Während dieser Zeit erscheint sie nicht aktiv in der Inbox. Wenn die eingestellte Zeit zusammen 0 Sekunden beträgt, wird eine bestehende Zurückstellung aufgehoben. **Typischer Anwendungsfall:** Die Konversation soll erst nach einer Wartezeit wieder bearbeitet werden – z. B. nach einem Rückruf oder einer Frist. *** #### Tag hinzufügen Fügt der aktuellen Konversation einen vorhandenen Tag hinzu. Klicke auf **„Tag auswählen"**, um den Tag-Picker zu öffnen, und wähle den gewünschten Tag aus (wie im folgenden Screenshot dargestellt). Tags werden dort farbig angezeigt. **Typischer Anwendungsfall:** Konversationen automatisch kategorisieren, z. B. „Bestellung", „Beschwerde" oder „Rückruf gewünscht". {% hint style="info" %} [Tags](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/tags-und-trigger) müssen vorab im System angelegt worden sein. {% endhint %} *** #### Tag entfernen Entfernt einen vorhandenen Tag von der aktuellen Konversation. Klicke auf **„Tag auswählen"** und wähle den Tag aus, der entfernt werden soll. **Typischer Anwendungsfall:** Einen temporären Tag entfernen, sobald ein bestimmter Schritt im Flow abgeschlossen wurde – z. B. den Tag „In Bearbeitung" nach Abschluss entfernen. *** #### Variable Wert zuweisen Weist einer [benutzerdefinierten Variable](/epic-ai-platform/epic-ai-platform/ai-agent/build/variablen) einen Wert zu (wie im folgenden Screenshot dargestellt). 1. Klicke auf **„Variable auswählen"**, um den [Variablen-Picker](/epic-ai-platform/epic-ai-platform/ai-agent/build/variablen#variablen-picker) zu öffnen. 2. Wähle die gewünschte Variable aus. 3. Trage im Feld **„Wert"** den Wert ein – entweder als statischen Text oder über den Variablen-Picker als dynamischen Wert aus einer anderen Variable oder Entität. Nur benutzerdefinierte Variablen können manuell befüllt werden. Automatisch befüllte Variablen (z. B. aus den Kategorien Benutzer, Unterhaltung oder Entitäten) können nicht überschrieben werden. **Typischer Anwendungsfall:** Den erkannten Wert einer Entität (z. B. IBAN) dauerhaft in einer benutzerdefinierten Variable speichern, um ihn später im Flow weiterzuverwenden. *** #### Notiz erstellen Erstellt eine interne Notiz zur aktuellen Konversation. Die Notiz ist nur für Agenten in der Inbox sichtbar – nicht für den Nutzer. Gib den gewünschten Notiztext in das Textfeld ein. Variablen können eingefügt werden, um die Notiz dynamisch zu befüllen. **Typischer Anwendungsfall:** Wichtige Informationen aus dem Gesprächsverlauf für den zuständigen Agenten festhalten – z. B. das genannte Anliegen oder eine erkannte Kundennummer. {% hint style="info" %} Achtung: Notizen werden im Debug-Modus nicht angezeigt. Sie sind ausschließlich in der Inbox für Agenten sichtbar. {% endhint %} *** #### Übergabe an Agent (Chat) Übergibt die aktuelle Konversation an einen menschlichen Mitarbeiter. Das zuständige Team wird benachrichtigt und kann die Unterhaltung übernehmen. Es sind keine weiteren Einstellungen notwendig. Nach diesem Element können keine weiteren Elemente im selben Block folgen. Das Element ist nicht verschiebbar und wird immer an letzter Stelle angezeigt. **Typischer Anwendungsfall:** Die Konversation an einen menschlichen Mitarbeiter übergeben, sobald der space.vars.TERM\_AI\_AGENT das Anliegen nicht abschließend klären kann. *** #### Team zuweisen Weist die aktuelle Konversation einem bestimmten Team zu. Klicke auf die Auswahlschaltfläche und wähle das gewünschte Team aus der Liste. Zusätzlich steht die Option **„Zuweisung aufheben"** zur Verfügung, um eine bestehende Zuweisung aufzuheben. **Typischer Anwendungsfall:** Konversationen automatisch an das zuständige Team weiterleiten – z.B. „Support" oder „Vertrieb" – abhängig vom erkannten Anliegen des Nutzers. {% hint style="info" %} Voraussetzung: [Teams](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/teams) müssen vorab im System angelegt worden sein. Diese Funktion kann nur in Verbindung mit Text-Kanälen genutzt werden. {% endhint %} *** #### Mitarbeiter zuweisen Weist die aktuelle Konversation einem bestimmten Mitarbeiter zu. Klicke auf die Auswahlschaltfläche und wähle den gewünschten Mitarbeiter aus der Liste. Folgende Optionen stehen zusätzlich zur Verfügung: * **Zuweisung aufheben** – hebt eine bestehende Zuweisung auf. * **Vorherigem Mitarbeiter zuweisen** – weist die Konversation automatisch dem Mitarbeiter zu, der zuletzt mit dem Nutzer in Kontakt war. **Typischer Anwendungsfall:** VIP-Kunden direkt einem festen Ansprechpartner zuweisen, oder nach einer Übergabe sicherstellen, dass der richtige Mitarbeiter informiert wird. *** ### Best Practices * **Aktionen gezielt kombinieren:** Mehrere Aktionen in einem Block werden der Reihe nach ausgeführt. Kombiniere sie sinnvoll – z. B. zuerst eine Variable setzen, dann ein Team zuweisen und abschließend die Konversation als ungelesen markieren. * **Tags konsequent nutzen:** Ein einheitliches Tag-System macht die Auswertung in der Inbox deutlich einfacher. Lege Tags vorab fest und verwende sie konsistent im gesamten Flow. * **Notizen für Agenten vorausfüllen:** Nutze Variablen in Notizen, damit Agenten beim Öffnen der Konversation sofort alle relevanten Informationen sehen – z.B. das genannte Anliegen oder die erkannte Kundennummer. * **„Vorherigem Mitarbeiter zuweisen" für Wiederkehrende nutzen:** Bei bekannten Nutzern sorgt diese Option dafür, dass der vertraute Ansprechpartner automatisch zugewiesen wird – das verbessert die Beziehungsqualität. # Elemente: Dateien Mit den Datei-Elementen kannst du Medien und Dokumente direkt aus einem Block heraus an den Nutzer senden. Die Kategorie „Dateien" umfasst vier Elemente: Bild, Video, Audio und Dokument. {% hint style="info" %} Die Elemente Bild, Video und Dokument sind ausschließlich mit Textkanälen kompatibel. {% endhint %} ### Datei auswählen Bei allen vier Elementen öffnet sich beim Klick auf die Auswahlschaltfläche derselbe **„Datei auswählen"**-Dialog. Er bietet zwei Tabs: * **Datei aus** [**Mediathek**](/epic-ai-platform/epic-ai-platform/ai-agent/build/mediathek): Wähle eine bereits hochgeladene Datei aus der zentralen Mediathek aus. * **Vom Computer:** Lade eine neue Datei direkt von deinem Gerät hoch. *** ### Elemente im Überblick #### Bild senden Sendet ein Bild an den Nutzer. Klicke auf die Auswahlschaltfläche, um den Datei-Dialog zu öffnen, und wähle das gewünschte Bild aus der Mediathek aus oder lade es vom Computer hoch. **Typischer Anwendungsfall:** Produktbilder, Anleitungsgrafiken oder visuelle Bestätigungen im Gesprächsverlauf anzeigen – z. B. ein Bild des bestellten Artikels. *** #### Video senden Sendet ein Video an den Nutzer. Klicke auf die Auswahlschaltfläche und wähle das gewünschte Video aus. **Typischer Anwendungsfall:** Erklärvideos oder kurze Anleitungen direkt im Chat teilen – z. B. eine Schritt-für-Schritt-Videoerklärung zur Produktnutzung. *** #### Audio senden Sendet eine Audiodatei an den Nutzer. Klicke auf die Auswahlschaltfläche und wähle die gewünschte Audiodatei aus. **Typischer Anwendungsfall:** Sprachhinweise oder kurze Audioansagen im Chat bereitstellen – z. B. eine aufgezeichnete Begrüßungsnachricht. *** #### Dokument senden Sendet ein Dokument an den Nutzer. Klicke auf die Auswahlschaltfläche und wähle das gewünschte Dokument aus. **Typischer Anwendungsfall:** PDFs wie Rechnungen, AGBs, Produktdatenblätter oder Anleitungen direkt im Gespräch bereitstellen. *** ### Best Practices * **Mediathek nutzen:** Lade häufig verwendete Dateien einmalig in die Mediathek hoch, anstatt sie jedes Mal neu vom Computer hochzuladen. Das spart Zeit und sorgt für konsistente Inhalte im gesamten Flow. * **Dateinamen aussagekräftig benennen:** Verwende in der Mediathek klare Dateinamen, damit du die richtigen Dateien beim Auswählen schnell findest – z. B. `produkthandbuch-v2.pdf` statt `dokument_final_neu.pdf`. * **Dateigröße im Blick behalten:** Große Dateien können die Ladezeit im Chat erhöhen und auf manchen Kanälen Limits überschreiten. Komprimiere Bilder und Videos, bevor du sie hochlädst. * **Kontext vor der Datei liefern:** Kombiniere ein Datei-Element immer mit einer vorausgehenden Textnachricht, die erklärt, was der Nutzer gleich erhält – z. B. „Hier ist dein Produktdatenblatt:" gefolgt vom Dokument-Element. # Elemente: Voice Agent Die Voice-Elemente steuern die Sprachausgabe und den Gesprächsablauf in Voice-Kanälen. Sie sind ausschließlich für Voice Agent-Flows vorgesehen und nicht mit Textkanälen kompatibel. #### Sprachausgabe Das Element „Sprachausgabe" legt fest, was der space.vars.TERM\_VOICE\_AGENT an dieser Stelle im Flow vorliest. Gib den gewünschten Text direkt in das Textfeld ein. Alternativ kannst du den **SSML-Editor** öffnen, um die Sprachausgabe feiner zu steuern. {% hint style="info" %} Hinweis: SSML-Tags haben keine Auswirkung, wenn eine Stimme von 11Labs genutzt wird. {% endhint %} **SSML-Editor** SSML (Speech Synthesis Markup Language) ermöglicht es, die Sprachausgabe präzise anzupassen – zum Beispiel Aussprache, Betonung oder Pausen. Der SSML-Editor bietet dafür vier Hilfswerkzeuge (wie im folgenden Screenshot dargestellt): * **Aussprache** – Legt fest, wie ein bestimmtes Wort ausgesprochen werden soll. Zur Auswahl stehen verschiedene Interpretationstypen: Zahl, Aufzählung, Buchstabieren, Bruch (mathematisch), Zensieren, Einheit, Datum und weitere (wie im folgenden Screenshot dargestellt). Das ausgewählte Wort wird im Editor grün hervorgehoben. * **Betonung** – Passt die Betonung eines Wortes oder Satzes an. * **Pause** – Fügt eine definierte Pause in die Sprachausgabe ein. * **Variable** – Fügt eine Variable in die Sprachausgabe ein, um Inhalte dynamisch vorzulesen. **SSML-Code-Editor (Profi-Feature)** {% hint style="warning" %} Es handelt sich hierbei um eine Funktion für technisch versierte Nutzende. Eingegebener Code sollte zwingend über einen Anruf verifiziert werden, da fehlerhafte SSML-Tags zum Absturz von Anrufen führt. Voice-Tags sind mit dem [AudioCodes-Kanal](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/kanale/audiocodes-kanal) leider nicht kompatibel – es handelt sich hierbei um Plattformeinschränkungen, auf die wir keinen Einfluss nehmen können. {% endhint %} Über den **Code-Editor** lässt sich der zugrundeliegende SSML-Code direkt bearbeiten. Im Code-Editor stehen Tastenkürzel zur Verfügung: `Strg + Leertaste` für Vorschläge, `cmd/strg + S` zum Speichern. Klicke auf **„Änderungen speichern"**, um den SSML-Text zu übernehmen. **Typischer Anwendungsfall:** Eine Telefonnummer soll buchstabenweise vorgelesen werden, oder eine Zahl soll als Ordinalzahl (z.B. „erste", „zweite") ausgesprochen werden. *** #### Gespräch beenden Beendet das aktive Telefonat. Nach diesem Element können keine weiteren Elemente im selben Block folgen. Das Element ist nicht verschiebbar und wird immer an letzter Stelle angezeigt. Optional können **SIP-Header** mitgegeben werden. Klicke auf **„SIP-Header hinzufügen"** und trage Name und Wert ein. SIP-Header ermöglichen es, beim Beenden des Gesprächs zusätzliche technische Informationen an das Telefonsystem zu übergeben. **Typischer Anwendungsfall:** Das Gespräch nach einer abgeschlossenen Interaktion sauber beenden – z. B. nach einer Bestätigung oder einer Weiterleitung, die fehlgeschlagen ist. *** #### Gespräch übertragen Leitet das aktive Telefonat an eine andere Rufnummer weiter. Nach diesem Element können keine weiteren Elemente im selben Block folgen. Das Element ist nicht verschiebbar und wird immer an letzter Stelle angezeigt. Trage im Feld **„Rufnummer zur Weiterleitung"** die Zielrufnummer ein. Die Rufnummer muss im E.164-Format angegeben werden (+49\[…]). Optional können **SIP-Header** mitgegeben werden. Klicke auf **„SIP-Header hinzufügen"** und trage Name und Wert ein. **Typischer Anwendungsfall:** Einen Anrufer nach der Vorqualifizierung durch den space.vars.TERM\_AI\_AGENT direkt an den zuständigen Agenten oder eine Fachabteilung weiterleiten. *** #### Einstellungen ändern Passt bestimmte [Kanaleinstellungen](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/kanale/voice-kanal#konfiguration-und-spracheinstellungen) temporär für die nächste Benutzereingabe an. Die Änderungen gelten ausschließlich für den folgenden Eingabeschritt und werden danach zurückgesetzt. **Typischer Anwendungsfall:** Bei einer komplexen Frage, bei der der Anrufer länger sprechen muss, den Timeout für Spracheingabe einmalig erhöhen, damit der space.vars.TERM\_AI\_AGENT nicht zu früh unterbricht. *** ### Best Practices * **Sprachausgabe natürlich formulieren:** Schreibe Texte so, wie sie gesprochen werden sollen – also ausgeschrieben statt abgekürzt. Statt „Str." besser „Straße", statt „€" besser „Euro". Das vermeidet unerwartete Aussprachen. * **SSML gezielt einsetzen:** Nutze den SSML-Editor nur dort, wo die automatische Aussprache tatsächlich fehlerhaft ist – z. B. bei Telefonnummern, IBANs oder Fachbegriffen. Zu viele SSML-Tags machen den Flow schwerer wartbar. * **Gespräch beenden immer explizit setzen:** Beende space.vars.TERM\_VOICE\_AGENT-Flows immer mit dem Element „Gespräch beenden" oder „Gespräch übertragen". Ein Flow, der ohne Abschlusselement endet, kann zu unerwünschtem Verhalten führen. * **Timeouts bei langen Antworten anpassen:** Wenn Anrufer längere Eingaben machen sollen – z. B. eine Adresse nennen – setze das Element „Einstellungen ändern" direkt vor dem entsprechenden Block und erhöhe den Timeout für Spracheingabe gezielt für diesen Schritt. # Intentionen Der Schritt „Intention" legt fest, welcher Flow bei einer erkannten Nutzerabsicht gestartet wird. ### Wo finde ich den Schritt? Der Schritt „Intention" lässt sich im space.vars.TERM\_FLOW\_BUILDER über **„Schritt hinzufügen"** einfügen. Er ist unter der Kategorie **„Häufig verwendet"** zu finden. *** ### Erklärung – Was genau ist der Schritt „Intention"? Der Schritt „Intention" wartet auf eine Benutzereingabe und prüft, ob diese einer definierten Intention entspricht. Wird die zugeordnete Intention erkannt, startet automatisch der nachfolgende Flow. Jede Intention kann im gesamten space.vars.TERM\_AI\_AGENT **nur einmal** als Einstiegspunkt verwendet werden. Ist eine Intention bereits einem Schritt zugewiesen, steht sie für andere Intentions-Schritte nicht mehr zur Auswahl. Der Schritt hat einen Ausgang: * **Erkannte Intention:** Der nachfolgende Flow wird gestartet. Wird keine Intention erkannt, greift stattdessen der [Fallback](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/flows#der-standard-flow-einstieg-and-fallback). Ist die KI-Einstellung [Generative KI](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/ki-einstellungen) aktiv, wird vor dem Fallback versucht, eine Antwort im Wissen zu finden und auszuspielen. *** ### Verwendung – Intention einem Schritt zuweisen 1. Füge im space.vars.TERM\_FLOW\_BUILDER einen neuen Schritt vom Typ **„Intention"** hinzu. 2. Klicke auf den Schritt, um ihn zu öffnen. Das Bearbeitungspanel erscheint. 3. Klicke auf **„Intention auswählen"** und wähle die gewünschte Intention aus der Liste aus. 4. Bestätige mit **„Ok"**. Der Schritt ist nun mit der gewählten Intention verknüpft. Sobald ein Nutzer eine Eingabe macht, die dieser Intention entspricht, startet der nachfolgende Flow automatisch. {% hint style="info" %} Intentionen, die bereits einem anderen Intentions-Schritt zugewiesen sind, erscheinen nicht mehr in der Auswahlliste. {% endhint %} *** ### Neue Intention direkt erstellen Falls die benötigte Intention noch nicht existiert, kann sie direkt aus dem Schritt heraus angelegt werden. 1. Öffne das Bearbeitungspanel. 2. Klicke auf **„+ Neue Intention erstellen"**. 3. Du wirst zur [Intentionsverwaltung](/epic-ai-platform/epic-ai-platform/ai-agent/build/intentionen) unter `AI Agent → Entwicklung → Intentionen` weitergeleitet. 4. Lege dort die neue Intention an und kehre anschließend zum space.vars.TERM\_FLOW\_BUILDER zurück. *** ### Beispiel **Szenario:** Ein Nutzer möchte den Status seiner Lieferung abfragen. 1. Füge im space.vars.TERM\_FLOW\_BUILDER einen Schritt „Intention" hinzu. 2. Weise dem Schritt die Intention `Sendungsverfolgung` zu. 3. Verbinde den Schritt mit dem Flow, der die Sendungsverfolgung abwickelt. **Ergebnis:** Gibt ein Nutzer nun „Wo ist mein Paket?" oder „Wann kommt meine Lieferung?" ein, erkennt der space.vars.TERM\_AI\_AGENT die Intention `Sendungsverfolgung` und startet automatisch den zugehörigen Flow. # Kontext Der Kontext-Schritt ermöglicht es, Nutzer-Intentionen gezielt innerhalb eines bestimmten Gesprächsabschnitts abzufangen – ohne den gesamten Flow zu unterbrechen. ### Wo finde ich das? Den Kontext-Schritt fügst du direkt im space.vars.TERM\_FLOW\_BUILDER ein: `Flow-Builder → Schritt hinzufügen → Kontext` Er ist unter der Kategorie **„Häufig verwendet"** gelistet. {% hint style="info" %} Die Intentionen selbst werden nicht im space.vars.TERM\_FLOW\_BUILDER verwaltet, sondern separat unter `AI Agent → Entwicklung → Intentionen`. Die Verwaltung von [Intentionen](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/intentionen) ist in einem eigenen Artikel beschrieben. {% endhint %} *** ### Erklärung – Was genau ist der Kontext-Schritt? Wenn eine Intention erkannt wird, springt der space.vars.TERM\_AI\_AGENT normalerweise zum zugehörigen Trigger-Block im Flow – egal, an welcher Stelle im Gespräch sich der Nutzer gerade befindet. Das kann gewünscht sein, in vielen Fällen möchtest du aber steuern, dass eine Intention nur in einem bestimmten Gesprächsabschnitt reagiert. Genau das leistet der Kontext-Schritt: Er überwacht eine oder mehrere Intentionen **lokal**, also nur an der Stelle im Flow, an der er eingebaut ist. Wird eine der hinterlegten Intentionen erkannt, leitet der Kontext-Schritt den Flow gezielt an den passenden Ausgang weiter. Das macht den Kontext-Schritt besonders nützlich, wenn du Intentionen an mehreren Stellen im Flow wiederverwenden oder kontextabhängig unterschiedlich behandeln möchtest. *** ### Verwendung – Was kann man damit machen? #### Intentionen lokal abfangen Platziere einen Kontext-Schritt im Flow, um an dieser Stelle gezielt auf bestimmte Nutzer-Intentionen zu reagieren. Für jede Intention legst du einen eigenen **Ausgang** fest. Dieser Ausgang kann dann mit dem nächsten Schritt im Flow verbunden werden. **Typisches Szenario:** Ein Nutzer befindet sich mitten in einem Buchungsablauf. Du möchtest, dass er jederzeit zur Stornierung wechseln kann – aber nur innerhalb dieses Abschnitts, nicht global im gesamten space.vars.TERM\_AI\_AGENT. **Oder:** Du Möchtest Intentionen wie "Bestätigung" und "Ablehnung" gezielt und isoliert im Flow verwenden. #### Mehrere Intentionen in einem Schritt Du kannst einem Kontext-Schritt mehrere Intentionen hinzufügen. Jede Intention erhält dabei einen eigenen benannten Ausgang, den du separat verbinden kannst. *** ### Verwaltung – Erstellung, Bearbeitung und Löschen #### Kontext-Schritt erstellen 1. Öffne den space.vars.TERM\_FLOW\_BUILDER und navigiere zur Stelle im Flow, an der du den Kontext-Schritt einfügen möchtest. 2. Klicke auf **„Schritt hinzufügen"**. 3. Wähle unter „Häufig verwendet" den Eintrag **„Kontext"** aus. 4. Das Bearbeitungspanel öffnet sich (siehe Screenshot). 5. Vergib einen aussagekräftigen **Namen** für den Schritt. Dieser ist nur intern sichtbar und hilft dir, den Schritt im Flow zu identifizieren. 6. Klicke auf **„Intention hinzufügen"**, um eine Intention zu verknüpfen. 7. Gib im Feld **„Name des Ausgangs"** einen Namen für den Ausgang ein. Über diesen Namen wird der Ausgang später im Flow als Verbindungspunkt angezeigt. 8. Klicke auf **„Intention wählen"**, um aus der Liste der verfügbaren Intentionen zu wählen. 9. Wiederhole die Schritte 6–8, wenn du weitere Intentionen hinzufügen möchtest. 10. Bestätige mit **„Ok"**. #### Kontext-Schritt bearbeiten Klicke im space.vars.TERM\_FLOW\_BUILDER auf den bestehenden Kontext-Schritt, um das Bearbeitungspanel erneut zu öffnen. Du kannst: * Den **Namen** des Schritts ändern. * **Intentionen hinzufügen** oder entfernen. * Den **Namen eines Ausgangs** anpassen. {% hint style="info" %} Eine Änderung des Ausgangsnamens wirkt sich auf bestehende Verbindungen im Flow aus. Prüfe nach der Umbenennung, ob die Verbindungen noch korrekt sind. {% endhint %} #### Kontext-Schritt löschen Du kannst den Kontext-Schritt wie jeden anderen Schritt im space.vars.TERM\_FLOW\_BUILDER löschen. Klicke dazu auf das **Papierkorb-Symbol** im Bearbeitungspanel. {% hint style="info" %} Beim Löschen werden alle Verbindungen, die von den Ausgängen dieses Schritts ausgehen, entfernt. Der nachfolgende Flow kann dadurch unterbrochen werden. Prüfe den Flow nach dem Löschen auf offene oder fehlende Verbindungen. {% endhint %} *** ### Beispiele #### Beispiel: Themenabbruch während eines Buchungsablaufs Ein Nutzer durchläuft einen mehrstufigen Buchungsprozess für ein Hotelzimmer. Du möchtest sicherstellen, dass er jederzeit zur Stornierung oder zu einer allgemeinen Frage wechseln kann – aber nur innerhalb dieses Abschnitts. **Voraussetzung:** Die Intentionen „Stornierung" und „Allgemeine Frage" sind bereits unter `AI Agent → Entwicklung → Intentionen` angelegt. **Schritte:** 1. Füge im Buchungsflow einen Kontext-Schritt ein. 2. Vergib den Namen `Buchung – Kontext`. 3. Füge die Intention **„Stornierung"** hinzu und benenne den Ausgang `→ Stornierung`. 4. Füge die Intention **„Allgemeine Frage"** hinzu und benenne den Ausgang `→ Allgemeine Frage`. 5. Verbinde den Ausgang `→ Stornierung` mit dem Block für den Stornierungsablauf. 6. Verbinde den Ausgang `→ Allgemeine Frage` mit dem Block für allgemeine Auskünfte. Erkennt der space.vars.TERM\_AI\_AGENT nun während des Buchungsprozesses eine dieser Intentionen, wird der Nutzer gezielt weitergeleitet – ohne den gesamten space.vars.TERM\_AI\_AGENT-Flow zu unterbrechen. *** ### Best Practices * **Aussagekräftige Ausgangsnamen vergeben:** Benenne Ausgänge so, dass ihr Zweck auf einen Blick erkennbar ist – z. B. `→ Stornierung` statt `Ausgang 1`. Das erleichtert die Wartung des Flows erheblich. * **Kontext-Schritt gezielt einsetzen:** Nutze den Kontext-Schritt nicht als globalen Ersatz für Intentionen, sondern dort, wo eine Intention nur in einem bestimmten Gesprächsabschnitt relevant ist. Für global gültige Intentionen ist weiterhin der Trigger-Block im Flow die richtige Wahl. * **Intentionen wiederverwenden:** Dieselbe Intention kann in mehreren Kontext-Schritten an verschiedenen Stellen im Flow verwendet werden. So vermeidest du redundante Intentionen und hältst die Intentionen-Verwaltung übersichtlich. # Bedingung Mit einer Bedingung steuerst du den Gesprächsfluss deines AI Agents: Je nachdem, ob eine oder mehrere Regeln zutreffen, wird der AI Agent auf unterschiedliche Pfade weitergeleitet. ### Wo finde ich das? Die Bedingung fügst du direkt im space.vars.TERM\_FLOW\_BUILDER über das Panel **„Schritt hinzufügen"** ein. Navigiere dort zur Kategorie **Flow-Kontrolle** und wähle **Bedingung** aus. *** ### Erklärung – Was genau ist eine Bedingung? Eine Bedingung ist ein Schritt im space.vars.TERM\_FLOW\_BUILDER, der den Flow in zwei Pfade aufteilt: * **Wahr**: Alle definierten Regeln treffen zu. * **Falsch:** Mindestens eine Regel trifft nicht zu. Du definierst die Regeln, indem du jeweils einen **linken Wert**, einen **Operator** und einen **rechten Wert** angibst. Das System prüft zur Laufzeit, ob der Vergleich zutrifft. #### Verfügbare Operatoren
OperatorBedeutung
gleich (==)Linker Wert ist identisch mit rechtem Wert
ungleich (!=)Linker Wert ist nicht identisch mit rechtem Wert
größer als (>)Linker Wert ist größer als rechter Wert
kleiner als (<)Linker Wert ist kleiner als rechter Wert
größer oder gleich (>=)Linker Wert ist größer als oder gleich dem rechten Wert
kleiner oder gleich (<=)Linker Wert ist kleiner als oder gleich dem rechten Wert
enthältLinker Wert enthält den rechten Wert als Teilstring
enthält nichtLinker Wert enthält den rechten Wert nicht
leerLinker Wert ist leer (kein rechter Wert nötig)
nicht leerLinker Wert ist nicht leer (kein rechter Wert nötig)
*** ### Verwendung – Was kann man damit machen? #### Werte vergleichen Als Werte kannst du sowohl **statische Texte** als auch **Variablen** verwenden. Wenn du in ein Wert-Feld klickst, kann der [Variablen-Picker](/epic-ai-platform/epic-ai-platform/ai-agent/build/variablen#variablen-picker) gewählt werden, über den du alle verfügbaren Variablen auswählen kannst. **Beispiele:** * `Angerufene Rufnummer (Konversation)` – `gleich (==)` – `0123456789` → Prüft, ob der space.vars.TERM\_AI\_AGENT über eine bestimmte Rufnummer kontaktiert wurde. * `Anzahl Artikel (Benutzerdefiniert - Konversation)` – `größer als (>)` – `3` → Prüft, ob ein Nutzer mehr als 3 Artikel im Warenkorb hat. * `IBAN (Benutzerdefiniert - Kontakt)` – `nicht leer` → Prüft, ob eine IBAN bereits erfasst wurde. #### UND- und ODER-Verknüpfungen Du kannst mehrere Regeln innerhalb einer Bedingung kombinieren: * **`+ ODER-Bedingung`** : Fügt eine weitere Vergleichszeile **innerhalb derselben Gruppe** hinzu. Der Pfad „Wahr" wird eingeschlagen, wenn **mindestens eine** der Zeilen in der Gruppe zutrifft. * **`+ UND-Gruppe hinzufügen`** : Fügt eine **neue, separate Gruppe** hinzu. Alle Gruppen müssen zutreffen, damit der Pfad „Wahr" eingeschlagen wird. **Beispiel für eine kombinierte Bedingung:** > **Gruppe 1 (ODER)** > > * `Kanal-Typ (Konversation)` – `gleich (==)` – `Telefon` > * `Kanal-Typ (Konversation)` – `gleich (==)` – `WhatsApp` > > **UND** > > **Gruppe 2** > > * `Anzahl Artikel (Benutzerdefiniert - Konversation)` – `größer als (>)` – `0` → Dieser Pfad wird nur eingeschlagen, wenn der Nutzer per Telefon **oder** WhatsApp kontaktiert hat **und** gleichzeitig mindestens ein Artikel im Warenkorb liegt. *** ### Verwaltung – Erstellung und Bearbeitung #### Bedingung erstellen 1. Klicke im space.vars.TERM\_FLOW\_BUILDER auf **„+ Schritt hinzufügen"**. 2. Wähle unter **Flow-Kontrolle** den Eintrag **Bedingung** aus. 3. Die Bedingung wird als neuer Schritt in den Flow eingefügt. 4. Klicke auf den Schritt, um das Bearbeitungspanel zu öffnen. #### Bedingung konfigurieren 1. Vergib im Feld **Name** einen aussagekräftigen Namen (z. B. „Prüfe Kanal-Typ"). 2. Optional: Füge eine **Beschreibung** hinzu. 3. Trage im linken **Wert**-Feld den zu prüfenden Wert ein – oder wähle eine Variable über den Variablen-Picker. 4. Wähle den passenden **Operator** aus der Dropdown-Liste. 5. Trage im rechten **Wert**-Feld den Vergleichswert ein. 6. Füge bei Bedarf weitere Zeilen über **`+ ODER-Bedingung`** oder weitere Gruppen über **`+ UND-Gruppe hinzufügen`** hinzu. 7. Bestätige mit **Ok**. #### Bedingung bearbeiten Klicke auf den Bedingungsschritt im Flow, um das Bearbeitungspanel erneut zu öffnen. Alle Felder können nachträglich angepasst werden. #### Bedingung löschen Klicke im Bearbeitungspanel oben rechts auf das **Papierkorb-Symbol**. **Achtung:** Beim Löschen eines Bedingungsschritts werden die beiden Ausgangspfade (Wahr und Falsch) und deren Verbindungen entfernt. Die daran angeschlossenen Schritte bleiben im Flow erhalten. Prüfe vorher, welche Schritte an den Ausgängen hängen. *** ### Beispiele #### Beispiel: Nutzer nach Kanal unterschiedlich begrüßen Ein space.vars.TERM\_AI\_AGENT soll Telefon-Anrufer anders begrüßen als Nutzer über andere Kanäle. 1. Füge nach dem Einstieg einen Schritt **Bedingung** ein. 2. Benenne ihn z.B. „Prüfe Kanal". 3. Konfiguriere die Regel: * Linker Wert: `Kanal-Typ (Konversation)` (aus Variablen-Picker) * Operator: `gleich (==)` * Rechter Wert: `voice` 4. Bestätige mit **Ok**. 5. Verbinde den Ausgang **Wahr** mit einem Block für die Telefon-Begrüßung. 6. Verbinde den Ausgang **Falsch** mit einem Block für die allgemeine Begrüßung. #### Beispiel: Prüfen, ob eine IBAN bereits erfasst wurde 1. Füge eine Bedingung ein und benenne sie „IBAN vorhanden?". 2. Konfiguriere: * Linker Wert: `IBAN (Benutzerdefiniert - Kontakt)` * Operator: `nicht leer` * Rechter Wert: *(leer lassen)* 3. Verbinde **Wahr** mit dem nächsten Verarbeitungsschritt. 4. Verbinde **Falsch** mit einem Block, der den Nutzer zur Eingabe der IBAN auffordert. *** ### Best Practices * **Sprechende Namen vergeben.** Benenne jede Bedingung so, dass ihr Zweck auf einen Blick erkennbar ist – z. B. „Prüfe Artikelanzahl > 3" statt „Bedingung 1". Das erleichtert die spätere Wartung des Flows erheblich. * **Empfehlung:** Nutze für Vergleiche mit Zahlen den Datentyp „Text" für deine Variablen. Das System erkennt Zahlenwerte automatisch und wendet numerische Operatoren wie `größer als (>)` korrekt an – auch wenn der Wert als Text gespeichert ist (siehe Abschnitt [Best Practices im Artikel Variablen](/epic-ai-platform/epic-ai-platform/ai-agent/build/variablen#best-practices)). * **Beide Ausgänge immer verbinden.** Verbinde grundsätzlich beide Ausgänge (Wahr und Falsch) mit einem Folgeschritt. * **Komplexe Bedingungen schrittweise aufbauen.** Beginne mit der wichtigsten Einzelregel und ergänze ODER- und UND-Gruppen nur bei Bedarf. Zu viele verschachtelte Regeln machen den Flow schwer nachvollziehbar. # Verzögerung Mit diesem kannst du den Ablauf deines AI Agent zeitgesteuert pausieren. So lassen sich z. B. Follow-up-Nachrichten oder Erinnerungen nach einer definierten Wartezeit automatisch auslösen. ### Wo finde ich den Schritt? Den Schritt „Verzögerung" findest du im space.vars.TERM\_FLOW\_BUILDER in der Kategorie **Flow-Kontrolle** auf der rechten Seite. Ziehe den Schritt per Drag-and-Drop in deinen Flow, um ihn hinzuzufügen. *** ### Erklärung – Was ist die Verzögerung? Die Verzögerung ist ein Schritt im space.vars.TERM\_FLOW\_BUILDER, der den weiteren Ablauf eines Flows für eine festgelegte Zeitspanne pausiert. Nach Ablauf der eingestellten Zeit wird der nachfolgende Schritt automatisch ausgeführt. Der Schritt verfügt über **einen Ausgang**. Dieser wird ausgelöst, sobald die konfigurierte Wartezeit abgelaufen ist. Ein oder mehrere andere Schritts können auf den Verzögerungs-Schritt verweisen. #### Zeitkonfiguration Die Wartezeit wird über vier separate Eingabefelder konfiguriert: * **Tage:** Anzahl der Tage * **Stunden:** Anzahl der Stunden * **Minuten:** Anzahl der Minuten * **Sekunden:** Anzahl der Sekunden Die Werte können kombiniert werden. Die Gesamtdauer darf maximal **30 Tage** betragen. Darüber hinaus kannst du dem Schritt einen **Namen** und eine **Beschreibung** geben, um die Übersicht im Flow zu verbessern. #### Verhalten Zusätzlich steht die Option **„Bei geschlossener Konversation abbrechen"** zur Verfügung. Ist sie aktiviert, wird die Ausführung der Verzögerung abgebrochen, wenn die Konversation vorher geschlossen wurde. #### Genauigkeit der Ausführung Die Ausführung der Verzögerung ist **nicht sekundengenau**. Das System prüft in einem Zeitfenster von **15 bis 20 Sekunden**, ob eine Verzögerung abgelaufen ist, und führt sie dann aus. Bei zeitkritischen Abläufen sollte dieser Toleranzbereich eingeplant werden. #### Verhalten während der Wartezeit Während die Verzögerung läuft, kann der Nutzer weiterhin Nachrichten an den space.vars.TERM\_AI\_AGENT senden. Der space.vars.TERM\_AI\_AGENT reagiert in dieser Zeit jedoch **nicht** auf diese Eingaben. Die Verzögerung läuft unabhängig davon weiter und wird nach Ablauf der eingestellten Zeit wie geplant ausgeführt. #### Einschränkung bei space.vars.TERM\_VOICE\_AGENTs Achtung: Der Schritt „Verzögerung" ist **nicht mit synchronen Anrufen im** space.vars.TERM\_VOICE\_AGENT kompatibel. Wird der Schritt in einem space.vars.TERM\_VOICE\_AGENT-Flow verwendet, bricht der Flow ab. Verwende die Verzögerung daher ausschließlich in textbasierten space.vars.TERM\_AI\_AGENT-Flows. *** ### Verwendung – Was kann man mit der Verzögerung machen? #### Follow-up-Nachrichten senden Sende dem Nutzer nach einer definierten Wartezeit eine Folgenachricht. Das eignet sich z. B. für eine Zufriedenheitsumfrage nach einem abgeschlossenen Servicegespräch. Beispiel: Der Nutzer hat ein Anliegen gelöst bekommen. Nach 24 Stunden erhält er automatisch eine Nachricht wie: „Konnten wir dein Anliegen zufriedenstellend klären?" #### Erinnerungen auslösen Erinnere den Nutzer nach einer bestimmten Zeit an offene Aufgaben oder nächste Schritte. Beispiel: Ein Nutzer hat eine Bestellung aufgegeben. Nach 3 Tagen wird automatisch eine Nachricht gesendet: „Deine Bestellung sollte inzwischen bei dir angekommen sein. Ist alles in Ordnung?" #### Zeitgesteuerte Prozesse steuern Nutze die Verzögerung, um Abläufe in einem bestimmten Rhythmus auszuführen, z.B. regelmäßige Status-Updates oder zeitverzögerte Weiterleitungen. *** ### Verzögerung einrichten 1. Öffne den space.vars.TERM\_FLOW\_BUILDER. 2. Ziehe den Schritt **„Verzögerung"** aus der Kategorie **Flow-Kontrolle** auf der rechten Seite in deinen Flow. 3. Klicke auf den eingefügten Schritt, um ihn zu bearbeiten. 4. Vergib optional einen **Namen** und eine **Beschreibung** für den Schritt. 5. Stelle die gewünschte Wartezeit ein, indem du die Felder **Tage**, **Stunden**, **Minuten** und **Sekunden** ausfüllst. 6. Aktiviere bei Bedarf die Option **„Bei geschlossener Konversation abbrechen"**, damit die Verzögerung abgebrochen wird, falls die Konversation zwischenzeitlich geschlossen wurde. 7. Bestätige mit **„Ok"**. 8. Verbinde den Ausgang des Verzögerungs-Schritts mit dem Schritt, der nach Ablauf der Wartezeit ausgeführt werden soll. *** ### Beispiel: Zufriedenheitsumfrage nach 24 Stunden In diesem Beispiel wird dem Nutzer 24 Stunden nach einer abgeschlossenen Konversation automatisch eine Zufriedenheitsumfrage gesendet. 1. Platziere nach dem letzten Schritt deiner Konversation einen **Verzögerungs-Schritt**. 2. Öffne den Schritt und setze das Feld **Stunden** auf `24`. Alle anderen Felder bleiben auf `0`. 3. Vergib den Namen „Wartezeit Zufriedenheitsumfrage". 4. Bestätige mit **„Ok"**. 5. Verbinde den Ausgang des Verzögerungs-Schritts mit einem Nachrichtenblock, der die Umfrage enthält, z. B.: „Konnten wir dein Anliegen zufriedenstellend klären?" Nach Abschluss der Konversation wartet der space.vars.TERM\_AI\_AGENT nun 24 Stunden und sendet anschließend automatisch die Umfrage-Nachricht. *** ### Best Practices * **Aussagekräftigen Namen vergeben:** Gib dem Verzögerungs-Schritt einen eindeutigen Namen (z.B. „Wartezeit Follow-up 3 Tage"), damit der Flow übersichtlich bleibt. * **Toleranzbereich einplanen:** Da die Ausführung in einem Fenster von 15 bis 20 Sekunden geprüft wird, solltest du keine sekundengenaue Ausführung erwarten. Für Anwendungsfälle, bei denen es auf Stunden oder Tage ankommt, ist das in der Regel kein Problem. * **Nicht im** space.vars.TERM\_VOICE\_AGENT **verwenden:** Setze den Verzögerungs-Schritt ausschließlich in textbasierten Flows ein. Im space.vars.TERM\_VOICE\_AGENT führt er zum Abbruch des Flows. * **Nutzerverhalten einkalkulieren:** Bedenke, dass der Nutzer während der Wartezeit Nachrichten senden kann, ohne dass der space.vars.TERM\_AI\_AGENT darauf reagiert. Plane deinen Flow so, dass dieses Verhalten für den Nutzer nicht irritierend wirkt. * **Maximale Dauer beachten:** Die Gesamtdauer einer Verzögerung darf 30 Tage nicht überschreiten. Plane längere Zeiträume gegebenenfalls über mehrere aufeinanderfolgende Verzögerungen. # A/B-Split Der A/B-Split teilt Nutzer zufällig einer von zwei Varianten (A oder B) zu. So lassen sich unterschiedliche Gesprächsverläufe, Nachrichten oder Logiken gezielt testen und vergleichen. ### Wo finde ich den A/B-Split? Den A/B-Split-Schritt fügst du direkt im space.vars.TERM\_FLOW\_BUILDER hinzu: `Flow-Builder → Schritt hinzufügen → Flow-Kontrolle → A/B-Split` Der A/B-Split befindet sich im Panel „Schritt hinzufügen" unter der Kategorie **Flow-Kontrolle**. *** ### Erklärung – Was genau ist der A/B-Split? Der A/B-Split ist ein Flow-Kontroll-Schritt, der den Gesprächsfluss auf zwei Ausgänge – **Ausgang A** und **Ausgang B** – aufteilt. Jeder Nutzer wird beim Durchlaufen des Schritts zufällig einem der beiden Ausgänge zugewiesen. Die Verteilung der Nutzer auf die beiden Ausgänge ist frei konfigurierbar. Die Summe beider Ausgänge muss immer 100 % ergeben (z.B. 50 % / 50 % oder 70 % / 30 %). #### Wiederholter Durchlauf Du kannst festlegen, wie ein Nutzer beim **mehrmaligen Durchlaufen** desselben A/B-Split-Schritts behandelt wird: * **Nutzer an dieselbe Variante weiterleiten:** Der Nutzer wird bei jedem Durchlauf an denselben Ausgang weitergeleitet, dem er beim ersten Durchlauf zugewiesen wurde. Das sorgt für ein konsistentes Erlebnis innerhalb eines Tests. * **Bei jedem Aufruf neu verteilen:** Bei jedem Durchlauf des Schritts wird der Nutzer neu und unabhängig einer Variante zugewiesen. {% hint style="warning" %} Um unendliche Schleifen zu verhindern, ist die Maximale Ausführung innerhalb einer sich wiederholenden Schrittfolge auf 5 begrenzt. {% endhint %} *** ### Verwendung – Was kann man mit dem A/B-Split machen? Der A/B-Split eignet sich überall dort, wo du zwei verschiedene Ansätze miteinander vergleichen möchtest. Typische Anwendungsfälle: * **Nachrichten testen:** Vergleiche zwei unterschiedliche Begrüßungstexte oder Call-to-Actions, um herauszufinden, welcher besser ankommt. * **Gesprächsflüsse vergleichen:** Teste zwei unterschiedliche Dialogstrukturen, z. B. eine kurze vs. eine ausführliche Qualifizierung. * **Angebote oder Inhalte variieren:** Zeige verschiedenen Nutzergruppen unterschiedliche Produktempfehlungen oder Hilfetexte. * **Technische Logiken prüfen:** Leite Nutzer auf unterschiedliche API-Aufrufe oder App-Module, um verschiedene Integrationen zu testen. #### Schritt im Flow einbinden 1. Öffne den space.vars.TERM\_FLOW\_BUILDER und navigiere zu der Stelle im Flow, an der die Aufteilung erfolgen soll. 2. Klicke auf **„Schritt hinzufügen"**. 3. Wähle unter **Flow-Kontrolle** den Eintrag **A/B-Split** aus. 4. Der Schritt wird in den Flow eingefügt und hat zwei Ausgänge: **Ausgang A** und **Ausgang B**. 5. Verbinde jeden Ausgang mit dem jeweils gewünschten nächsten Schritt oder Block im Flow. *** ### Verwaltung – Erstellung, Bearbeitung und Löschen Hinweis: Erstellung und Bearbeitung des A/B-Splits erfolgen direkt im space.vars.TERM\_FLOW\_BUILDER. #### A/B-Split erstellen 1. Klicke im space.vars.TERM\_FLOW\_BUILDER auf **„Schritt hinzufügen"**. 2. Wähle unter **Flow-Kontrolle** den Eintrag **A/B-Split**. 3. Der Schritt wird sofort in den Flow eingefügt und kann anschließend konfiguriert werden. #### A/B-Split bearbeiten Klicke auf den A/B-Split-Schritt im Flow, um das Bearbeitungspanel zu öffnen. Im Bearbeitungspanel kannst du folgende Einstellungen vornehmen: * **Name:** Vergib einen aussagekräftigen Namen für den Schritt, z. B. „Test Begrüßungsnachricht". Der Name hilft dabei, den Schritt im Flow schnell zu identifizieren. * **Beschreibung (optional):** Füge eine kurze Beschreibung hinzu, um den Zweck des Tests zu dokumentieren. * **Ausgang A / Ausgang B:** Lege die prozentuale Verteilung fest. Die Summe beider Werte muss 100 % ergeben. * **Wiederholter Durchlauf:** Wähle, ob Nutzer bei einem erneuten Durchlauf an dieselbe Variante weitergeleitet werden sollen oder jedes Mal neu verteilt werden. Bestätige deine Einstellungen mit **„Ok"**. #### A/B-Split löschen Öffne das Bearbeitungspanel des A/B-Split-Schritts und klicke oben rechts auf das **Papierkorb-Symbol**. {% hint style="info" %} Das Löschen des A/B-Split-Schritts entfernt ihn aus dem Flow. Alle Verbindungen, die von Ausgang A oder Ausgang B zu nachfolgenden Schritten führen, werden dabei getrennt. Überprüfe nach dem Löschen den Flow auf unterbrochene Verbindungen oder Logiklücken. {% endhint %} *** ### Beispiel #### Zwei Begrüßungsvarianten testen Du möchtest testen, ob eine persönliche Begrüßung mit dem Vornamen des Nutzers zu einer höheren Interaktionsrate führt als eine generische Begrüßung. **Ziel:** 50 % der Nutzer erhalten Variante A (generisch), 50 % erhalten Variante B (personalisiert). 1. Füge im space.vars.TERM\_FLOW\_BUILDER nach dem Einstiegs-Block einen **A/B-Split**-Schritt hinzu. 2. Öffne das Bearbeitungspanel und vergib den Namen `Test Begrüßung`. 3. Setze **Ausgang A** auf `50 %` und **Ausgang B** auf `50 %`. 4. Verbinde **Ausgang A** mit einem Block, der folgende Nachricht enthält: `Hallo! Wie kann ich dir helfen?` 5. Verbinde **Ausgang B** mit einem Block, der folgende Nachricht enthält: `Hallo {{Vorname (Benutzer)}}! Wie kann ich dir helfen?` 6. Führe beide Ausgänge anschließend im gemeinsamen Flow zusammen. *** ### Best Practices * **Empfehlung:** Teste immer nur eine Variable gleichzeitig. Wenn du sowohl den Text als auch die Reihenfolge von Schritten gleichzeitig veränderst, lässt sich später nicht mehr feststellen, welche Änderung für einen Unterschied verantwortlich war. * **Empfehlung:** Vergib dem A/B-Split-Schritt einen sprechenden Namen (z.B. `Test CTA-Button` oder `Test Begrüßungstext`). Das erleichtert die Übersicht, besonders wenn mehrere A/B-Tests im selben Flow aktiv sind. * **Empfehlung:** Nutze den Modus **„Nutzer an dieselbe Variante weiterleiten"**, wenn du sicherstellen möchtest, dass Nutzer innerhalb eines Tests konsistent dieselbe Erfahrung machen. Der Modus **„Bei jedem Aufruf neu verteilen"** eignet sich eher für Szenarien, bei denen eine zufällige Verteilung bei jedem Durchlauf gewünscht ist, z. B. zur Variation von Inhalten ohne feste Nutzerzuordnung. * **Empfehlung:** Überprüfe nach einem Test die Ergebnisse und entferne den A/B-Split-Schritt aus dem Flow, sobald eine Variante klar bevorzugt wird. So bleibt der Flow übersichtlich und frei von nicht mehr benötigten Verzweigungen. # Ende Mit dem Ende-Schritt kann ein Flow im Flow Builder beendet und die Konversation optional geschlossen werden. Es gibt die Möglichkeit, zusätzlich einen Wert für statistische Auswertungen mitzugeben. ### Wo finde ich den Schritt? Den Ende-Schritt findest du direkt im space.vars.TERM\_FLOW\_BUILDER: `Flow-Builder → Schritt hinzufügen → Flow-Kontrolle → Ende` Er befindet sich im Panel „Schritt hinzufügen" unter der Kategorie **Flow-Kontrolle**. *** ### Erklärung – Was ist der Ende-Schritt? Der Ende-Schritt ist ein Schritt im space.vars.TERM\_FLOW\_BUILDER, der den Flow an dieser Stelle beendet. Sobald der space.vars.TERM\_AI\_AGENT das Ende erreicht, verlässt er die Konversation. Optional wird die Konversation dabei geschlossen. Ein Flow kann **mehrere Ende-Schritte** enthalten. #### Aufbau des Schritts * **Name:** Gibt dem Schritt einen individuellen Namen, der im space.vars.TERM\_FLOW\_BUILDER sichtbar ist – z. B. `Erfolgreich abgeschlossen: Reklamation`. * **Payload:** Ein einfaches Texteingabefeld. Der eingetragene Wert wird geloggt, sobald der space.vars.TERM\_AI\_AGENT den Schritt erreicht, und steht für spätere Auswertungen in den [Rohdaten](/epic-ai-platform/epic-ai-platform/ai-agent/statistiken/export-and-datenmodell) zur Verfügung. * **Konversation schließen:** Die Option ist standardmäßig aktiviert. * **Aktiviert:** Der Flow wird beendet, die Konversation wird beim Erreichen des Schritts geschlossen. * **Deaktiviert:** Der Flow wird beendet, die Konversation bleibt offen. Der space.vars.TERM\_AI\_AGENT gibt sie frei, ohne sie zu schließen. #### Verhalten bei erneuter Nutzereingabe Sendet ein Nutzer nach Erreichen des Ende-Schritts eine weitere Nachricht, landet diese im [Fallback](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/flows#der-standard-flow-einstieg-and-fallback). Dieses Verhalten gilt kanalübergreifend und sollte beim Flow-Design berücksichtigt werden. #### Kanalspezifisches Verhalten: Voice Der Ende-Schritt schließt die Konversation, beendet das Telefonat jedoch nicht. Zum botseitigen Beenden eines Telefonats nutze bitte das Element [Gespräch beenden](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/block/elemente-voice-agent#gesprach-beenden). Wenn die Checkbox „Konversation schließen" deaktiviert ist, eignet sich der Schritt im Voice-Bereich zum reinen Tracken innerhalb eines Voice-Flows. *** ### Ende-Schritt einrichten 1. Öffne den space.vars.TERM\_FLOW\_BUILDER des gewünschten AI Agents. 2. Öffne das Seiten-Panel **„Schritt hinzufügen"** und wähle in der Kategorie **Flow-Kontrolle** den Eintrag **„Ende"** aus und ziehe ihn auf den Canvas. 3. Klicke auf den eingefügten Schritt, um ihn zu bearbeiten. 4. Vergib einen aussagekräftigen **Namen** (z. B. `Erfolgreich abgeschlossen: Reklamation`). 5. Trage optional einen **Payload**-Wert ein (z. B. `ABSCHLUSS_ERFOLGREICH`). 6. Lege fest, ob die **Konversation geschlossen** werden soll. 7. Bestätige mit **„Ok"**. *** ### Beispiel: Fallback nach Flowende steuern In diesem Beispiel wird sichergestellt, dass Nutzer, die nach Abschluss des Flows erneut schreiben, eine sinnvolle Rückmeldung erhalten. 1. Füge im letzten Block vor dem Ende-Schritt ein Element [Variable Wert zuweisen](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/block/elemente-aktionen#variable-wert-zuweisen) ein. 2. Setze eine benutzerdefinierte Variable – z.B. `flow_beendet (Benutzerdefiniert - Konversation)` auf den Wert `true`. 3. Konfiguriere den Ende-Schritt mit dem Payload `ABSCHLUSS_ERFOLGREICH` und aktivierter Checkbox „Konversation schließen". 4. Navigiere zum **Fallback-Schritt** und füge eine [Bedingung](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/bedingung) ein: Wenn `flow_beendet (Benutzerdefiniert - Konversation)` gleich (==) `true`. 5. Hinterlege für diesen Pfad eine passende Antwort, z. B.: > „Hast du ein neues Anliegen oder möchtest du einen Mitarbeiter kontaktieren?" Der AI Agent gibt Nutzern, die nach Flow-Ende erneut schreiben, nun eine klare Rückmeldung. *** ### Best Practices * **Aussagekräftige Namen vergeben:** Gib jedem Ende-Schritt einen eindeutigen Namen, der den Abschlussgrund beschreibt. Das erleichtert die Orientierung im Flow, besonders wenn mehrere Ende-Schritte vorhanden sind. * **Payload für Auswertungen nutzen:** Vergib sprechende Payload-Werte wie `ABSCHLUSS_ERFOLGREICH`. So lassen sich die Logs später einfach filtern und einzelne Abschlusspfade auswerten. * **Mehrere Ende-Schritte für unterschiedliche Pfade:** Lege für jede mögliche Abschluss-Situation einen eigenen Ende-Schritt an. Das macht den Flow übersichtlicher und ermöglicht granularere Statistiken. * **Fallback-Verhalten einplanen:** Nutzereingaben nach dem Ende-Schritt landen immer im Fallback. Plane diesen Fall bewusst ein – entweder mit einer klaren Rückmeldung oder einer Weiterleitung. * **Voice-Besonderheit beachten:** Im Voice-Kanal beendet der Ende-Schritt die Konversation, aber nicht das Telefonat. Konfiguriere entsprechende Schritte, bevor der Ende-Schritt erreicht wird. Zum reinen Tracken ohne Konversationsabschluss kann die Checkbox „Konversation schließen" deaktivieret werden. # Gen AI – Entitätserkennung Dieser Schritt dient der Identifikation und Normalisierung spezifischer Datenelemente nach einer Benutzereingabe. {% hint style="info" %} *Entitätserkennung* gehört zusammen mit *Prompt ausführen* und *Gespräch führen* zur Gruppe der dynamischen space.vars.TERM\_AI-Schritte. Bei allen space.vars.TERM\_AI-Schritten gilt: space.vars.TERM\_AI-Modelle können Fehler machen. {% endhint %} Der Schritt „Entitätserkennung" ist ein promptgesteuerter space.vars.TERM\_AI-Schritt, der die klassische [Entitätserkennung](/epic-ai-platform/epic-ai-platform/ai-agent/build/entitaten) mit der Flexibilität von Sprachmodellen kombiniert. Er bringt unstrukturierte oder umgangssprachliche Äußerungen – insbesondere bei Spracheingaben – in ein exakt definiertes Zielformat und speichert das Ergebnis in einer benutzerdefinierten Variable. *** ### Aufbau des Schritts Der Schritt ist in verschiedene Bereiche unterteilt, die eine präzise Steuerung der space.vars.TERM\_AI ermöglichen. #### Kern-Komponenten * **Name und Beschreibung:** Interne Bezeichnung zur Organisation im space.vars.TERM\_FLOW\_BUILDER. * **Beispiele:** Bestehend aus Ausgangswerten (Nutzereingaben) und den zugehörigen Ergebnissen. Über die Schaltfläche „Beispiel hinzufügen" können weitere Einträge ergänzt werden. * **Prompt-Eingabe:** Ein [Prompt-Editor](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/ki-einstellungen/prompt-editor) für die Hauptinstruktionen an die space.vars.TERM\_AI. * **Ausgabe-Variable:** [Benutzerdefinierte Variable](/epic-ai-platform/epic-ai-platform/ai-agent/build/variablen), in welcher das Ergebnis gespeichert wird. * [Modelleinstellungen](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/ki-einstellungen/modelleinstellungen) *** ### Funktionsweise und Logik Die space.vars.TERM\_AI-gestützte Entitätserkennung interpretiert ausschließlich die letzte Benutzereingabe. Der Schritt hat keinen Zugriff auf den Gesprächskontext. #### Instruktionen (Prompt) Im Prompt definierst du das Ziel der space.vars.TERM\_AI sowie technische Anforderungen an das Ergebnis. **Beispiel – Erkennung einer Bestellnummer:** „Die Bestellnummer besteht immer aus ‚NR' gefolgt von 4 Ziffern. Sie muss immer mit NR beginnen. Falls nicht, hänge ein NR davor." #### Beispiel-Mapping Anhand der Ausgangswerte und Ergebnisse gibst du der space.vars.TERM\_AI gezielt Beispiele mit, aus denen sie das gewünschte Zielformat lernt. Wird das Ergebnisfeld leer gelassen, setzt das System automatisch einen Slash (`/`) als Zielwert für dieses Beispiel. **Beispiel – Bestellnummer normalisieren:** | Ausgangswert (Nutzereingabe) | Ergebnis | | ---------------------------- | -------- | | NR1354 | NR1354 | | Nummer drei vier fünf zwo | NR3452 | | Nummer zwanzig fünfzehn | NR2015 | | Ja, das ist die NR-1256 | NR1256 | #### Ergebnis-Logik Kann die space.vars.TERM\_AI basierend auf deinem Prompt und den bereitgestellten Beispielen kein Ergebnis ermitteln, bleibt die Ausgabe-Variable leer. #### Nutzung von Variablen Variablen können im Haupt-Prompt verwendet und referenziert werden. Das Setzen und Füllen von Variablen direkt im Prompt ist allerdings nicht möglich. Das Ergebnis wird ausschließlich in der konfigurierten Ausgabe-Variable gespeichert. *** ### Verwendung – Anwendungsfälle #### Normalisierung von Spracheingaben Besonders bei Voice space.vars.TERM\_AI\_AGENTs werden Nummern oft ungleichmäßig diktiert. Die Entitätserkennung kann diese Eingaben normalisieren und in einem einheitlichen Format speichern. **Beispiel:** Ein Nutzer diktiert „Nummer drei vier fünf zwo". Die Entitätserkennung erkennt dies als Bestellnummer und gibt den Wert „NR3452" in die Ausgabe-Variable zurück. #### Validierung und Formatierung von Nutzerdaten Eingaben wie Datumsangaben, IBANs oder Kundennummern lassen sich in ein einheitliches Format bringen, bevor sie an Schnittstellen oder App-Module übergeben werden. #### Klassifizierung einfacher Eingaben Für einfache Zuordnungen – z. B. ob eine Eingabe eine Bestätigung oder Ablehnung enthält – kann die Entitätserkennung als leichtgewichtige Alternative zum Schritt „Prompt ausführen" dienen. *** ### Best Practices * **Beispieldiversität:** Verwende möglichst diverse Beispiele. Die space.vars.TERM\_AI lernt so am effektivsten das Zielformat. Decke verschiedene Schreibweisen, Formate und typische Fehleingaben ab. * **Invalide Ergebnisse abfangen:** Baue nach diesem Schritt eine Bedingung im Flow ein. Prüfe dort gezielt, ob die Ausgabe-Variable leer ist oder einen `/` enthält, um den Nutzer gegebenenfalls um eine erneute Eingabe zu bitten. * **Isolierte Betrachtung beachten:** Da der Schritt keinen Zugriff auf den Gesprächsverlauf hat, stelle sicher, dass die benötigte Information (z. B. die Rechnungsnummer) unmittelbar vor diesem Schritt vom Nutzer abgefragt wurde. * **Testen:** Experimentiere kontinuierlich im Debug-Chat. space.vars.TERM\_AI-Output variiert – robuste Prompts und Beispiele benötigen mehrere Testläufe. # Gen AI – Prompt ausführen Der Schritt „Prompt ausführen" ist ein promptgesteuerter AI-Schritt, der auf die Aufbereitung und Verarbeitung von Informationen ausgelegt ist. {% hint style="info" %} *Prompt ausführen* gehört zusammen mit *Gespräch führen* und *Entitätserkennung* zur Gruppe der dynamischen space.vars.TERM\_AI-Schritte. Bei allen space.vars.TERM\_AI-Schritten gilt: space.vars.TERM\_AI-Modelle können Fehler machen. {% endhint %} Der Schritt „Prompt ausführen" ist ein promptgesteuerter space.vars.TERM\_AI-Schritt, der auf die Aufbereitung und Verarbeitung von Informationen ausgelegt ist. Er eignet sich zum Beispiel für Zusammenfassungen, Klassifizierungen oder Daten-Transformationen. Das Prompt-Ergebnis wird in einer benutzerdefinierten Variable gespeichert. Im Gegensatz zum Schritt [Gespräch führen](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/gen-ai-gesprach-fuhren) ist dieser Baustein nicht auf die interaktive Dialogführung ausgelegt, sondern auf die gezielte Verarbeitung von Daten. *** ### Aufbau des Schritts Der Schritt ist in verschiedene Bereiche unterteilt, die eine präzise Steuerung der space.vars.TERM\_AI ermöglichen. #### Kern-Komponenten * **Name und Beschreibung:** Interne Bezeichnung zur Organisation im space.vars.TERM\_FLOW\_BUILDER. * **Prompt-Eingabe:** Ein [Prompt-Editor](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/ki-einstellungen/prompt-editor) für die Hauptinstruktionen an die space.vars.TERM\_AI. * **Ausgabe-Variable:** [Benutzerdefinierte Variable](/epic-ai-platform/epic-ai-platform/ai-agent/build/variablen), in welcher das Prompt-Ergebnis gespeichert wird. #### Einstellungen Mit den Einstellungen definierst du die Rahmenbedingungen der space.vars.TERM\_AI-Interaktion. * **Gesprächsverlauf als Kontext nutzen** Diese Einstellung legt fest, wie viel vom bisherigen Gesprächsverlauf der space.vars.TERM\_AI als Kontext übergeben wird. Es stehen drei Optionen zur Auswahl: * **Kein Gesprächsverlauf (Standard):** Es wird kein Gesprächsverlauf an die space.vars.TERM\_AI übergeben. Der Prompt arbeitet ausschließlich mit den direkt im Prompt enthaltenen Informationen und Variablen. Diese Option eignet sich für die meisten Anwendungsfälle, bei denen der Prompt unabhängig vom Gesprächsverlauf Daten verarbeiten soll – z. B. bei Daten-Transformationen oder Klassifizierungen auf Basis von Variablenwerten. * **Gesamter Gesprächsverlauf:** Der komplette bisherige Gesprächsverlauf – also alle Benutzereingaben und space.vars.TERM\_AI\_AGENT-Nachrichten – wird der space.vars.TERM\_AI als Kontext übergeben. Verwende diese Option, wenn der Prompt Informationen aus dem gesamten Gespräch benötigt, z. B. für eine Zusammenfassung am Ende eines Dialogs. * **Benutzerdefiniert:** Hier kannst du in einem zusätzlichen Eingabefeld eine konkrete Anzahl an Benutzereingaben festlegen, die als Kontext berücksichtigt werden sollen. Dabei werden auch alle space.vars.TERM\_AI\_AGENT-Nachrichten, die zwischen diesen Benutzereingaben liegen, mit einbezogen. * **Notizen berücksichtigen:** Bezieht interne Notizen in den an die space.vars.TERM\_AI übergebenen Gesprächsverlauf ein. * **Zugriff auf Wissen aktivieren (RAG):** Erlaubt der space.vars.TERM\_AI den Zugriff auf im Bereich „Wissen" hinterlegte Dokumente und Informationen. * **Vergangene Nutzereingaben RAG:** Bestimmt die Anzahl der vergangenen Nutzereingaben, die beim Zugriff auf hinterlegtes [Wissen](/epic-ai-platform/epic-ai-platform/ai-agent/build/wissen) berücksichtigt werden sollen. * [**Wissensgruppen**](/epic-ai-platform/epic-ai-platform/ai-agent/build/wissen#wissensgruppen)**:** Standardmäßig wird Zugriff auf das gesamte hinterlegte Wissen gewährt. Um diesen einzuschränken, können gezielt Wissensgruppen ausgewählt werden. * [**Modelleinstellungen**](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/ki-einstellungen/modelleinstellungen) *** ### Funktionsweise und Logik #### RAG-Suche (Wissenszugriff) Die Suche im hinterlegten Wissen erfolgt automatisiert. Sie kann nicht explizit über den Prompt gestartet oder gelenkt werden. Im Prompt kannst du jedoch festlegen, wie die gefundenen Informationen verarbeitet und wie ausführlich sie ausgegeben werden sollen. #### Nutzung von Variablen Variablen können im Haupt-Prompt verwendet und referenziert werden. Das Setzen und Füllen von Variablen direkt im Prompt ist allerdings nicht möglich. Das Ergebnis des Prompts wird ausschließlich in der konfigurierten Ausgabe-Variable gespeichert. *** ### Verwendung – Anwendungsfälle und Beispiele „Prompt ausführen" wird primär für die Strukturierung unstrukturierter Daten eingesetzt. Im Folgenden findest du die gängigsten Anwendungsfälle mit konkreten Beispielen. #### Zusammenfassungen Komprimiere Dialoge oder Informationen nach einem bestimmten Schema. **Beispiel-Prompt:** „Fasse das Gespräch in zwei bis drei kurzen Sätzen zusammen. Bereite dabei die Informationen wie folgt auf: * Beschreibung: Kurze Beschreibung des Anliegens * Name: Name des Anrufenden * Telefonnummer: Telefonnummer des Anrufenden / {{Telefonnummer (Benutzer)}}" Speichere das Ergebnis in der Variable {{Zusammenfassung}}. #### Klassifizierungen Kategorisiere Nutzeranliegen auf Basis von Freitext (Intent-Bestimmung). **Beispiel-Prompt:** „Bestimme, welchem der drei Anliegen die Anfrage zuzuordnen ist. Zur Auswahl stehen: * Reklamation * Produktfrage * Produktberatung" Speichere das Ergebnis in der Variable {{Anliegen}}. Empfehlung: Setze nach dem Schritt eine [Bedingung](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/bedingung) auf die gefüllte Ausgabe-Variable, um basierend auf dem Klassifizierungsergebnis unterschiedliche Flow-Pfade einzuleiten. #### Daten-Transformation Formatiere Variablenwerte um – zum Beispiel zur Normalisierung von Datumsangaben vor der Übergabe an eine Schnittstelle. **Beispiel-Prompt:** „Du erhältst eine Datumsangabe als Input. Deine Aufgabe ist es, dieses Datum ausschließlich im Format JJJJ-MM-TT auszugeben." Speichere das Ergebnis in der Variable {{Datum\_formatiert}}. {% hint style="success" %} Bringe Daten mit Hilfe von „Prompt ausführen" in ein korrektes Format, bevor sie via Schnittstelle übertragen werden. So stellst du sicher, dass die Daten kompatibel sind. {% endhint %} *** ### Best Practices * **Regeln definieren:** Definiere in allen Anwendungsfällen zusätzliche Regeln für die Aufgabenerfüllung. Je präziser die Anweisungen, desto zuverlässiger das Ergebnis. * **Beispiele mitgeben:** Das Mitgeben diverser Beispiele im Prompt (Few-Shot-Prompting) liefert konsistentere und zuverlässigere Ergebnisse. * **Bedingungen nachschalten:** Setze nach dem Schritt Bedingungen, um auf Basis der gefüllten Ausgabe-Variable unterschiedliche Flow-Pfade einzuleiten – z. B. nach einer Klassifizierung. * **Daten vor Schnittstellenübergabe formatieren:** Nutze „Prompt ausführen" gezielt, um Daten in das richtige Format zu bringen, bevor sie über App-Module oder API-Aufrufe weitergegeben werden. * **Begriffe konsistent verwenden:** Nutze im Prompt immer dieselben Begriffe für dieselben Konzepte. Vermeide Synonyme, die zu Verwirrung führen könnten. * **Testen:** Experimentiere kontinuierlich im Debug-Chat. space.vars.TERM\_AI-Output variiert – robuste Prompts benötigen mehrere Testläufe. # Gen AI – Gespräch führen Der Schritt Gespräch führen ist ein promptgesteuerter AI-Baustein, der dynamische, natürliche Dialoge ermöglicht. {% hint style="info" %} *Gespräch führen* gehört zusammen mit *Prompt ausführen* und *Entitätserkennung* zur Gruppe der dynamischen space.vars.TERM\_AI-Schritte. Bei allen space.vars.TERM\_AI-Schritten gilt: space.vars.TERM\_AI-Modelle können Fehler machen. {% endhint %} Der Schritt „Gespräch führen" ist ein promptgesteuerter space.vars.TERM\_AI-Schritt, der das Führen dynamischer Gespräche ermöglicht. Er eignet sich für komplexe Konversationen mit klaren Zielen – im Gegensatz zu statischen Block-Schritten reagiert er flexibel auf die Nutzereingabe und kann dabei gezielt auf hinterlegtes Wissen sowie den Gesprächskontext zugreifen. *** ### Aufbau des Schritts Der Schritt ist in verschiedene Bereiche unterteilt, die eine präzise Steuerung der space.vars.TERM\_AI ermöglichen. #### Kern-Komponenten * **Name und Beschreibung:** Interne Bezeichnung zur Organisation im space.vars.TERM\_FLOW\_BUILDER. * **Prompt-Eingabe:** Ein [Prompt-Editor](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/ki-einstellungen/prompt-editor) für die Hauptinstruktionen an die space.vars.TERM\_AI. * **Ausgänge:** Bedingungen, die erfüllt sein müssen, damit der space.vars.TERM\_AI\_AGENT den Schritt verlässt. Sie können mit nachfolgenden Schritten verbunden werden, um den Flow fortzusetzen. * *Standard-Ausgang:* Greift automatisch, sobald die maximale Anzahl an Interaktionen erreicht ist. Greift auch, wenn der Schritt eine Ausführungszeit von 10 Sekunden überschreitet. * *Selbstdefinierte Ausgänge:* Ermöglichen das Verlassen des Schritts basierend auf eigener Logik. Jeder Ausgang erhält einen Namen und eine spezifische Ausgangsbedingung (eigener Prompt). * **Tool-Calling:** Ermöglicht der space.vars.TERM\_AI den Aufruf von [Apps](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/apps-appstore#apps-im-flow-builder-verwenden), um während des Gesprächs Aktionen auszuführen. #### Einstellungen Mit den Einstellungen definierst du die Rahmenbedingungen der space.vars.TERM\_AI-Interaktion. * **Verzögerung aktivieren:** Die space.vars.TERM\_AI wartet mit dem Ausspielen der Antwort, um eine natürlichere Interaktion zu simulieren. Dabei wird ein zufälliger Wert zwischen einem festgelegten Minimal- und Maximalwert (in Sekunden) gewählt. * **Gesprächsverlauf als Kontext nutzen** Diese Einstellung legt fest, wie viel vom bisherigen Gesprächsverlauf der space.vars.TERM\_AI als Kontext übergeben wird. Es stehen drei Optionen zur Auswahl: * **Letzte Eingabe (Standard):** Es wird ausschließlich die letzte Benutzereingabe an die space.vars.TERM\_AI übergeben. Nachrichten des space.vars.TERM\_AI\_AGENTs, die zwischen den Benutzereingaben liegen, werden dabei nicht berücksichtigt. Diese Option eignet sich für die meisten Anwendungsfälle, bei denen der Prompt nur auf eine einzelne Eingabe reagieren soll. * **Gesamter Gesprächsverlauf:** Der komplette bisherige Gesprächsverlauf – also alle Benutzereingaben und space.vars.TERM\_AI\_AGENT-Nachrichten – wird der space.vars.TERM\_AI als Kontext übergeben. Verwende diese Option, wenn der Prompt Informationen aus dem gesamten Gespräch benötigt, z. B. für eine Zusammenfassung am Ende eines Dialogs. * **Benutzerdefiniert:** Hier kannst du in einem zusätzlichen Eingabefeld eine konkrete Anzahl an Benutzereingaben festlegen, die als Kontext berücksichtigt werden sollen. Dabei werden auch alle space.vars.TERM\_AI\_AGENT-Nachrichten, die zwischen diesen Benutzereingaben liegen, mit einbezogen. Bei einem Wert von `0` wird kein Gesprächsverlauf übergeben. {% hint style="info" %} Der Unterschied zwischen „Letzte Eingabe (Standard)" und „Benutzerdefiniert" mit dem Wert `1` ist folgender: Bei „Letzte Eingabe" wird nur die reine Benutzereingabe übergeben – ohne Nachrichten des space.vars.TERM\_AI\_AGENTs dazwischen. Bei „Benutzerdefiniert = 1" wird die letzte Benutzereingabe inklusive aller dazwischenliegenden space.vars.TERM\_AI\_AGENT-Nachrichten übergeben. {% endhint %} * **Zugriff auf Wissen aktivieren (RAG):** Erlaubt der space.vars.TERM\_AI den Zugriff auf im Bereich „Wissen" hinterlegte Dokumente und Informationen. * ***Vergangene Nutzereingaben RAG:*** Bestimmt die Anzahl der vergangenen Nutzereingaben, die beim Zugriff auf hinterlegtes [Wissen](/epic-ai-platform/epic-ai-platform/ai-agent/build/wissen) berücksichtigt werden sollen. * [Wissensgruppen](/epic-ai-platform/epic-ai-platform/ai-agent/build/wissen#wissensgruppen): Standardmäßig wird Zugriff auf das gesamte hinterlegte Wissen gewährt. Um diesen einzuschränken, können gezielt Wissensgruppen ausgewählt werden. * **Maximale Nutzereingaben:** Begrenzt, wie oft der Nutzer innerhalb dieses Schritts antworten darf, bevor der Standard-Ausgang gewählt wird. * [**Modelleinstellungen**](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/ki-einstellungen/modelleinstellungen) *** ### Funktionsweise und Logik #### Verhältnis von Haupt-Prompt und Ausgang Der Haupt-Prompt und die Ausgangs-Prompts agieren isoliert voneinander. Das bedeutet: * Der Haupt-Prompt kann einen Ausgang nicht aktiv aufrufen. * Der Ausgangs-Prompt sieht lediglich den bisherigen Gesprächsverlauf und bewertet, ob die Bedingung für einen Ausstieg erfüllt ist. * Ist ein Ausgang nicht mit einem nachfolgenden Schritt verbunden, wird automatisch der [Fallback](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/flows#der-standard-flow-einstieg-and-fallback) getriggert. * Der space.vars.TERM\_AI-Schritt reagiert – auch mit deaktiviertem Gesprächsverlauf – immer auf die letzte Nutzereingabe. {% hint style="info" %} Die space.vars.TERM\_AI antwortet immer zuerst. Ein Ausstieg erfolgt stets nach einer space.vars.TERM\_AI-Antwort, niemals direkt nach einer Nutzereingabe. {% endhint %} #### RAG-Suche (Wissenszugriff) Die Suche im hinterlegten Wissen erfolgt automatisiert. Sie kann nicht explizit über den Prompt gestartet oder gelenkt werden. Im Prompt kannst du jedoch festlegen, wie die gefundenen Informationen verarbeitet und wie ausführlich sie ausgegeben werden sollen. #### Nutzung von Variablen Variablen können im Haupt-Prompt verwendet und referenziert werden. Das Setzen und Füllen von Variablen innerhalb dieses Schritts ist allerdings nicht möglich. *** ### Tool-Calling (App-Anbindung) Tool-Calling ermöglicht der space.vars.TERM\_AI, während des Gesprächs externe Apps aufzurufen und so Aktionen auszuführen – zum Beispiel eine Sendungsverfolgung abfragen oder einen Anruf auslösen. #### Voraussetzung [Apps müssen vorab installiert](broken://pages/LZyImpcwqBz0rZq1Ja53) worden sein. #### Tool hinzufügen 1. Öffne den Schritt „Gespräch führen" im space.vars.TERM\_FLOW\_BUILDER. 2. Klicke im Bereich „Tools" auf **„Tool hinzufügen"**. 3. Wähle im Dropdown **„App Modul auswählen"** das gewünschte Modul aus. 4. Vergib einen **Namen** für das Tool. Dieser Name dient der internen Organisation. 5. Hinterlege im Feld **„Beschreibung, wann dieses Tool genutzt werden soll…"** eine klare Anweisung, wann und unter welchen Bedingungen die space.vars.TERM\_AI das Tool einsetzen soll. #### Funktionsweise Der space.vars.TERM\_AI\_AGENT entscheidet während der Konversation automatisch, ob und wann er das eingebundene Tool aufruft. Die Entscheidung basiert auf der hinterlegten Beschreibung sowie dem Gesprächskontext. Die Verarbeitung der Antworten erfolgt ebenfalls automatisch. {% hint style="info" %} Maximal 5 Tools können in einer Interaktion direkt nacheinander ausgeführt werden. {% endhint %} #### Beispiel: Sendungsverfolgung als Tool Du möchtest, dass der space.vars.TERM\_AI\_AGENT während eines Support-Gesprächs selbstständig den Sendungsstatus abfragt. 1. Füge über „Tool hinzufügen" das App-Modul „Versanddienstleister – Abfrage Sendestatus" hinzu. 2. Vergib den Namen „Sendungsstatus abfragen". 3. Trage als Beschreibung ein: „Nutze dieses Tool, wenn der Kunde nach dem Status seiner Bestellung oder Lieferung fragt und eine Trackingnummer genannt hat." 4. Referenziere das Modul im Haupt-Prompt über den Variablen-Picker, damit die space.vars.TERM\_AI weiß, welches Tool zur Verfügung steht und wann genau es benutzt werden soll. Der space.vars.TERM\_AI\_AGENT erkennt nun im Gespräch automatisch, wann eine Sendungsverfolgung relevant ist, ruft das Tool auf und verarbeitet das Ergebnis in seiner Antwort. *** ### Best Practices und Prompting-Strategien ### Empfohlene Struktur Ein bewährter Haupt-Prompt folgt meist diesem Aufbau. * Rolle: Wer ist die space.vars.TERM\_AI?\ *Beispiel: "Du bist ein erfahrener Support-Mitarbeiter."* * Ziel: Was soll erreicht werden?\ *Beispiel: "Hilf dem Kunden bei der Aufnahme seiner Reklamation."* * Gesprächsregeln: Constraints wie das *One-Turn-Principle* (nur eine Frage/Antwort pro Schritt).\ *Beispiel: "Sieze den Kunden."* * Gesprächsablauf: Definiert den Gesprächsablauf. Dieser kann starr – etwa mit Nummerierungen – oder dynamisch und offen gestaltet werden. * Beispiele: Liefere am Ende oder in den einzelnen Sektionen vielfältige Beispiele anhand derer die space.vars.TERM\_AI Muster für erfolgreiche Gespräche erkennen kann (Few-Shot). #### Tipps für präzise Ausgänge Um sicherzustellen, dass die space.vars.TERM\_AI den Schritt zum richtigen Zeitpunkt verlässt, kannst du verschiedene Strategien verfolgen. **Strategie 1 – Trigger-Satz definieren:** Definiere im Haupt-Prompt einen Trigger-Satz, dessen Vorkommen vom Ausgangs-Prompt überwacht wird. * *Haupt-Prompt:* „Wenn das Problem gelöst ist, sage: ‚Vielen Dank, ich leite Sie nun weiter.'" * *Ausgangs-Prompt:* „Sobald der Gesprächsverlauf ‚Vielen Dank, ich leite Sie nun weiter.' enthält." **Strategie 2 – Bedingungen im Ausgangs-Prompt:** Definiere im Ausgangs-Prompt die genauen Bedingungen, die erfüllt sein müssen. * *Ausgangs-Prompt:* „Prüfe, ob der Nutzer eine Frage zur Sendungsverfolgung hat, deren Aktualisierung länger als 7 Tage zurückliegt, UND ob er bereits seine E-Mail-Adresse genannt hat. Die Bedingung ist nur erfüllt, wenn beide Informationen (Dauer > 7 Tage + E-Mail) im Verlauf enthalten sind." #### Häufige Fallstricke * **Widersprüche:** Vermeide gegensätzliche Anweisungen innerhalb eines Prompts. * **Unschärfe:** Nutze Begriffe konsistent. Wird von einer „Kundennummer" gesprochen, bezeichne diese später nicht als „Identifikationsnummer". * **Testen:** Experimentiere kontinuierlich im [Debug-Chat](/epic-ai-platform/epic-ai-platform/ai-agent/debugging). space.vars.TERM\_AI-Output variiert – robuste Prompts benötigen mehrere Testläufe. * **Experten-Prompts:** Umfasst ein Prompt zu viele verschiedene Themen und Anliegen, kann es empfehlenswert sein, diese auf mehrere Gespräch-führen-Schritte aufzuteilen und diese miteinander zu verbinden.\ Tipp: Nutze für den Übergang einen leeren [Block-Schritt](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/block) mit aktivierter *Benutzereingabe erwartet*. *** #### Weiterführende Ressourcen zum Prompting * [Google Cloud - Chat Prompting Strategies](https://docs.cloud.google.com/vertex-ai/generative-ai/docs/chat/chat-prompts?hl=de) * [Gemini API - Prompting Guide](https://ai.google.dev/gemini-api/docs/prompting-strategies) *** # Flow (Subflow) Ein Flow ist ein untergeordneter Ablauf (Sub-Flow) innerhalb des Flow-Builders. Er ermöglicht es, komplexe oder wiederkehrende Logik in separate, übersichtliche Einheiten auszulagern. ### Wo finde ich das? Einen Flow-Schritt fügst du über folgenden Pfad hinzu: `Flow-Builder → Schritt hinzufügen → Erweiterte Funktionen → Flow` *** ### Erklärung – Was genau ist ein Flow? Ein Flow ist ein eigenständiger Sub-Flow, der als einzelner Schritt im Hauptflow eingebunden wird. Intern besitzt er einen eigenen Canvas mit Bausteinen, Logik und Verbindungen – ähnlich wie der Hauptflow selbst. Jeder Flow besteht aus zwei besonderen Bausteinen: * **Einstieg:** Der Startpunkt des Sub-Flows. Es gibt immer genau einen Einstieg. Hier beginnt die Ausführung, sobald der Flow-Schritt im übergeordneten Flow erreicht wird. * **Ausstieg:** Der Endpunkt des Sub-Flows. Es kann einen oder mehrere [Ausstiege](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/ausstieg) geben. Welcher Ausstieg genommen wird, hängt von den Verbindungen und der Logik innerhalb des Sub-Flows ab. Nach dem Ausstieg wird die Ausführung im übergeordneten Flow nahtlos fortgesetzt. Flows können beliebig tief verschachtelt werden – ein Sub-Flow kann also selbst weitere Flows enthalten. Eine maximale Anzahl an Flows pro space.vars.TERM\_AI\_AGENT gibt es nicht. *** ### Verwendung – Was kann man damit machen? #### Flow in den Hauptflow einbinden Ein Flow-Schritt verhält sich im Hauptflow wie jeder andere Schritt. Er wird über Verbindungspfeile mit den umliegenden Schritten verbunden. Sobald die Konversation den Flow-Schritt erreicht, wechselt die Ausführung in den Sub-Flow und beginnt am **Einstieg**. Nach dem Durchlaufen des Sub-Flows kehrt die Ausführung an den **Ausstieg** zurück und setzt den übergeordneten Flow nahtlos fort. #### Mehrere Ausstiege verwenden Ein Sub-Flow kann mehrere Ausstiege haben. Welcher Ausstieg genommen wird, ergibt sich aus den Verbindungen und der Logik innerhalb des Sub-Flows – z. B. durch Bedingungen, die zu unterschiedlichen Ausstiegspunkten führen. Im übergeordneten Flow erscheinen alle Ausstiege als separate Ausgangspunkte am Flow-Schritt. So lassen sich nach dem Sub-Flow unterschiedliche Pfade weiterführen. #### Sub-Flow öffnen und bearbeiten Um den Inhalt eines Flows zu bearbeiten, öffne den Flow-Schritt im space.vars.TERM\_FLOW\_BUILDER und klicke auf **„Flow öffnen"**. Du gelangst damit in den Canvas des Sub-Flows, wo du Bausteine hinzufügen, verbinden und Ausstiege konfigurieren kannst. {% hint style="info" %} Ausstiege können ausschließlich im Sub-Flow-Canvas bearbeitet und hinzugefügt werden – nicht direkt über das Bearbeitungspanel des Flow-Schritts. {% endhint %} *** ### Verwaltung – Erstellung, Bearbeitung und Löschen #### Flow erstellen 1. Öffne den space.vars.TERM\_FLOW\_BUILDER und navigiere zu der Stelle, an der der Sub-Flow eingefügt werden soll. 2. Klicke auf **„Schritt hinzufügen"**. 3. Wähle unter **Erweiterte Funktionen** den Eintrag **„Flow"** aus. 4. Der Flow-Schritt wird in den Canvas eingefügt. Er enthält standardmäßig bereits einen **Einstieg** und einen **Ausstieg**. 5. Vergib im Bearbeitungspanel einen aussagekräftigen **Namen** und optional eine **Beschreibung**. 6. Klicke auf **„Flow öffnen"**, um den Sub-Flow-Canvas zu öffnen und Inhalte hinzuzufügen. #### Flow bearbeiten * **Umbenennen:** Öffne den Flow-Schritt im space.vars.TERM\_FLOW\_BUILDER und ändere den Namen im Bearbeitungspanel. Die Änderung wirkt sich sofort auf die Anzeige im Canvas aus. * **Inhalt bearbeiten:** Klicke im Bearbeitungspanel auf **„Flow öffnen"**, um in den Sub-Flow-Canvas zu wechseln. Dort kannst du Bausteine hinzufügen, bearbeiten und Ausstiege verwalten. * **Beschreibung anpassen:** Die Beschreibung lässt sich jederzeit im Bearbeitungspanel anpassen. #### Flow löschen Um einen Flow-Schritt zu löschen, öffne das Bearbeitungspanel und klicke auf das **Papierkorb-Symbol**. {% hint style="warning" %} Der Flow und sein gesamter Inhalt werden unwiderruflich gelöscht. Alle Verbindungen zu diesem Schritt im übergeordneten Flow werden dabei ebenfalls entfernt. Überprüfe vorher, ob der Flow noch aktiv im Hauptflow eingebunden ist, und passe die betroffenen Verbindungen anschließend manuell an. {% endhint %} *** ### Beispiel #### Wiederverwendbare Adressabfrage als Sub-Flow Angenommen, an mehreren Stellen im space.vars.TERM\_AI\_AGENT soll die Adresse eines Nutzers abgefragt werden. Anstatt die Abfragelogik in jedem Pfad neu aufzubauen, lässt sie sich einmalig als Sub-Flow definieren und an den benötigten Stellen einbinden. 1. Füge einen neuen Flow-Schritt hinzu (`Flow-Builder → Schritt hinzufügen → Erweiterte Funktionen → Flow`). 2. Benenne den Flow z. B. „Adressabfrage". 3. Klicke auf **„Flow öffnen"**, um den Sub-Flow-Canvas zu öffnen. 4. Baue im Sub-Flow die Abfragelogik auf: Frage Straße, Hausnummer, PLZ und Ort ab und speichere die Werte in entsprechenden Variablen. 5. Verbinde die letzte Aktion mit dem **Ausstieg**-Baustein. 6. Der Flow ist fertig. Binde den Flow-Schritt „Adressabfrage" nun an allen gewünschten Stellen im Hauptflow ein. *** ### Best Practices * **Flows zur Strukturierung einsetzen:** Nutze Flows, um zusammengehörige Logik in eigenständige Einheiten auszulagern. Das macht den Hauptflow übersichtlicher und einfacher zu warten – besonders bei umfangreichen space.vars.TERM\_AI\_AGENTs. * **Aussagekräftige Namen vergeben:** Benenne Flows so, dass ihr Zweck auf einen Blick erkennbar ist – z. B. „Authentifizierung", „IBAN-Abfrage" oder „Produktauswahl". Das erleichtert die Orientierung im space.vars.TERM\_FLOW\_BUILDER erheblich. * **Mehrere Ausstiege gezielt nutzen:** Wenn ein Sub-Flow unterschiedliche Ergebnisse liefern kann, ist es sinnvoll, mehrere Ausstiege zu definieren – z. B. „Erfolgreich" und „Abgebrochen". So lässt sich im übergeordneten Flow direkt auf das Ergebnis des Sub-Flows reagieren. * **Vor dem Löschen prüfen**: Bevor du einen Flow löschst, prüfe, ob er noch aktiv im Hauptflow eingebunden ist. Das Löschen entfernt den Schritt und alle seine Verbindungen – eine Wiederherstellung ist nicht möglich. # Kontakt bearbeiten Mit dem Schritt „Kontakt bearbeiten" kannst du die Daten eines verknüpften Kontakts direkt aus dem Flow heraus aktualisieren oder ergänzen. ### Wo finde ich das? Du findest den Schritt „Kontakt bearbeiten" im space.vars.TERM\_FLOW\_BUILDER unter: `Flow-Builder → Interne Funktionen → Kontakt bearbeiten` Er wird wie jeder andere Schritt innerhalb eines Blocks hinzugefügt. *** ### Erklärung – Was genau ist „Kontakt bearbeiten"? „Kontakt bearbeiten" ist ein Schritt im space.vars.TERM\_FLOW\_BUILDER, mit dem du die gespeicherten Daten eines Kontakts überschreiben oder ergänzen kannst. Der Schritt bezieht sich dabei immer auf den Kontakt, der mit der aktuellen Konversation verknüpft ist. Innerhalb des Schritts stehen dir folgende Felder zur Verfügung: * **Name:** Der vollständige Name des Kontakts. * **Telefonnummer:** Die Telefonnummer des Kontakts. * **E-Mail-Adresse:** Die E-Mail-Adresse des Kontakts. * **Hausnummer:** Die Hausnummer der Adresse. * **Straße:** Der Straßenname. * **Postleitzahl:** Die Postleitzahl. * **Stadt/Ort**: Die Stadt oder der Ort. * **Land**: Das Land des Kontakts. Jedes dieser Felder kann entweder mit einem statischen Wert (z. B. `Eisenacher Str. 12`) oder mit einer Variable (z. B. `Telefonnummer (Kontakt)`) befüllt werden. Auch eine Kombination aus beidem ist möglich. {% hint style="warning" %} Es wird immer der gesamte Kontakt überschrieben. Wenn ein Feld leer gelassen wird, wird der bisherige Wert in diesem Feld im Kontakt gelöscht. Stelle daher sicher, dass du alle Felder befüllst, die erhalten bleiben sollen. {% endhint %} *** ### Verwendung – Was kann man damit machen? **Kontaktdaten aktualisieren**\ Der häufigste Anwendungsfall ist das Aktualisieren von Kontaktdaten während einer laufenden Konversation. Wenn ein Nutzer z. B. eine neue Adresse mitteilt, kannst du diese direkt im verknüpften Kontakt speichern. **Kontaktdaten mit Variablen befüllen**\ Besonders praktisch ist der Schritt in Kombination mit Variablen. Anstatt Werte manuell einzutragen, kannst du automatisch erkannte oder gespeicherte Informationen verwenden. {% hint style="info" %} Nutze Variablen, um die Felder zu befüllen. So stellst du sicher, dass die Daten aus der aktuellen Konversation automatisch übernommen werden und keine manuellen Fehler entstehen. {% endhint %} Beispiel: Du möchtest Telefonnummer und E-Mail-Adresse des Nutzers in den Kontakt übernehmen. Dafür trägst du in die jeweiligen Felder die passenden Variablen ein – z. B. `Telefonnummer (Kontakt)` und `E-Mail-Adresse (Kontakt)`. **Beschreibung hinzufügen**\ Über das Feld „Beschreibung hinzufügen" kannst du eine interne Notiz zum Schritt hinterlegen. Diese Notiz dient der besseren Übersicht im Flow und ist für dich und dein Team sichtbar. ### Schritt hinzufügen – So richtest du „Kontakt bearbeiten" ein 1. Öffne den Block im space.vars.TERM\_FLOW\_BUILDER, in dem du den Kontakt aktualisieren möchtest. 2. Füge einen neuen Schritt hinzu und wähle unter **Interne Funktionen** den Schritt **„Kontakt bearbeiten"** aus. 3. Befülle die gewünschten Felder mit den passenden Werten oder Variablen. * Um eine Variable einzufügen, klicke in das jeweilige Feld und wähle die Variable über den Variablen-Picker aus. * Um einen statischen Wert einzutragen, tippe den Wert direkt in das Feld. 4. Stelle sicher, dass **alle Felder befüllt sind**, deren Werte erhalten bleiben sollen. Leere Felder führen dazu, dass der bisherige Wert im Kontakt gelöscht wird. 5. Klicke auf **„Ok"**, um den Schritt zu speichern. *** ### Beispiel: Adressänderung im Gespräch Ein Nutzer teilt deinem space.vars.TERM\_AI\_AGENT mit, dass sich seine Adresse geändert hat. Der space.vars.TERM\_AI\_AGENT erfragt die neue Adresse und speichert sie im Kontakt. **Szenario:** Der Nutzer nennt seine neue Straße und Hausnummer. Diese Werte wurden zuvor über eine Benutzereingabe erfasst und in benutzerdefinierten Variablen gespeichert. 1. Erstelle im space.vars.TERM\_FLOW\_BUILDER einen Block, der nach der Adresseingabe des Nutzers ausgelöst wird. 2. Füge den Schritt **„Kontakt bearbeiten"** hinzu. 3. Trage in die Felder die passenden Werte ein: * **Name:** `Name (Kontakt)` – damit der bestehende Name erhalten bleibt. * **Telefonnummer:** `Telefonnummer (Kontakt)` – damit die bestehende Nummer erhalten bleibt. * **E-Mail-Adresse:** `E-Mail-Adresse (Kontakt)` – damit die bestehende Adresse erhalten bleibt. * **Straße:** `Neue Straße (Benutzerdefiniert - Kontakt)` – die vom Nutzer genannte neue Straße. * **Hausnummer:** `Neue Hausnummer (Benutzerdefiniert - Kontakt)` – die vom Nutzer genannte neue Hausnummer. * **Postleitzahl:** `Neue PLZ (Benutzerdefiniert - Kontakt)` – die neue Postleitzahl. * **Stadt/Ort:** `Neuer Ort (Benutzerdefiniert - Kontakt)` – der neue Wohnort. * **Land:** `Land (Benutzerdefiniert - Kontakt)` – das Land des Nutzers. 4. Bestätige mit **„Ok"**. **Achtung:** Vergiss nicht, auch die Felder zu befüllen, die sich nicht geändert haben (z. B. Name und Telefonnummer). Da der gesamte Kontakt überschrieben wird, würden diese Werte sonst gelöscht. *** ### Best Practices * **Alle Felder befüllen:** Da der gesamte Kontakt bei jedem Schritt überschrieben wird, solltest du immer alle Felder befüllen – auch jene, die sich nicht ändern. Nutze dafür die bestehenden Variablen aus der Kategorie „Kontakt" (z. B. `Name (Kontakt)`, `Telefonnummer (Kontakt)`), um die aktuellen Werte beizubehalten. * **Variablen statt statischer Werte verwenden:** Statische Werte eignen sich nur für Felder, die bei jeder Ausführung denselben Wert haben sollen (z. B. ein fester Länderwert wie „Deutschland"). Für alle dynamischen Daten solltest du Variablen nutzen. * **Beschreibung nutzen:** Hinterlege eine kurze Beschreibung im Schritt, damit du und dein Team auf einen Blick erkennen, welchen Zweck der Schritt im Flow erfüllt – z. B. „Aktualisiert die Adresse nach Umzugsmeldung". * **Flow nach Änderungen testen:** Teste den Flow nach dem Einrichten des Schritts gründlich, um sicherzustellen, dass keine Felder versehentlich leer bleiben und Kontaktdaten ungewollt gelöscht werden. # Ausstieg Ein Ausstieg markiert den Endpunkt eines Sub-Flows. Er gibt an, an welcher Stelle die Ausführung den Sub-Flow verlässt und im übergeordneten Flow fortgesetzt wird. ### Wo finde ich das? Ausstiege sind ausschließlich innerhalb eines Sub-Flow-Canvas verfügbar. Den Menüpunkt siehst du nur, wenn du einen [Sub-Flow ](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/flow-subflow)geöffnet hast: `Flow-Builder → Schritt hinzufügen → Flow-Kontrolle → Ausstieg` {% hint style="info" %} Im übergeordneten Flow wird jeder Ausstieg namentlich als separater Ausgangspunkt am Flow-Schritt angezeigt und kann dort mit dem nächsten Schritt verbunden werden. {% endhint %} *** ### Erklärung – Was genau ist ein Ausstieg? Ein Ausstieg ist ein Baustein, der ausschließlich in Sub-Flows verwendet wird. Er definiert, wo der Sub-Flow endet und die Ausführung an den übergeordneten Flow zurückgegeben wird. Ein Sub-Flow kann mehrere Ausstiege haben. Das ist sinnvoll, wenn der Sub-Flow unterschiedliche Ergebnisse liefern kann – z. B. „Erfolgreich" und „Abgebrochen". Im übergeordneten Flow erscheint jeder Ausstieg als eigener Ausgangspunkt am Flow-Schritt, sodass für jedes Ergebnis ein eigener Folgepfad definiert werden kann. Beim Erstellen eines Flows wird automatisch ein Standard-Ausstieg angelegt. *** ### Verwendung – Was kann man damit machen? #### Ausstieg im Sub-Flow verbinden Ein Ausstieg wird wie jeder andere Baustein im Sub-Flow-Canvas über Verbindungspfeile eingebunden. Der letzte Schritt im Sub-Flow wird mit dem gewünschten Ausstieg verbunden. Gibt es mehrere Ausstiege, wird über die Logik im Sub-Flow – z. B. durch Bedingungen – gesteuert, welcher Ausstieg im jeweiligen Fall erreicht wird. #### Ausstieg im übergeordneten Flow verwenden Sobald ein Ausstieg im Sub-Flow angelegt und benannt ist, erscheint er im übergeordneten Flow als Ausgangspunkt am Flow-Schritt. Dort kann er mit dem nächsten Schritt verbunden werden. So lässt sich direkt auf das Ergebnis des Sub-Flows reagieren: * Ausstieg „Erfolgreich" → weiter zur Bestätigungsnachricht * Ausstieg „Abgebrochen" → weiter zur Fehlerbehandlung *** ### Verwaltung – Erstellung, Bearbeitung und Löschen #### Ausstieg erstellen 1. Öffne den Sub-Flow-Canvas über **„Flow öffnen"** im Bearbeitungspanel des Flow-Schritts. 2. Klicke auf **„Schritt hinzufügen"**. 3. Wähle unter **Flow-Kontrolle** den Eintrag **„Ausstieg"** aus. 4. Vergib im Bearbeitungspanel einen aussagekräftigen **Namen** – z. B. „Erfolgreich" oder „Abgebrochen". 5. Verbinde den neuen Ausstieg mit dem gewünschten Schritt im Sub-Flow. #### Ausstieg bearbeiten Öffne den Ausstieg-Baustein im Sub-Flow-Canvas. Im Bearbeitungspanel kannst du: * den **Namen** anpassen: Die Änderung wird sofort im übergeordneten Flow übernommen. * eine optionale **Beschreibung** über das Beschreibungsfeld hinzufügen oder anpassen. {% hint style="info" %} Eine Umbenennung wirkt sich direkt auf die Anzeige des Ausgangspunkts am Flow-Schritt im übergeordneten Flow aus. {% endhint %} #### Ausstieg löschen Öffne den Ausstieg-Baustein im Sub-Flow-Canvas und klicke auf das **Papierkorb-Symbol** im Bearbeitungspanel. {% hint style="warning" %} Wird ein Ausstieg gelöscht, entfällt der zugehörige Ausgangspunkt am Flow-Schritt im übergeordneten Flow. Bestehende Verbindungen, die an diesem Ausgangspunkt hingen, werden dabei ebenfalls entfernt. Prüfe vorher, ob der Ausstieg noch aktiv verbunden ist, und passe den übergeordneten Flow anschließend manuell an. {% endhint %} *** ### Beispiel #### Zwei Ausstiege für unterschiedliche Ergebnisse Ein Sub-Flow prüft, ob ein Nutzer eine gültige IBAN eingegeben hat. Je nach Ergebnis soll der Hauptflow unterschiedlich weitergeführt werden. 1. Öffne den Sub-Flow-Canvas. 2. Füge zwei Ausstiege hinzu: einen mit dem Namen „Gültig", einen mit dem Namen „Ungültig". 3. Baue im Sub-Flow eine Bedingung auf, die den erkannten IBAN-Wert prüft. 4. Verbinde den positiven Pfad der Bedingung mit dem Ausstieg „Gültig", den negativen Pfad mit dem Ausstieg „Ungültig". 5. Im übergeordneten Flow erscheinen nun zwei Ausgangspunkte am Flow-Schritt. Verbinde „Gültig" mit der Weiterverarbeitung der IBAN und „Ungültig" mit einer Fehlermeldung an den Nutzer. *** ### Best Practices * **Ausstiege aussagekräftig benennen**: Vergib Namen, die das Ergebnis des Ausstiegs klar beschreiben – z. B. „Erfolgreich", „Abgebrochen" oder „Timeout". Das erleichtert die Arbeit im übergeordneten Flow erheblich, da auf einen Blick erkennbar ist, welcher Ausgangspunkt welches Ergebnis repräsentiert. * **Für jedes relevante Ergebnis einen eigenen Ausstieg anlegen:** Wenn ein Sub-Flow mehrere mögliche Ergebnisse hat, sollte jedes über einen eigenen Ausstieg abgebildet werden. So bleibt die Logik im übergeordneten Flow sauber und nachvollziehbar – anstatt Fallunterscheidungen außerhalb des Sub-Flows zu treffen. * **Vor dem Löschen Verbindungen prüfen**: Bevor du einen Ausstieg löschst, prüfe, ob er im übergeordneten Flow noch verbunden ist. Das Löschen entfernt den Ausgangspunkt und alle dazugehörigen Verbindungen unwiderruflich. # Tag hinzugefügt Der Trigger „Tag hinzugefügt" startet einen Flow automatisch, sobald einer Konversation ein bestimmtes Tag zugewiesen wird. ### Wo finde ich das? Den Trigger findest du im space.vars.TERM\_FLOW\_BUILDER über das seitliche Panel: 1. Öffne einen Flow im space.vars.TERM\_FLOW\_BUILDER. 2. Klicke auf **„Schritt hinzufügen"**, um das Side Panel zu öffnen. 3. Scrolle zum Abschnitt **„Trigger"**. 4. Wähle **„Tag hinzugefügt"** aus. *** ### Erklärung – Was ist der Trigger „Tag hinzugefügt"? Der Trigger **„Tag hinzugefügt"** gehört zur Kategorie der **Flow-Trigger**. Er überwacht Konversationen und löst den zugehörigen Flow aus, sobald ein festgelegtes Tag hinzugefügt wird. Das Tag kann dabei auf zwei Wegen gesetzt werden: * **Automatisch:** Durch Verwendung des Elements [Tag hinzufügen](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/block/elemente-aktionen#tag-hinzufugen) im Flow selbst * **Manuell:** Durch ein Teammitglied direkt in der Inbox Der Trigger reagiert in beiden Fällen gleich: Sobald das definierte Tag einer Konversation zugewiesen wird, startet der Flow mit dem Trigger als Einstiegspunkt. {% hint style="info" %} Pro Trigger kann genau **ein Tag** ausgewählt werden. Außerdem kann jedes Tag innerhalb eines space.vars.TERM\_AI\_AGENTs nur **einmalig** als Trigger verwendet werden – dasselbe Tag kann also nicht in zwei verschiedenen Flows als „Tag hinzugefügt"-Trigger hinterlegt sein. {% endhint %} *** ### Verwendung – Was kann man damit machen? Mit dem Trigger „Tag hinzugefügt" lassen sich Abläufe starten, die [auf das Setzen eines Tags reagieren](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/tags-und-trigger). Typische Anwendungsfälle: * **Automatische Weiterleitung:** Sobald eine Konversation mit dem Tag „Eskalation" versehen wird, startet ein Flow, der die Konversation an ein bestimmtes Team weiterleitet. * **Follow-up-Nachrichten:** Ein Tag wie „Angebot versendet" löst einen Flow aus, der nach einer definierten Wartezeit eine Nachfass-Nachricht verschickt. * **Statusänderungen verarbeiten:** Tags, die manuell in der Inbox gesetzt werden, können genutzt werden, um nachgelagerte Prozesse im Flow anzustoßen – z. B. das Setzen einer Variable oder das Starten eines App-Moduls. *** ### Verwaltung – Erstellung, Bearbeitung und Löschen #### Trigger erstellen 1. Öffne den gewünschten Flow im space.vars.TERM\_FLOW\_BUILDER. 2. Klicke auf **„Schritt hinzufügen"** im Side Panel. 3. Wähle unter **„Trigger"** den Eintrag **„Tag hinzugefügt"** aus. 4. Es öffnet sich das Bearbeitungspanel des Triggers. 5. Vergib einen aussagekräftigen **Namen** für den Trigger, z. B. `Tag: VIP-Kunde gesetzt`. 6. Optional: Füge eine **Beschreibung** hinzu, um den Zweck des Triggers zu dokumentieren. 7. Klicke auf **„Tag auswählen"**, um das gewünschte Tag festzulegen. 8. Es öffnet sich eine Auswahl mit allen verfügbaren Tags. Wähle das passende Tag aus. 9. Bestätige mit **„Ok"**. {% hint style="info" %} Jedes Tag kann pro space.vars.TERM\_AI\_AGENT nur einmalig als „Tag hinzugefügt"-Trigger verwendet werden. Ist ein Tag bereits in einem anderen Flow als Trigger hinterlegt, erscheint es in der Auswahl nicht mehr als Option. {% endhint %} #### Trigger bearbeiten 1. Öffne den Flow, in dem der Trigger hinterlegt ist. 2. Klicke auf den Trigger-Schritt im space.vars.TERM\_FLOW\_BUILDER, um das Bearbeitungspanel zu öffnen. 3. Passe **Name**, **Beschreibung** oder das **Tag** an. 4. Bestätige mit **„Ok"**. #### Trigger löschen 1. Öffne das Bearbeitungspanel des Triggers. 2. Klicke auf das **Papierkorb-Symbol** oben rechts im Bearbeitungspanel. {% hint style="warning" %} Nach dem Löschen des Triggers wird der Flow durch dieses Tag-Ereignis nicht mehr gestartet. Stelle sicher, dass kein laufender Prozess auf diesen Trigger angewiesen ist, bevor du ihn entfernst. {% endhint %} *** ### Beispiel **Szenario:** Konversationen, die manuell mit dem Tag „Rückruf gewünscht" versehen werden, sollen automatisch eine interne Benachrichtigung auslösen. **Voraussetzung:** Das Tag „Rückruf gewünscht" existiert bereits. **Schritte:** 1. Öffne den zuständigen Flow im space.vars.TERM\_FLOW\_BUILDER. 2. Klicke auf **„Schritt hinzufügen"** und wähle unter „Trigger" den Eintrag **„Tag hinzugefügt"** aus. 3. Vergib den Namen `Tag: Rückruf gewünscht`. 4. Klicke auf **„Tag auswählen"** und wähle das Tag **„Rückruf gewünscht"** aus. 5. Bestätige mit **„Ok"**. 6. Füge als nächsten Schritt im Flow eine Aktion hinzu – z.B. eine interne Benachrichtigung an das zuständige Team. **Ergebnis:** Sobald ein Teammitglied in der Inbox einer Konversation das Tag „Rückruf gewünscht" hinzufügt – oder der Flow es automatisch setzt –, wird der Flow gestartet und die interne Benachrichtigung versendet. *** ### Best Practices * Vergib dem Trigger immer einen sprechenden Namen, der das hinterlegte Tag direkt erkennbar macht – z. B. `Tag: Eskalation` statt `Trigger 1`. Das erleichtert die Orientierung im space.vars.TERM\_FLOW\_BUILDER erheblich, besonders bei größeren Flows. * Nutze den optionalen Beschreibungstext, um festzuhalten, warum dieser Trigger existiert und welchen Prozess er anstößt. Das ist besonders hilfreich, wenn mehrere Personen an einem arbeiten. * Plane die Tag-Struktur im space.vars.TERM\_AI\_AGENT sorgfältig, bevor du Trigger anlеgst. Da jedes Tag pro space.vars.TERM\_AI\_AGENT nur einmalig als Trigger verwendet werden kann, sollten Tags, die als Trigger dienen sollen, einen klaren, eindeutigen Zweck haben und nicht für mehrere unterschiedliche Aktionen verwendet werden. * Überprüfe nach dem Löschen eines Triggers, ob andere Teile des Flows noch auf das betreffende Tag reagieren oder es anderweitig verwenden – z.B. in Bedingungen oder Aktionen. # Tag entfernt Der Trigger „Tag entfernt" startet einen Flow automatisch, sobald einer Konversation ein bestimmtes Tag entzogen wird. So kannst du auf das Entfernen eines Tags reagieren. ### Wo finde ich das? Den Trigger findest du im space.vars.TERM\_FLOW\_BUILDER über das seitliche Panel: 1. Öffne einen Flow im space.vars.TERM\_FLOW\_BUILDER. 2. Klicke auf **„Schritt hinzufügen"**, um das Side Panel zu öffnen. 3. Scrolle zum Abschnitt **„Trigger"**. 4. Wähle **„Tag entfernt"** aus. *** ### Erklärung – Was ist der Trigger „Tag entfernt"? Der Trigger **„Tag entfernt"** gehört zur Kategorie der **Flow-Trigger**. Er überwacht Konversationen und löst den zugehörigen Flow aus, sobald ein festgelegtes Tag entfernt wird. Das Tag kann dabei auf zwei Wegen entfernt werden: * **Automatisch:** Durch Verwendung des Elements [Tag entfernen](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/block/elemente-aktionen#tag-entfernen) im Flow selbst * **Manuell:** Durch ein Teammitglied direkt in der Inbox Der Trigger reagiert in beiden Fällen gleich: Sobald das definierte Tag einer Konversation entzogen wird, startet der Flow mit dem Trigger als Einstiegspunkt. {% hint style="info" %} Pro Trigger kann genau **ein Tag** ausgewählt werden. Jedes Tag kann innerhalb eines space.vars.TERM\_AI\_AGENTs nur **einmalig** als „Tag entfernt"-Trigger verwendet werden – dasselbe Tag kann also nicht in zwei verschiedenen Flows als „Tag entfernt"-Trigger hinterlegt sein. {% endhint %} *** ### Verwendung – Was kann man damit machen? Mit dem Trigger „Tag entfernt" lassen sich Abläufe starten, die auf das Entfernen eines Tags reagieren. Typische Anwendungsfälle: * **Statuswechsel verarbeiten:** Wird das Tag „In Bearbeitung" von einer Konversation entfernt, kann ein Flow gestartet werden, der z. B. eine Abschluss-Nachricht an den Nutzer sendet. * **Eskalation beenden:** Sobald das Tag „Eskalation" entfernt wird, startet ein Flow, der das zuständige Team über die Lösung informiert. * **Variablen zurücksetzen:** Das Entfernen eines Tags kann genutzt werden, um benutzerdefinierte Variablen zurückzusetzen oder einen neuen Prozessabschnitt einzuleiten. *** ### Verwaltung – Erstellung, Bearbeitung und Löschen #### Trigger erstellen 1. Öffne den gewünschten Flow im space.vars.TERM\_FLOW\_BUILDER. 2. Klicke auf **„Schritt hinzufügen"** im Side Panel. 3. Wähle unter **„Trigger"** den Eintrag **„Tag entfernt"** aus. 4. Es öffnet sich das Bearbeitungspanel des Triggers. 5. Vergib einen aussagekräftigen **Namen** für den Trigger, z. B. `Tag entfernt: In Bearbeitung`. 6. Optional: Füge eine **Beschreibung** hinzu, um den Zweck des Triggers zu dokumentieren. 7. Klicke auf **„Tag auswählen"** und wähle das gewünschte Tag aus der Liste aus. Die verfügbaren Tags werden farbig dargestellt. 8. Bestätige mit **„Ok"**. {% hint style="info" %} Jedes Tag kann pro space.vars.TERM\_AI\_AGENT nur einmalig als „Tag entfernt"-Trigger verwendet werden. Ist ein Tag bereits in einem anderen Flow als solcher Trigger hinterlegt, erscheint es in der Auswahl nicht mehr als Option. {% endhint %} #### Trigger bearbeiten 1. Öffne den Flow, in dem der Trigger hinterlegt ist. 2. Klicke auf den Trigger-Schritt im space.vars.TERM\_FLOW\_BUILDER, um das Bearbeitungspanel zu öffnen. 3. Passe **Name**, **Beschreibung** oder das **Tag** an. 4. Bestätige mit **„Ok"**. #### Trigger löschen 1. Öffne das Bearbeitungspanel des Triggers. 2. Klicke auf das **Papierkorb-Symbol** oben rechts im Bearbeitungspanel. {% hint style="warning" %} Nach dem Löschen des Triggers wird der Flow durch dieses Tag-Ereignis nicht mehr gestartet. Stelle sicher, dass kein laufender Prozess auf diesen Trigger angewiesen ist, bevor du ihn entfernst. {% endhint %} *** ### Beispiel **Szenario:** Konversationen, bei denen das Tag „VIP" manuell entfernt wird, sollen automatisch eine interne Notiz erzeugen, die das Team über die Statusänderung informiert. **Voraussetzung:** Das Tag „VIP" existiert bereits. **Schritte:** 1. Öffne den zuständigen Flow im space.vars.TERM\_FLOW\_BUILDER. 2. Klicke auf **„Schritt hinzufügen"** und wähle unter „Trigger" den Eintrag **„Tag entfernt"** aus. 3. Vergib den Namen `Tag entfernt: VIP`. 4. Klicke auf **„Tag auswählen"** und wähle das Tag **„VIP"** aus. 5. Bestätige mit **„Ok"**. 6. Füge als nächsten Schritt im Flow eine Aktion hinzu – z. B. das Erstellen einer internen Notiz mit dem Hinweis, dass der VIP-Status der Konversation aufgehoben wurde. **Ergebnis:** Sobald ein Teammitglied in der Inbox das Tag „VIP" von einer Konversation entfernt – oder der Flow es automatisch entfernt –, wird der Flow gestartet und die interne Notiz erstellt. *** ### Best Practices * Vergib dem Trigger immer einen Namen, der sowohl die Aktion („entfernt") als auch das betreffende Tag klar benennt – z. B. `Tag entfernt: VIP` statt `Trigger 2`. Das erleichtert die Orientierung im space.vars.TERM\_FLOW\_BUILDER, besonders wenn mehrere Tag-Trigger im space.vars.TERM\_AI\_AGENT existieren. * Nutze „Tag entfernt" gezielt als Gegenstück zu „Tag hinzugefügt", um vollständige Prozesszyklen abzubilden – z. B. Prozess starten, wenn ein Tag gesetzt wird, und Prozess abschließen, wenn es wieder entfernt wird. * Nutze den optionalen Beschreibungstext, um festzuhalten, warum dieser Trigger existiert und welchen Prozess er anstößt. Das ist besonders hilfreich, wenn mehrere Personen an einem space.vars.TERM\_AI\_AGENT arbeiten. * Überprüfe nach dem Löschen eines Triggers, ob andere Teile des Flows noch auf das betreffende Tag reagieren oder es anderweitig verwenden – z. B. in Bedingungen oder Aktionen. # Variable geändert Der Trigger „Variable geändert" startet einen Flow automatisch, sobald sich der Wert einer bestimmten Variable ändert. So kannst du direkt auf Wertänderungen in deinem Flow reagieren. ### Wo finde ich das? Den Trigger findest du im space.vars.TERM\_FLOW\_BUILDER über das seitliche Panel: 1. Öffne einen Flow im space.vars.TERM\_FLOW\_BUILDER. 2. Klicke auf **„Schritt hinzufügen"**, um das Side Panel zu öffnen. 3. Scrolle zum Abschnitt **„Trigger"**. 4. Wähle **„Variable geändert"** aus. *** ### Erklärung – Was ist der Trigger „Variable geändert"? Der Trigger **„Variable geändert"** gehört zur Kategorie der **Flow-Trigger**. Er überwacht eine festgelegte Variable und löst den zugehörigen Flow aus, sobald deren Wert aktualisiert wird. Das umschließt jede Art von Wertänderung – ob ein neuer Wert zugewiesen, ein bestehender überschrieben oder ein Wert zurückgesetzt wird. Als Trigger kann jede Variable aus dem [Variablen-Picker](/epic-ai-platform/epic-ai-platform/ai-agent/build/variablen#variablen-picker) ausgewählt werden – unabhängig von der Kategorie. {% hint style="info" %} Pro Trigger kann genau **eine Variable** ausgewählt werden. Jede Variable kann innerhalb eines space.vars.TERM\_AI\_AGENTs nur **einmalig** als „Variable geändert"-Trigger verwendet werden – dieselbe Variable kann also nicht in zwei verschiedenen Flows als solcher Trigger hinterlegt sein. {% endhint %} *** ### Verwendung – Was kann man damit machen? Mit dem Trigger „Variable geändert" lassen sich Abläufe starten, die auf Wertänderungen einer Variable reagieren. Typische Anwendungsfälle: * **Folgeaktionen anstoßen:** Ändert sich z. B. der Wert der Variable `Kundenstatus`, kann ein Flow gestartet werden, der eine entsprechende Nachricht an den Nutzer sendet. * **Daten weiterverarbeiten:** Sobald eine Variable mit einem neuen Wert befüllt wird – z. B. eine erkannte IBAN –, kann ein Flow gestartet werden, der diesen Wert direkt an ein App-Modul übergibt. * **Statuswechsel überwachen:** Ändert sich der Wert einer Statusvariable, kann ein Flow eine interne Benachrichtigung auslösen oder eine Weiterleitung einleiten. *** ### Verwaltung – Erstellung, Bearbeitung und Löschen #### Trigger erstellen 1. Öffne den gewünschten Flow im space.vars.TERM\_FLOW\_BUILDER. 2. Klicke auf **„Schritt hinzufügen"** im Side Panel. 3. Wähle unter **„Trigger"** den Eintrag **„Variable geändert"** aus. 4. Es öffnet sich das Bearbeitungspanel des Triggers. 5. Vergib einen aussagekräftigen **Namen** für den Trigger, z. B. `Variable geändert: Kundenstatus`. 6. Optional: Füge eine **Beschreibung** hinzu, um den Zweck des Triggers zu dokumentieren. 7. Klicke auf **„Variable auswählen"**, um den [Variablen-Picker](/epic-ai-platform/epic-ai-platform/ai-agent/build/variablen#variablen-picker) zu öffnen, und wähle die gewünschte Variable aus. 8. Bestätige mit **„Ok"**. #### Trigger bearbeiten 1. Öffne den Flow, in dem der Trigger hinterlegt ist. 2. Klicke auf den Trigger-Schritt im space.vars.TERM\_FLOW\_BUILDER, um das Bearbeitungspanel zu öffnen. 3. Passe **Name**, **Beschreibung** oder die **Variable** an. 4. Bestätige mit **„Ok"**. #### Trigger löschen 1. Öffne das Bearbeitungspanel des Triggers. 2. Klicke auf das **Papierkorb-Symbol** oben rechts im Bearbeitungspanel. {% hint style="warning" %} Nach dem Löschen des Triggers wird der Flow durch Änderungen dieser Variable nicht mehr gestartet. Stelle sicher, dass kein laufender Prozess auf diesen Trigger angewiesen ist, bevor du ihn entfernst. {% endhint %} *** ### Beispiel **Szenario:** Sobald die Variable `Bestellstatus` auf einen neuen Wert gesetzt wird, soll automatisch eine Statusnachricht an den Nutzer gesendet werden. **Voraussetzung:** Die benutzerdefinierte Variable `Bestellstatus` existiert bereits. **Schritte:** 1. Öffne den zuständigen Flow im space.vars.TERM\_FLOW\_BUILDER. 2. Klicke auf **„Schritt hinzufügen"** und wähle unter „Trigger" den Eintrag **„Variable geändert"** aus. 3. Vergib den Namen `Variable geändert: Bestellstatus`. 4. Klicke auf **„Variable auswählen"** und wähle die Variable `Bestellstatus` aus. 5. Bestätige mit **„Ok"**. 6. Füge als nächsten Schritt im Flow eine Aktion hinzu – z. B. eine Nachricht an den Nutzer mit dem aktuellen Bestellstatus. **Ergebnis:** Sobald der Wert der Variable `Bestellstatus` im Flow aktualisiert wird, startet der Trigger den Flow und die Statusnachricht wird automatisch versendet. *** ### Best Practices * Vergib dem Trigger immer einen Namen, der die überwachte Variable klar benennt – z. B. `Variable geändert: Bestellstatus` statt `Trigger 3`. Das erleichtert die Orientierung im space.vars.TERM\_FLOW\_BUILDER, besonders wenn mehrere Trigger im space.vars.TERM\_AI\_AGENT existieren. * Nutze den optionalen Beschreibungstext, um festzuhalten, warum dieser Trigger existiert und welchen Prozess er anstoßt. Das ist besonders hilfreich, wenn mehrere Personen an einem space.vars.TERM\_AI\_AGENT arbeiten. * Überprüfe nach dem Löschen eines Triggers, ob andere Teile des Flows noch auf die betreffende Variable reagieren oder sie anderweitig verwenden – z. B. in Bedingungen oder Aktionen. # Benutzerdefiniertes Event Der Trigger startet einen Flow, sobald ein externes System ein Event an die Epic AI Platform API sendet. So löst du Flows durch externe Dienste wie Zapier, Make oder eigene API-Integrationen aus. ### Wo finde ich das? Den Trigger findest du im space.vars.TERM\_FLOW\_BUILDER über das seitliche Panel: 1. Öffne einen Flow im space.vars.TERM\_FLOW\_BUILDER. 2. Klicke auf **„Schritt hinzufügen"**, um das Side Panel zu öffnen. 3. Scrolle zum Abschnitt **„Trigger"**. 4. Wähle **„Benutzerdefiniertes Event"** aus. *** ### Erklärung – Was ist der Trigger „Benutzerdefiniertes Event"? Der Trigger **„Benutzerdefiniertes Event"** gehört zur Kategorie der **Flow-Trigger**. Er wartet auf ein Event, das von einem externen System über die space.vars.PRODUCT\_NAME API an eine bestimmte Konversation gesendet wird. Sobald das Event eintrifft und dessen Name exakt mit dem im Trigger hinterlegten Namen übereinstimmt, wird der zugehörige Flow gestartet. Der zugehörige API-Endpunkt lautet: ``` /chatbots/{chatbotId}/conversations/custom-event ``` Typische externe Auslöser sind: * **Zapier** oder **Make:** Zur Verbindung mit anderen Tools und Diensten * **Eigene API-Integrationen:** Beispielsweise aus einem CRM, Shop-System oder Telefonie-Dienst Der im Trigger hinterlegte Event-Name muss **exakt** mit dem Event-Namen übereinstimmen, den das externe System an den Endpunkt sendet – inklusive Groß- und Kleinschreibung. Stimmen die Namen nicht überein, wird der Trigger nicht ausgelöst. {% hint style="info" %} Jeder Event-Name kann innerhalb eines space.vars.TERM\_AI\_AGENTs nur **einmalig** als „Benutzerdefiniertes Event"-Trigger verwendet werden. {% endhint %} *** ### Verwendung – Was kann man damit machen? Mit dem Trigger „Benutzerdefiniertes Event" lassen sich Flows aus externen Systemen heraus starten. Typische Anwendungsfälle: * **Telefonie-Events verarbeiten:** Ein Anruf wird beendet und das externe System sendet das Event `voice_hangup` an die API. Der Trigger startet daraufhin einen Flow, der z. B. eine Zusammenfassung des Gesprächs erstellt oder eine Folge-Nachricht versendet.\ *Hinweis:* Das Event `voice_hangup` ist bei uns integriert und kann ohne Anbindung als Benutzerdefinierter Trigger verwendet werden. * **CRM-Ereignisse einbinden:** Ein CRM-System sendet ein Event, wenn sich der Status eines Kontakts ändert – z. B. `deal_closed` –, und löst damit einen Nachfass-Flow aus. * **Automatisierungen über Zapier oder Make:** Ein externer Dienst sendet bei einem bestimmten Ereignis ein Event an die space.vars.PRODUCT\_NAME und startet so einen definierten Prozess. *** ### Verwaltung – Erstellung, Bearbeitung und Löschen #### Trigger erstellen 1. Öffne den gewünschten Flow im space.vars.TERM\_FLOW\_BUILDER. 2. Klicke auf **„Schritt hinzufügen"** im Side Panel. 3. Wähle unter **„Trigger"** den Eintrag **„Benutzerdefiniertes Event"** aus. 4. Es öffnet sich das Bearbeitungspanel des Triggers. 5. Vergib einen aussagekräftigen **Namen** für den Trigger, z. B. `Event: voice_hangup`. 6. Optional: Füge eine **Beschreibung** hinzu, um den Zweck des Triggers zu dokumentieren. 7. Trage im Feld **„Name des Events"** den exakten Event-Namen ein, den das externe System senden wird – z. B. `voice_hangup`. 8. Bestätige mit **„Ok"**. {% hint style="info" %} Der Event-Name im Feld „Name des Events" muss exakt mit dem Event übereinstimmen, das das externe System an den Endpunkt sendet. {% endhint %} #### Trigger bearbeiten 1. Öffne den Flow, in dem der Trigger hinterlegt ist. 2. Klicke auf den Trigger-Schritt im space.vars.TERM\_FLOW\_BUILDER, um das Bearbeitungspanel zu öffnen. 3. Passe **Name**, **Beschreibung** oder den **Event-Namen** an. 4. Bestätige mit **„Ok"**. #### Trigger löschen 1. Öffne das Bearbeitungspanel des Triggers. 2. Klicke auf das **Papierkorb-Symbol** oben rechts im Bearbeitungspanel. {% hint style="warning" %} Nach dem Löschen des Triggers werden eingehende Events dieses Namens nicht mehr verarbeitet. Stelle sicher, dass das externe System entsprechend angepasst wird, um unnötige API-Aufrufe zu vermeiden. {% endhint %} *** ### Beispiel **Szenario:** Sobald ein Deal in einem externen CRM-System als abgeschlossen markiert wird, soll automatisch eine Glückwunsch-Nachricht an den Nutzer gesendet werden. **Voraussetzung:** Das CRM-System ist so konfiguriert, dass es bei Abschluss eines Deals das Event `deal_closed` an den Endpunkt `/chatbots/{chatbotId}/conversations/custom-event` sendet. **Schritte:** 1. Öffne den zuständigen Flow im space.vars.TERM\_FLOW\_BUILDER. 2. Klicke auf **„Schritt hinzufügen"** und wähle unter „Trigger" den Eintrag **„Benutzerdefiniertes Event"** aus. 3. Vergib den Namen `Event: Deal Closed`. 4. Trage im Feld **„Name des Events"** den Wert `deal_closed` ein. 5. Bestätige mit **„Ok"**. 6. Füge als nächsten Schritt im Flow eine Aktion hinzu – z. B. eine Nachricht an den Nutzer mit einer Bestätigung des erfolgreichen Abschlusses oder einem Hinweis auf die nächsten Schritte. **Ergebnis:** Sobald das CRM-System nach dem Abschluss eines Deals das Event `deal_closed` an die API sendet, wird der Flow gestartet und die Nachricht automatisch versendet. *** ### Best Practices * Wähle Event-Namen, die den auslösenden Vorgang klar beschreiben – z. B. `voice_hangup` oder `deal_closed`. Das erleichtert die Orientierung, wenn mehrere benutzerdefinierte Events im space.vars.TERM\_AI\_AGENT existieren. * Dokumentiere im Beschreibungsfeld des Triggers, welches externe System das Event sendet und unter welchen Bedingungen. So behalten alle Teammitglieder den Überblick, auch wenn sie die externe Integration nicht selbst eingerichtet haben. * Stimme Event-Namen frühzeitig mit den verantwortlichen Personen für die externe Integration ab. Eine nachträgliche Umbenennung erfordert Anpassungen sowohl im Trigger als auch im externen System. * Überprüfe nach dem Löschen oder Umbenennen eines Triggers, ob das externe System weiterhin Events an den Endpunkt sendet – und passe die Integration entsprechend an, um Fehler zu vermeiden. # App-Module Installierte App-Module können direkt im Flow-Builder als eigenständige Schritte eingebunden werden. So lassen sich externe Dienste gezielt an bestimmten Stellen im Flow ausführen. {% hint style="info" %} Voraussetzung: Die [App ist im AI Agent installiert](broken://pages/LZyImpcwqBz0rZq1Ja53) und alle erforderlichen Verbindungen sind eingerichtet und aktiv. {% endhint %} ### Wo finde ich App-Module im space.vars.TERM\_FLOW\_BUILDER? App-Module stehen im space.vars.TERM\_FLOW\_BUILDER als eigener Schritt zur Verfügung. Beim Hinzufügen eines neuen Schritts sind die installierten Apps mit ihren Modulen am Ende der Schritt-Liste aufgeführt – gruppiert nach App-Namen. `Flow-Builder → Schritt hinzufügen → [App-Name] → [Modul]` *** ### App-Modul-Schritt konfigurieren Ein Klick auf ein Modul öffnet das Bearbeitungspanel. Das Bearbeitungspanel zeigt: * **Name:** Vorausgefüllt mit `[App-Name] – [Modulname]`. Du kannst den Namen anpassen, um den Schritt im Flow leichter identifizieren zu können. * **Beschreibung:** Optional. Hier kannst du eine kurze Erläuterung zum Schritt hinterlegen. * **Eingabefelder der Parameter:** Die vom App-Ersteller definierten [Eingabeparameter](/epic-ai-platform/epic-ai-platform/workspace/apps#module) des Moduls erscheinen als eigene Felder. Pflichtfelder müssen ausgefüllt werden, bevor der Schritt ausgeführt werden kann. In die Felder können sowohl statische Werte als auch Variablen über den [Variablen-Picker](/epic-ai-platform/epic-ai-platform/ai-agent/build/variablen#variablen-picker) eingetragen werden. {% hint style="info" %} App-Modulen sollte immer ein weiterer Schritt folgen, da im Anschluss sonst der Fallback greift. {% endhint %} *** ### Ausgaben des Moduls verwenden Nach der Ausführung eines App-Modul-Schritts stehen die Ausgabewerte des Moduls als Variablen im Flow zur Verfügung. Sie sind im Variablen-Picker unter der Kategorie des jeweiligen Moduls auffindbar. Diese Variablen lassen sich im weiteren Verlauf des Flows einsetzen – z. B. in Nachrichten, Bedingungen oder als Eingabe für weitere Module. **Beispiel:** Das Modul `get_random_joke` der App „Chuck Norris" liefert die Ausgabevariablen `Witz` und `ID`. Diese können anschließend in einer Nachricht verwendet werden: > `Der heutige Witz: Witz (Chuck Norris → get_random_joke → Witz)` *** ### App-Module als Tool in „Gespräch führen" App-Module können alternativ auch als Tool im Schritt [Gespräch führen](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/gen-ai-gesprach-fuhren) eingebunden werden. Der AI Agent entscheidet dabei automatisch, ob und wann er ein Modul während der Konversation aufruft. *** ### Hinweise * **Inaktive Verbindung:** Ist die Verbindung einer App nicht eingerichtet oder inaktiv, kann das zugehörige Modul im Flow zwar eingebunden, aber nicht ausgeführt werden. Richte zunächst die Verbindung unter `AI Agent → Einstellungen → App Store` ein. * **Parameter mit Pflichtfeldern:** Enthält ein Modul Pflichtparameter (`required: true`), müssen diese im Bearbeitungspanel zwingend befüllt sein. Andernfalls wird der Schritt nicht korrekt ausgeführt. # Intentionen Intentionen ermöglichen es deinem AI Agent, die Absicht hinter einer Benutzereingabe zu erkennen und automatisch den passenden Flow auszuführen. ### Wo finde ich die Intentionen? Die Verwaltung der Intentionen findest du unter: `Build→ Intentionen` In der Intentionsübersicht siehst du alle vorhandenen Intentionen als Tabelle mit **Name**, **Status** (Verknüpft / Nicht verknüpft), **Flow** und **Änderungsdatum**. Über den Button „Intention erstellen" oben rechts kannst du neue Intentionen anlegen. Über das Suchfeld „Intention suchen…" findest du eine Intention schnell per Namen. Mit den Filter-Tabs **Alle**, **Verknüpft** und **Nicht verknüpft** kannst du die Liste zusätzlich eingrenzen. Das ist praktisch, um z. B. auf einen Blick zu sehen, welche Intentionen noch keinem Flow zugeordnet sind. Ist eine Intention mit einem Flow verknüpft, wird der Flow-Name in der Spalte „Flow" als Link angezeigt; ein Klick öffnet den zugehörigen Schritt im Flow direkt. Im space.vars.TERM\_FLOW\_BUILDER werden [Intentionen als eigene Schritte](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/intentionen) dargestellt und sind dort direkt auswähl- und verknüpfbar. *** ### Erklärung – Was genau sind Intentionen? Intentionen sind vordefinierte oder benutzerdefinierte Absichten, die das Ziel oder Anliegen einer Benutzereingabe beschreiben. Sie ermöglichen es dem AI Agent zu verstehen, *was* ein Nutzer möchte – also die Bedeutung oder Handlung hinter einer Aussage. Jede Intention wird durch mehrere **Ausdrücke** trainiert. Ausdrücke sind Beispieläußerungen, die typische Formulierungen für diese Intention darstellen. Wenn eine neue Benutzereingabe erfolgt, vergleicht der AI Agent diese Eingabe mit allen vorhandenen Ausdrücken und ermittelt per maschinellem Lernen, welche Intention am besten passt. Die Intention mit der höchsten Übereinstimmung wird als erkannte Intention ausgewählt. {% hint style="info" %} Der Schwellenwert für die Erkennung liegt bei 70 %. Nur wenn die berechnete Übereinstimmung diesen Wert überschreitet, wird die Intention als zutreffend erkannt. Dieser Schwellenwert ist fest vorgegeben und kann nicht verändert werden. {% endhint %} *** ### Beispiel **Benutzereingabe:** „Ich möchte einen Router anmelden." Der AI Agent erkennt die Intention *Router-Anmeldung* und startet automatisch den zugehörigen Flow (ab [Intentions-Schritt](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/intentionen)), um die Router-Anmeldung durchzuführen. #### Funktionsweise bei ähnlichen Intentionen Angenommen, ein Nutzer schreibt: „Ich kann mich nicht anmelden, weil mein Konto gesperrt ist." Der AI Agent vergleicht die Eingabe mit allen Trainingsausdrücken und berechnet die Übereinstimmung: * **Konto\_entsperren:** 85 % Übereinstimmung * **Passwort\_zurücksetzen:** 42 % Übereinstimmung Da die Erkennungswahrscheinlichkeit für *Konto\_entsperren* über dem Schwellenwert von 70 % liegt, wird diese Intention als zutreffend erkannt. Der AI Agent startet den zugehörigen Flow – beispielsweise mit der Rückfrage: „Möchten Sie Ihr Konto entsperren?" *** ### Verwendung – Was kann man mit Intentionen machen? Intentionen werden im space.vars.TERM\_FLOW\_BUILDER eingesetzt, um gezielt auf bestimmte Anliegen oder Anfragen von Nutzer:innen zu reagieren. Es gibt zwei Schritttypen, in denen Intentionen verwendet werden: den Schritt [Intention](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/intentionen) und den Schritt [Kontext](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/kontext). #### Schritt „Intention auswählen" Im Schritt „Intention auswählen" legst du fest, auf welche Absicht des Nutzers der AI Agent reagieren soll. Wird eine Benutzereingabe dieser Intention zugeordnet, wird automatisch der dazugehörige Flow durchlaufen. {% hint style="info" %} Eine Intention kann im gesamten space.vars.TERM\_FLOW\_BUILDER nur einmal im Schritt „Intention auswählen" ausgewählt werden. Dadurch wird sichergestellt, dass jede Benutzeranfrage eindeutig einem Flow zugeordnet wird und keine Mehrdeutigkeiten entstehen. {% endhint %} #### Schritt „Kontext" Der Schritt „Kontext" wird innerhalb eines bereits laufenden Flows eingesetzt – beispielsweise direkt nach dem Einstieg oder nachdem eine andere Intention ausgelöst wurde. In diesem Schritt wartet der AI Agent auf eine neue Benutzereingabe und prüft, ob diese einer der im Kontext-Schritt ausgewählten Intentionen zugeordnet werden kann. Je nachdem, welche Intention erkannt wird, verzweigt der Flow automatisch zur entsprechenden Verbindung. So kann der AI Agent flexibel auf unterschiedliche Antworten innerhalb desselben Gesprächs reagieren, ohne den aktuellen Flow zu verlassen. {% hint style="info" %} Wenn eine Intention im Kontext-Schritt erkannt wird, wird *nicht* der eigene Flow der Intention gestartet. Der AI Agent bleibt im aktuellen Flow und folgt der definierten Verbindung. Wenn keine der ausgewählten Intentionen passt, wird der Fallback-Verbindung gefolgt. {% endhint %} *** ### Verwaltung – Erstellen, Bearbeiten und Löschen {% hint style="info" %} Nach dem Erstellen oder Ändern von Intentionen ist ein erneutes Training erforderlich, damit die Änderungen vom AI Agent berücksichtigt werden. {% endhint %} #### Intention erstellen 1. Navigiere zu `BUILD → Intentionen` und klicke auf „Intention erstellen". 2. Vergib im Feld „Name der Intention" einen aussagekräftigen und eindeutigen Namen. Unter diesem Namen ist die Intention später im Schritt „Intention auswählen" verfügbar. Der Name kann bei Bedarf nachträglich angepasst werden. 3. Klicke im Dialog „Intention hinzufügen" auf „Hinzufügen", um die Intention anzulegen. {% hint style="warning" %} Nach dem Erstellen musst du in allen aktivierten Sprachen mindestens eine Beispieläußerung (Ausdruck) hinzufügen. Andernfalls kann dein AI Agent nicht trainiert werden. {% endhint %} 4. **Sprache auswählen**: Über die Sprach-Tabs (mit Flaggen-Symbol, z. B. 🇩🇪 Deutsch, 🇫🇷 Französisch) kannst du die gewünschte Sprache auswählen und Ausdrücke in der jeweiligen Sprache hinzufügen. Es werden jeweils nur die Ausdrücke der aktuell ausgewählten Sprache angezeigt. Der Name der Intention bleibt sprachunabhängig. {% hint style="info" %} Die Sprachen müssen zuvor in den AI-Agent-Einstellungen [im Reiter Sprache](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/sprache) hinzugefügt worden sein. {% endhint %} 5. **Ausdrücke hinzufügen:** Gib im Feld „Neuen Ausdruck hinzufügen" einen Ausdruck ein und bestätige mit Enter. Mit Shift + Enter fügst du den Ausdruck hinzu und lässt ihn automatisch in alle aktivierten Sprachen übersetzen. 6. (optional) Über „✨ Automatisch generieren" öffnest du den Dialog „Phrasen generieren". Dort gibst du unter „Thema" das gewünschte Thema ein (vorbefüllt mit dem Intentionsnamen, aber änderbar) und legst unter „Anzahl" fest, wie viele Phrasen erzeugt werden sollen (Standard: 10). Der Epic AI Copilot erstellt darauf passende Beispiel-Phrasen für die Intention. {% hint style="info" %} Ausdrücke können nicht doppelt hinzugefügt werden – weder innerhalb einer Intention noch über mehrere Intentionen hinweg. Auch Ausdrücke, die bereits einem FAQ-Paar zugeordnet sind, können nicht dupliziert werden. Bei einem Duplikat wird eine Fehlermeldung angezeigt und das Hinzufügen automatisch abgebrochen. {% endhint %} {% hint style="success" %} Füge mindestens 10 verschiedene Ausdrücke pro Intention und Sprache hinzu, damit die Erkennung zuverlässig funktioniert. {% endhint %} 6. Klicke auf **„Speichern"**, um die Intention mit allen Ausdrücken zu sichern. #### Intention bearbeiten Du kannst eine Intention jederzeit bearbeiten, indem du in der Intentionsübersicht auf die gewünschte Intention klickst. Folgende Anpassungen sind möglich: * **Name ändern:** Änderungen werden automatisch in allen Bereichen übernommen, in denen die Intention verwendet wird. * **Ausdrücke hinzufügen oder löschen:** Neue Ausdrücke ergänzen oder bestehende über das Mülltonnensymbol neben dem jeweiligen Ausdruck entfernen. * **Sprachen hinzufügen:** Über das Dropdown-Menü eine weitere Sprache auswählen und entsprechende Ausdrücke hinterlegen. #### Intention löschen Intentionen können über die Intentionsübersicht gelöscht werden. Klicke dazu auf das **Mülltonnensymbol** am rechten Ende der jeweiligen Zeile. {% hint style="warning" %} Beim Löschen einer Intention ist Folgendes zu beachten: * Die Intention wird aus dem Schritt „Intention auswählen" entfernt. Der nachfolgende Flow ist dann nicht mehr erreichbar. * Die Intention wird aus allen Kontext-Schritten entfernt. Die zugehörige Abzweigung ist danach nicht mehr ansteuerbar. * Ausdrücke, die auf diese Intention verweisen, können anschließend nicht mehr zugeordnet werden. {% endhint %} #### Zur Verwendung im space.vars.TERM\_FLOW\_BUILDER navigieren Über die Intentionsübersicht kannst du direkt zum dazugehörigen Intentions-Schritt im Flow Builder navigieren – klicke dazu in der Spalte „Flow" auf den verknüpften Flow-Namen. So findest du Intentionen im Flow schnell, ohne manuell danach suchen zu müssen. *** ### Beispiele #### Beispiel 1: Bestellung aufgeben **Intentionsname:** Bestellung\_aufgeben **Ausdrücke:** * „Ich möchte eine Bestellung aufgeben." * „Bitte bestellen Sie Artikel XY für mich." * „Ich will Produkt ABC kaufen." * „Kann ich das Produkt jetzt bestellen?" * „Ich hätte gerne diese Bestellung." #### Beispiel 2: Sendungsverfolgung **Intentionsname:** Sendungsverfolgung **Ausdrücke:** * „Wann kommt meine Lieferung?" * „Wo ist mein Paket?" * „Lieferstatus von Bestellung 12345." * „Mein Paket ist noch nicht angekommen, wo bleibt es?" * „Können Sie mir sagen, wann die Lieferung ankommt?" #### Beispiel 3: Newsletter abbestellen **Intentionsname:** Newsletter\_abbestellen **Ausdrücke:** * „Ich möchte den Newsletter abbestellen." * „Bitte melden Sie mich vom Newsletter ab." * „Newsletter nicht mehr erhalten." * „Ich möchte keine E-Mails mehr bekommen." * „Abmeldung vom Newsletter bitte." *** ### Best Practices * **Eindeutige und aussagekräftige Namen vergeben:** Der Name sollte den Zweck der Intention klar widerspiegeln, damit die Zuordnung im Flow nachvollziehbar bleibt. Beispiel: *Bestellung\_aufgeben* statt *Bestellung1*. * **Mindestens 10 Ausdrücke pro Intention hinzufügen:** Je mehr unterschiedliche Formulierungen du hinterlegst, desto zuverlässiger wird die Erkennung. Baue Variationen in Schreibweise, Satzlänge und Ausdruck ein, damit der AI Agent auch ungewöhnliche Formulierungen erkennt. * **Inhaltlich ähnliche Intentionen vermeiden:** Stelle sicher, dass sich Intentionen und ihre Ausdrücke nicht zu stark überschneiden. Ähnliche Ausdrücke in unterschiedlichen Intentionen können zu Fehlzuordnungen führen. * **Regelmäßig testen und anpassen:** Prüfe die Intentionserkennung mit realen Benutzereingaben, um die Zuverlässigkeit sicherzustellen. Beachte, dass neue Intentionen oder inhaltlich ähnliche Intentionen die Klassifikation beeinflussen können. * **Verwendung im Flow prüfen, bevor du löschst:** Kontrolliere vor dem Löschen einer Intention, wo sie im Flow eingesetzt wird. So vermeidest du Logikfehler und unerreichbare Flow-Abschnitte. * **Automatische Übersetzung nutzen:** Verwende `Shift` + `Enter` beim Hinzufügen von Ausdrücken, um automatisch Übersetzungen für alle aktivierten Sprachen zu erzeugen. Das spart Zeit und sorgt für konsistente Abdeckung. * Lass dir über „Phrasen generieren" (Thema + Anzahl) automatisch Beispielausdrücke erzeugen, um schneller eine solide Basis an Ausdrücken aufzubauen. # Entitäten Entitäten sind vordefinierte oder benutzerdefinierte Datenelemente, die bestimmte Informationen aus einer Nutzereingabe automatisch extrahieren. ### Wo finde ich Entitäten? `AI Agent → Entwicklung → Entitäten` In der Übersicht sind alle Entitäten mit **Name**, **Typ** (Benutzerdefiniert / Built-In) und **Änderungsdatum** aufgelistet. Über die Filter-Tabs oben rechts ("Alle", "Benutzerdefiniert", "Built-In") kannst du die Liste nach Typ filtern, die Suche findet einzelne Entitäten per Namen. Built-In-Entitäten (z. B. URL, E-Mail, Datum) sind vom System vordefiniert, können aber deaktiviert werden. {% hint style="info" %} Im space.vars.TERM\_FLOW\_BUILDER werden eingefügte Entitäten automatisch blau hervorgehoben und mit `Entitätsname (Entitäten)` gekennzeichnet. {% endhint %} *** ### Erklärung – Was genau sind Entitäten? Eine Entität erkennt automatisch bestimmte Informationen in der Nutzereingabe. Dabei kann eine Entität aus einer oder mehreren **Komponenten** bestehen. Jede Komponente legt fest, nach welcher Methode eine Entität erkannt wird. Außerdem kann für jede Komponente eingestellt werden, ob sie **verpflichtend** oder **optional** ist. **Beispiel:** Nutzer: „Meine IBAN ist DE12345678901234567890"\ → Der space.vars.TERM\_AI\_AGENT erkennt die Entität `IBAN` mit dem Wert „DE12345678901234567890" *** ### Arten von Entitäten-Komponenten #### Reguläre-Ausdrücke-Komponente (Regex) Reguläre Ausdrücke sind Muster, mit denen bestimmte Zeichenfolgen erkannt werden. Sie eignen sich besonders für klar strukturierte Datenformate wie IBAN, Telefonnummern oder Postleitzahlen. Eine Regex-Komponente kann **mehrere Ausdrücke** enthalten. Jeder Ausdruck besteht aus drei Feldern: * **Schlüssel**: interner Bezeichner für den Ausdruck (z. B. zur Unterscheidung mehrerer Varianten innerhalb derselben Entität) * **Sprache**: die Sprache, für die der Ausdruck gilt * **Regulärer Ausdruck**: das eigentliche Muster Über „Ausdruck hinzufügen" lassen sich beliebig viele Muster ergänzen – etwa um dieselbe Entität in mehreren Sprachen oder mit mehreren Schreibweisen zu erkennen. **Beispiel – Kundennummer:** Nutzer: „Meine Kundennummer lautet KD 1234 5678." | Schlüssel | Sprache | Regulärer Ausdruck | | ---------------- | ------- | ------------------------------------ | | kundennummer\_de | Deutsch | `[Kk][Dd][ -]?[0-9]{4}[ -]?[0-9]{4}` | Erklärung: * `[Kk][Dd]` → Präfix „KD" ist zwingend, Groß-/Kleinschreibung wird akzeptiert * `[ -]?` → erlaubt optional ein Leerzeichen oder Bindestrich * `[0-9]{4}` → erwartet genau vier Ziffern Positiv-Beispiele (erkannt): * `KD12345678` * `kd12345678` * `KD 1234 5678` * `kd-1234-5678` Negativ-Beispiele (nicht erkannt): * `KD/1234/5678` → Schrägstriche nicht erlaubt * `K12345678` → Buchstabe „D" aus Präfix fehlt * `KD 12345 678` → falsche Ziffernanzahl {% hint style="info" %} Verwende Online-Tools wie regex101.com, um deinen Regex zu testen. Prüfe immer mit vollständigen Nutzereingaben – nicht nur mit dem isolierten Wert. Bei Voice-Eingaben können Transkriptionen leicht variieren. Plane Toleranz für optionale Leerzeichen oder Bindestriche ein. `KD[ -]?` erkennt z. B. sowohl „KD1234" als auch „KD 1234" und „KD-1234". {% endhint %} #### Prebuilt-Komponente Eine Prebuilt-Komponente ist eine bereits vorhandene, systemseitig definierte Erkennungslogik – z. B. für E-Mail-Adressen oder Prozentangaben. Diese Komponenten müssen nicht manuell konfiguriert werden. Es wird lediglich die gewünschte Prebuilt-Kategorie ausgewählt. #### Listen-Komponente (Synonymlisten) Listen bestehen aus Schlüsselwerten und Synonymen. Dadurch können verschiedene bedeutungsgleiche Begriffe auf dieselbe Entität abgebildet werden. Das ist ideal für begrenzte Wertebereiche wie Marken, Kategorien oder Produktnamen. {% hint style="info" %} Eine Erkennung erfolgt nur bei exakter Übereinstimmung mit einem der definierten Synonyme. Groß- und Kleinschreibung ist dabei relevant. {% endhint %} **Beispiel – Automarke:** Schlüssel: `Volkswagen` | Synonyme: `VW`, `VW Golf`, `VW Polo`, `VAG` Nutzer: „Ich fahre einen VW Polo." → Entität `Automarke` erkannt → Wert: „Volkswagen" Positiv-Beispiele (erkannt): * `VW` → Wert „Volkswagen" * `VW Golf` → Wert „Volkswagen" * `VAG` → Wert „Volkswagen" Negativ-Beispiele (nicht erkannt): * `vw` → Kleinschreibung, Groß-/Kleinschreibung ist relevant * `volkswagen` → nicht als Synonym definiert * `VW-Golf` → Bindestrich nicht als Synonym hinterlegt #### Erlernt-Komponente Die Erlernt-Komponente basiert auf trainierten Beispielen. Das Modell erkennt Entitäten anhand des Kontexts, auch wenn keine exakte Übereinstimmung mit einer Liste oder einem Regex besteht. Als Grundlage dienen markierte Entitäten aus dem Bereich `Optimierung →`[ `Entitäten labeln`](/epic-ai-platform/epic-ai-platform/ai-agent/daten/entitaten-labeln). **Beispiel:** Trainierte Entität: `Ort`\ Nutzer: „Ich möchte morgen nach Berlin reisen."\ → Das Modell erkennt „Berlin" als Ort – ohne explizite Hinterlegung {% hint style="info" %} Die Erlernt-Komponente wird nur definiert, wenn du Äußerungen mit dieser Entität kennzeichnest (labeln). Ohne gelabelte Beispiele hat die Entität keine Erlernt-Komponente. {% endhint %} *** ### Verwendung – Was kann man mit Entitäten machen? Entitäten lassen sich im space.vars.TERM\_FLOW\_BUILDER ähnlich wie Variablen einsetzen. Sie dienen dazu, automatisch erkannte Informationen aus der letzten Nutzereingabe gezielt weiterzuverarbeiten, zu speichern oder zur Steuerung des Gesprächsflusses zu verwenden. {% hint style="warning" %} Entitäten werden nach jeder Nutzereingabe neu geladen. Wenn der erkannte Wert im weiteren Verlauf verwendet werden soll, muss er in einer benutzerdefinierten Variable gespeichert werden. {% endhint %} #### Kontrolle, ob eine Entität erkannt wurde Prüfe im space.vars.TERM\_FLOW\_BUILDER per [Bedingung](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/bedingung), ob in der letzten Nutzereingabe eine bestimmte Entität erkannt wurde: * `Kundennummer (Entitäten)` – nicht leer – (rechts leer lassen) * `IBAN (Entitäten)` – ungleich (!=) – `""` {% hint style="info" %} Nicht erkannte Entitäten haben immer den Standardwert `""` (leerer String). Wird geprüft, ob eine Entität nicht leer ist, darf rechts kein Wert eingetragen werden. {% endhint %} #### Ausgabe an Nutzer Verwende Entitäten in Nachrichten, um personalisierte Antworten zu erzeugen: * z. B. „Danke, Ihre Kundennummer `Kundennummer (Entitäten)` wurde notiert." In der Praxis verwendet man hierfür meist die [benutzerdefinierte Variable](/epic-ai-platform/epic-ai-platform/ai-agent/build/variablen), in der der Wert der Entität dauerhaft gespeichert wurde. #### Zwischenspeicher – Wert in Variable speichern Speichere erkannte Entitäten dauerhaft in Variablen, um sie später weiterzuverarbeiten. Beispielsweise wird der erkannte Wert der Entität `IBAN (Entitäten)` in der benutzerdefinierten Variable `IBAN (Benutzerdefiniert - Kontakt)` gespeichert, um ihn im weiteren Verlauf flexibel zu nutzen (siehe Abschnitt *Beispiel*). {% hint style="success" %} Prüfe vor dem Speichern immer zuerst per Bedingung, ob die Entität erkannt wurde (nicht leer ist). {% endhint %} *** ### Verwaltung – Erstellung, Bearbeitung und Löschen #### Entität erstellen 1. Navigiere zu `AI Agent → Entwicklung → Entitäten` 2. Klicke oben rechts auf **„Entität erstellen"** 3. Vergib einen aussagekräftigen Namen – dieser ist später im Variablen-Picker und im space.vars.TERM\_FLOW\_BUILDER sichtbar 4. Klicke auf **„Entität erstellen"** – die Detailansicht öffnet sich 5. Klappe die gewünschten Komponenten auf und konfiguriere sie 6. Aktiviere bei Bedarf den Toggle **„Benötigt"** für eine Komponente 7. Klicke auf **„Entität speichern"** {% hint style="info" %} Nach dem Erstellen muss mindestens eine Komponente hinzugefügt werden. Andernfalls kann der space.vars.TERM\_AI\_AGENT nicht trainiert werden. {% endhint %} #### Entität bearbeiten Um eine Entität zu bearbeiten, klicke in der Entitätsübersicht direkt auf die gewünschte Entität. Folgendes kann angepasst werden: * **Name ändern:** Eine Namensänderung wirkt sich automatisch auf alle Verwendungsstellen im Flow aus – ohne manuelle Anpassungen. * **Komponenten anpassen:** Alle Komponenten können frei bearbeitet werden, z. B. Listen erweitern oder Regex aktualisieren. * **„Benötigt"-Status ändern:** Kann nachträglich für jede Komponente angepasst werden. #### **Built-In-Entität deaktivieren** Built-In-Entitäten (z. B. URL, Datum, Währung) können nicht gelöscht, aber deaktiviert werden. Fahre in der Entitätsübersicht mit der Maus über die entsprechende Zeile – es erscheint der Button „Deaktivieren". Eine deaktivierte Entität wird vom Modell nicht mehr erkannt, bleibt aber in der Übersicht sichtbar (Typ-Anzeige „Deaktiviert") und kann jederzeit wieder aktiviert werden. #### Entität löschen Klicke in der Entitätsübersicht auf das Mülleimer-Symbol am rechten Ende der entsprechenden Zeile. Prüfe vor dem Löschen, an welchen Stellen die Entität im Flow verwendet wird (z. B. in Bedingungen oder App-Modulen). Gelöschte Entitäten werden im Flow rot markiert und als `Variable nicht vorhanden` dargestellt. {% hint style="warning" %} Das Löschen einer Entität entfernt sie an **allen Stellen im Flow**. Das kann zu Logikfehlern führen – insbesondere wenn die Entität zuvor in Bedingungen verwendet wurde. Mögliche Folgen: * Bedingungen werten immer „falsch" aus → bestimmte Pfade sind nicht mehr erreichbar * Unerwartete Flow-Verzweigungen können entstehen * Wichtige Aktionen werden nicht mehr ausgeführt {% endhint %} {% hint style="success" %} Überprüfe nach dem Löschen den Flow auf mögliche Logikfehler und leere Felder. {% endhint %} *** ### Beispiel – Rufnummerabfrage bei unterdrückter Rufnummer Wenn ein Anrufer mit unterdrückter Nummer anruft, ist die Variable `Telefonnummer (Kontakt)` leer. Mit einer Entität kann die Nummer erfragt und gespeichert werden. **Schritt 1 – Entität erstellen** 1. Navigiere zu `AI Agent → Entwicklung → Entitäten` und erstelle eine neue Entität „Telefonnummer" 2. Konfiguriere die Reguläre-Ausdrücke-Komponente mit folgendem Regex: `(+49|0)[\s-]?\d{3,4}[\s-]?\d{5,8}` 3. Aktiviere den Toggle **„Benötigt"** und speichere die Entität **Schritt 2 – Prüfen, ob Rufnummer bekannt ist** Lege eine Bedingung an und prüfe: `Telefonnummer (Kontakt)` – nicht leer. Falls leer, leite den Flow in die Rückfrage weiter. **Schritt 3 – Rückfrage an Nutzer stellen** Lege einen Block mit folgender Textnachricht an: „Ich sehe, dass Sie mit einer unterdrückten Telefonnummer anrufen. Für das weitere Vorgehen wird jedoch Ihre Rufnummer benötigt. Bitte teilen Sie mir diese nun mit." Aktiviere außerdem die Option **„Erwartet Nutzereingabe nach diesem Block"**. **Schritt 4 – Kontrolle, ob die Entität erkannt wurde** Lege eine Bedingung an: `Telefonnummer (Entitäten)` – nicht leer * Falls „Falsch": Leite den Flow zurück in eine erneute Rückfrage * Falls „Wahr": Fahre mit dem nächsten Schritt fort **Schritt 5 – Wert in Variable speichern** 1. Lege einen neuen Block an 2. Füge das Element **„Variable festlegen"** hinzu (unter Aktionen) 3. Weise der benutzerdefinierten Variable `Telefonnummer (Benutzerdefiniert - Kontakt)` den Wert aus `Telefonnummer (Entitäten)` zu 4. Die Telefonnummer kann nun im weiteren Flow-Verlauf flexibel verwendet werden *** ### Best Practices * **Regex flexibel, aber präzise gestalten:** Gestalte Regex nicht zu restriktiv – leichte Eingabevariationen (z. B. bei Voice) sollen trotzdem erkannt werden. * Bei Voice-Eingaben: Toleranz für optionale Leerzeichen oder Bindestriche einplanen * `KD[ -]?` erkennt z. B. sowohl „KD1234" als auch „KD 1234" und „KD-1234" * **Immer mit echten Beispielen testen:** Teste Regex mit vollständigen Nutzereingaben aus echten Chats oder Voice-Transkriptionen. Nutze auch Tools wie regex101.com zum Testen und Debuggen. * **Erkannte Werte immer speichern:** Entitätswerte werden nach jeder Nutzereingabe zurückgesetzt. Speichere erkannte Werte deshalb immer in benutzerdefinierten Variablen, wenn du sie im weiteren Verlauf wieder benötigst. * **Vor dem Löschen prüfen:** Überprüfe vor dem Löschen einer Entität, an welchen Stellen sie im Flow verwendet wird und somit den Flow erneut auf Logikfehler und leere Felder. # Trigger Die Trigger-Übersicht zeigt dir alle Trigger, die in deinem AI Agent im Flow-Builder platziert wurden – an einer zentralen Stelle und auf einen Blick. ### Wo finde ich das? `Build → Trigger` *** ### Was genau ist die Trigger-Übersicht? Die Trigger-Übersicht listet alle Trigger auf, die aktuell in deinem AI Agent aktiv eingesetzt werden. Sie dient als zentrale Anlaufstelle, um schnell nachzuvollziehen, welche Trigger im space.vars.TERM\_FLOW\_BUILDER vorhanden sind und welchem Event sie zugeordnet sind. Über das Suchfeld kannst du gezielt nach einzelnen Triggern suchen. Zusätzlich lässt sich die Liste über die Reiter **Alle**, **Tags**, **Variablen** und **Custom** filtern; die Zahl neben jedem Reiter zeigt die jeweilige Anzahl an Triggern in dieser Kategorie an. {% hint style="info" %} Trigger können ausschließlich im space.vars.TERM\_FLOW\_BUILDER erstellt, bearbeitet oder gelöscht werden. Diese Übersichtsseite dient nur der Ansicht und Navigation. {% endhint %} ### Was sehe ich in der Übersicht? Die Liste zeigt alle platzierten Trigger mit folgenden Informationen: * **Inhalt:** Der Name des Trigger-Inhalts, z. B. der zugehörige Tag. * **Event:** Der Trigger-Typ, z. B. [Tag hinzugefügt](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/tag-hinzugefugt) oder [Benutzerdefiniertes Event](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/benutzerdefiniertes-event) * **Flow:** Der Flow, in dem der Trigger platziert ist. * **Geändert:** Datum der letzten Änderung des Triggers. #### Gelöschtes Tag Wenn ein Tag, das als Trigger-Inhalt verwendet wurde, nachträglich gelöscht wird, bleibt der Trigger in der Übersicht erhalten – der Inhalt wird jedoch als **„Gelöschtes Tag"** angezeigt. Der Trigger ist damit nicht mehr mit einem gültigen Tag verknüpft. {% hint style="warning" %} Achtung: Ein Trigger mit „Gelöschtes Tag" ist nicht mehr funktionsfähig. Navigiere über den Button „Zum Trigger" direkt zum betroffenen Schritt im space.vars.TERM\_FLOW\_BUILDER und passe ihn an oder entferne ihn. {% endhint %} ### Zum Trigger navigieren Über das **Pfeil-Icon** in der jeweiligen Tabellenzeile gelangst du direkt zum entsprechenden Trigger-Schritt im space.vars.TERM\_FLOW\_BUILDER. So kannst du einen Trigger schnell aufrufen, ohne ihn manuell im Flow suchen zu müssen. # Variablen Variablen sind Speicherorte für dynamische Werte innerhalb einer Unterhaltung. Sie ermöglichen es, Informationen wie Nutzerdaten oder erkannte Entitäten zu speichern und im Flow-Builder zu verwenden. ### Wo finde ich Variablen? **Verwaltung von Variablen:** `AI Agent → Entwicklung → Variablen` **Variablen im** space.vars.TERM\_FLOW\_BUILDER**:** Eingefügte Variablen werden farblich markiert: Blau für beschreibbare Variablen (benutzerdefiniert), Grau mit Schloss-Symbol für schreibgeschützte, automatisch befüllte Variablen (z. B. System- oder Konversationsvariablen wie Konversation-Id, Aktueller Zeitstempel). So sind Inhalt und Bearbeitungsstatus einer Variable auf einen Blick erkennbar. **Variablen-Picker:** In den meisten Eingabefeldern im space.vars.TERM\_FLOW\_BUILDER (z. B. in einem Text-Element) erscheint ein kleines Info-Menü. Es zeigt die verbleibende Zeichenanzahl, die Sprache sowie einen Button zum Einfügen von Variablen. *** ### Was genau sind Variablen? Variablen sind beschriftete Speicherorte für dynamische Werte, die während einer Unterhaltung im space.vars.TERM\_AI\_AGENT verwendet werden. Sie ermöglichen es, Informationen wie den Namen eines Nutzers, eine IBAN oder eine Produktauswahl auf Konversations- oder Kontaktebene zu speichern und im Verlauf gezielt einzusetzen – etwa zur Anzeige in Nachrichten oder zur Prüfung in Bedingungen. #### Zwei Arten von Variablen Es gibt zwei grundlegende Arten von Variablen: * **Standard Variablen** werden automatisch durch das System erstellt und befüllt – z. B. durch erkannte Entitäten oder Nutzerdaten. Ihre Werte können nicht manuell bearbeitet werden und tauchen in der Variablenübersicht nicht auf. Sie können ausschließlich im space.vars.TERM\_FLOW\_BUILDER verwendet werden. * **Benutzerdefinierte Variablen** werden gezielt an bestimmten Stellen im Flow gesetzt. Sie eignen sich sowohl zur Speicherung als auch zur Verwendung von Werten innerhalb des gesamten Flows – etwa in Bedingungen, Blöcken oder API-Aufrufen. #### Variablen-Picker Variablen sind in Kategorien eingeteilt. Diese Kategorien werden auch im Variablen-Picker angezeigt und gruppieren Variablen nach Zweck und Ursprung:
KategorieBeschreibungBeispiele
KonversationAutomatische Variablen: Informationen zur laufenden KonversationKonversation-ID, Sprache, Kanal-Typ
KontaktAutomatische Variablen: Daten zum NutzerName, Telefonnummer
SystemAutomatische Variablen: technische SystemvariablenID des space.vars.TERM_AI_AGENTs, aktueller Zeitstempel
EntitätenAutomatische Variablen: Werte aus erkannten Entitäten basierend auf der letzten NutzereingabeIBAN, Datum, Rechnungsnummer

Benutzerdefiniert

  • Kontakt
  • Konversation
Manuelle Variablen: Speicherung beliebiger Werte, flexibel im gesamten Flow nutzbar. Unterteilt in die Subkategorien Konversation und KontaktKundennummer, gewähltes Produkt, Kundenanliegen
App-ModuleAutomatische Variablen: Daten aus externen Quellen bzw. integrierten App-ModulenVersanddienstleister → Abfrage Sendestatus → Sendestatus
{% hint style="info" %} **Besonderheit bei App-Modulen:** Für jedes App-Modul gibt es im Variablen-Picker eine eigene Kategorie, unter der die zugehörigen Variablen übersichtlich gruppiert sind. {% endhint %} #### Darstellung von Variablen im space.vars.TERM\_FLOW\_BUILDER Je nach Herkunft einer Variable gibt es zwei Darstellungstypen für Variablennamen im space.vars.TERM\_FLOW\_BUILDER: * **Feste Kategorien** (z. B. System, Benutzerdefiniert): `Name der Variable (Kategorie)` * **App-Module:** `Name der App → Name des App-Moduls → Name der Variable` Zusätzlich sind Variablen farblich gekennzeichnet: * Blau = beschreibbar (benutzerdefinierte Variablen), z. B. Zusammenfassung (Benutzerdefiniert - Konversation) * Grau mit Schloss-Symbol = schreibgeschützt, z. B. Konversation-Id (Konversation) oder Aktueller Zeitstempel (System) *** ### Was kann man mit Variablen machen? #### Werte zuweisen Die manuelle Zuweisung von Werten ist ausschließlich bei **benutzerdefinierten Variablen** möglich. Variablen aus den Kategorien Kontakt, Konversation, System oder Entitäten werden automatisch befüllt und können nicht manuell überschrieben werden. **Standardwert festlegen** Für eine benutzerdefinierte Variable kann ein Standardwert hinterlegt werden. Dieser ist von Beginn an in der Variable gespeichert und bleibt bestehen, solange er nicht aktiv überschrieben wird. Der Standardwert kann entweder direkt bei der Erstellung der Variable festgelegt werden, oder nachträglich bei der Bearbeitung angepasst werden. **Werte im** space.vars.TERM\_FLOW\_BUILDER **zuweisen** 1. Öffne den Block, in dem einer Variable ein Wert zugewiesen werden soll (z. B. nach der Erkennung der Entität IBAN durch eine Benutzereingabe). 2. Füge ein Element vom Typ [**Variable Wert zuweisen**](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/block/elemente-aktionen#variable-wert-zuweisen) hinzu. 3. Klicke auf **„Variable auswählen"**, um den Variablen-Picker zu öffnen. 4. Wähle die Variable aus, in der der Wert gespeichert werden soll. Da nur benutzerdefinierte Variablen manuell befüllt werden können, zeigt der Variablen-Picker in diesem Kontext ausschließlich Variablen dieser Kategorie an. 5. Trage im Feld **„Folgenden Wert zuweisen"** den gewünschten Wert ein oder füge über den Variablen-Picker einen bestehenden Wert ein (z. B. aus einer anderen Variable oder einer Entität). Es kann sowohl ein statischer Text als auch ein Variablenwert verwendet werden – auch eine Kombination ist möglich. *** #### Verwendung im space.vars.TERM\_FLOW\_BUILDER Variablen sind zentrale Bausteine im space.vars.TERM\_FLOW\_BUILDER. Sie lassen sich über den Variablen-Picker in nahezu jedem Eingabe-Textfeld verwenden, um Inhalte dynamisch zu gestalten, Entscheidungen zu treffen oder externe Systeme anzusprechen. **Ausgabe an Nutzer** Verwende Variablen in Nachrichten, um personalisierte Antworten zu erzeugen: * `Hallo Vorname (Benutzerdefiniert - Kontakt)`, darf ich die Telefonnummer: Telefonnummer (Kontakt) notieren? * Der aktuelle Bestellstatus ist: `Versanddienstleister → Abfrage Sendestatus → Sendestatus` **Vergleiche in** [**Bedingungen**](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/bedingung) Nutze Variablen, um logische Entscheidungen im Flow zu treffen: * Wenn `Angerufene Rufnummer (Konversation)` – gleich (==) – `0123456789` * Wenn `Anzahl Artikel (Benutzerdefiniert - Konversation)` – größer als (>) – `3` **App-Module** Übergib Variablenwerte an externe Module oder API-Aufrufe: * Die Trackingnummer als Parameter eines Versanddienstleister-App-Moduls * Name und Produktwahl im Body eines E-Mail-App-Moduls **Zwischenspeicher für Nutzerinteraktionen** Speichere Antworten von Nutzern dauerhaft in Variablen, um sie später weiterzuverarbeiten: * Der erkannte Wert der Entität `IBAN (Entität)` wird in der benutzerdefinierten Variable `IBAN (Benutzerdefiniert - Kontakt)` gespeichert, um ihn im weiteren Verlauf flexibel nutzen zu können. *** ### Verwaltung – Erstellung, Bearbeitung und Löschen {% hint style="info" %} Die folgenden Funktionen beziehen sich ausschließlich auf **benutzerdefinierte Variablen**. Automatisch befüllte Variablen (z. B. aus den Kategorien Kontakt, Konversation, System oder Entitäten) können nicht bearbeitet oder gelöscht werden. {% endhint %} #### Variable erstellen Klicke oben rechts in der Variablenübersicht auf den Button **„Variable erstellen"**. Beim Erstellen einer Variable sind folgende Einstellungen vorzunehmen: **1. Namen festlegen** Der gewählte Name ist später im Variablen-Picker sowie im space.vars.TERM\_FLOW\_BUILDER sichtbar – z. B. bei Bedingungen oder Aktionen. Wähle einen aussagekräftigen und eindeutigen Namen, damit die Verwendung im Flow nachvollziehbar bleibt. **2. Speicherort wählen (Subkategorie)** Legt fest, ob die Variable einer Konversation oder einem Kontakt zugeordnet wird. * Konversation: Die Variable gilt nur für die aktuelle Konversation. Nach dem Ende einer Unterhaltung wird der Wert nicht weiter gespeichert. * Kontakt: Die Variable ist dem Kontakt dauerhaft zugeordnet. Ihr Wert bleibt über mehrere Konversationen hinweg erhalten und steht beim nächsten Kontakt wieder zur Verfügung. {% hint style="warning" %} Die Subkategorie einer benutzerdefinierten Variable wird beim Erstellen festgelegt und kann nachträglich **nicht** geändert werden. Um die Subkategorie zu wechseln, muss eine neue Variable angelegt werden. {% endhint %} **3. Datentyp auswählen** Beim Erstellen stehen vier Datentypen zur Auswahl: * `(.*)` **Text** * `#` **Zahl** * `<>` **Boolescher Wert** (WAHR/FALSCH) * `{}` **Objekt** {% hint style="success" %} In den meisten Fällen eignet sich der Datentyp **„Text"**, da er besonders flexibel einsetzbar ist. {% endhint %} **4. Standardwert festlegen (optional)** Dieser Wert wird verwendet, wenn der Variable im space.vars.TERM\_FLOW\_BUILDER noch kein Wert zugewiesen wurde. Das ist besonders praktisch für Initialwerte oder Fallbacks. *** #### Variable bearbeiten Variablen können jederzeit über die Variablenübersicht bearbeitet werden. Klicke dazu auf das **Stift-Symbol** am rechten Ende der entsprechenden Zeile. Im Dialog „Variable bearbeiten" können folgende Einstellungen angepasst werden: * **Name ändern:** Eine Änderung des Variablennamens wirkt sich automatisch auf alle Verwendungsstellen im Flow aus. So bleibt der Flow konsistent, ohne dass manuelle Anpassungen nötig sind. * **Standardwert anpassen:** Der optionale Standardwert kann jederzeit geändert werden. {% hint style="info" %} Der **Datentyp** einer Variable sowie deren **Subkategorie** kann nachträglich **nicht** geändert werden. Es muss eine neue Variable angelegt werden. {% endhint %} *** #### Variable löschen Variablen können über die Variablenübersicht gelöscht werden. Klicke dazu auf das **Mülleimer-Symbol** am rechten Ende der entsprechenden Zeile. Beim Löschen einer Variable wird diese an allen Stellen aus dem Flow entfernt. Prüfe daher vor dem Löschen, an welchen Stellen im Flow die Variable verwendet wird – z. B. in Bedingungen und App-Modulen. {% hint style="warning" %} Das Löschen einer Variable kann zu **Logikfehlern** führen, insbesondere wenn sie zuvor in Bedingungen verwendet wurde. Wird eine Variable z. B. in einer Bedingung abgefragt (`Anzahl Artikel (Benutzerdefiniert - Konversation) – gleich (==) – "42"`) und später gelöscht, bleibt die Bedingung bestehen – aber ohne gültige Vergleichsgrundlage. Das kann dazu führen, dass: * Bedingungen immer „falsch" auswerten und bestimmte Pfade nicht mehr erreichbar sind, * unerwartete Flow-Verzweigungen auftreten oder * wichtige Aktionen nicht mehr ausgeführt werden. {% endhint %} {% hint style="success" %} Überprüfe nach dem Löschen den Flow zusätzlich auf mögliche Logikfehler und leere Felder. Gelöschte Variablen werden im Flow **rot hinterlegt** und wie folgt dargestellt: `Variable nicht vorhanden`. {% endhint %} *** ### Beispiele #### Werte von Entitäten in Variablen speichern (Beispiel: IBAN) Wenn die IBAN eines Nutzers als [Entität](/epic-ai-platform/epic-ai-platform/ai-agent/build/entitaten) erkannt wurde und dieser Wert dauerhaft gespeichert werden soll, ist folgendes zu beachten: Entitätswerte werden nach jeder Benutzereingabe zurückgesetzt. Der Wert muss daher explizit und unmittelbar in einer Variable gespeichert werden, um im weiteren Verlauf verfügbar zu bleiben. **Schritte zum Speichern einer Entität in einer Variable:** 1. Öffne den Block, in dem die Variable befüllt werden soll – hier: nach der Erkennung der Entität IBAN durch eine Benutzereingabe. 2. Füge ein Element vom Typ [Variable Wert zuweisen](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/block/elemente-aktionen#variable-wert-zuweisen) hinzu. 3. Klicke auf **„Variable auswählen"**, um den Variablen-Picker zu öffnen. 4. Wähle die Variable `IBAN (Benutzerdefiniert - Kontakt)` aus. 5. Öffne im Feld **„Folgenden Wert zuweisen"** erneut den Variablen-Picker. 6. Wähle unter der Kategorie **Entitäten** die Entität `IBAN (Entität)` aus. Die erkannte IBAN ist nun dauerhaft in der Variable `IBAN (Benutzerdefiniert - Kontakt)` gespeichert und steht im weiteren Flow-Verlauf zur Verfügung. *** ### Best Practices * Wähle in den meisten Fällen den Datentyp **„Text"** für benutzerdefinierte Variablen. Er ist besonders flexibel und universell einsetzbar. Da: * **Universell nutzbar:** Es lassen sich damit die unterschiedlichsten Werte speichern – z. B. Texte, Zahlen, IDs oder Codes. * **Kompatibel mit Bedingungen:** Auch wenn eine Zahl als Text gespeichert wird, erkennt das System bei Vergleichen automatisch den richtigen Typ. * **Beispiel:** Wird der Wert `42` als Text in der Variable `Anzahl Artikel (Benutzerdefiniert - Konversation)` gespeichert, können trotzdem Bedingungen mit numerischen Vergleichsoperatoren verwendet werden: \ `Anzahl Artikel (Benutzerdefiniert - Konversation) – gleich (==) – "42"` \ `Anzahl Artikel (Benutzerdefiniert - Konversation) – größer gleich (>=) – "20"`\ Das System interpretiert den Variablenwert korrekt als Zahl. Operatoren wie `gleich (==)`, `größer gleich (>=)` und `kleiner gleich (<=)` funktionieren problemlos. * **Speicherort bewusst wählen** Überlege vor dem Erstellen einer benutzerdefinierten Variable genau, ob der Wert nur für die aktuelle Konversation relevant ist oder auch in zukünftigen Unterhaltungen mit demselben Kontakt zur Verfügung stehen soll. Da die Subkategorie nachträglich nicht geändert werden kann, lohnt sich diese Entscheidung im Voraus. * Für flüchtige Werte wie Zwischenergebnisse oder Gesprächskontext → **Konversation** * Für dauerhafte Nutzerdaten wie Kundennummer, Produktvorlieben oder Kontakthistorie → **Kontakt** *** # FAQs FAQs (Frequently Asked Questions) sind vordefinierte Frage-Antwort-Paare, mit denen dein AI Agent häufig gestellte Fragen direkt beantworten kann – ohne einen separaten Flow durchlaufen zu müssen. ### Wo finde ich die FAQs? Die Verwaltung der FAQs erreichst du über `AI Agent → Entwicklung → FAQs`. Dort siehst du eine Übersicht aller angelegten FAQ-Paare mit Name und letztem Änderungsdatum. Über die Reiter „Alle" und „Antwort fehlt" kannst du die Liste filtern, über das Suchfeld oben gezielt nach einem FAQ-Paar suchen. {% hint style="info" %} FAQs werden im space.vars.TERM\_FLOW\_BUILDER nicht als eigene Schritte dargestellt. Die Antwort wird direkt im FAQ-Eintrag hinterlegt und vom space.vars.TERM\_AI\_AGENT ausgegeben. {% endhint %} *** ### Erklärung – Was genau sind FAQs? FAQs sind Frage-Antwort-Paare, die häufige Nutzeranfragen direkt beantworten. Sie eignen sich besonders für einfache, statische Fragen – zum Beispiel nach Öffnungszeiten, Kontaktinformationen oder der Anschrift deines Unternehmens. #### Wie funktionieren FAQs? Der space.vars.TERM\_AI\_AGENT erkennt anhand der Nutzereingabe, welche Frage gemeint ist. Stimmt die Eingabe mit einem hinterlegten Ausdruck überein, wird die zugehörige Antwort direkt ausgegeben. Danach bleibt der space.vars.TERM\_AI\_AGENT im aktuellen Gesprächsfluss und kann normal weiterarbeiten. **Beispiel:** * **Frage vom Nutzer:** „Wie lautet Ihre Anschrift?" * **Antwort vom** space.vars.TERM\_AI\_AGENT**:** „Unsere Anschrift lautet: Musterstraße 12, 12345 Musterstadt." → Der space.vars.TERM\_AI\_AGENT erkennt das passende FAQ-Paar und gibt die vordefinierte Antwort aus – ohne einen separaten Flow zu starten. #### Unterschied zu Intentionen Inhaltlich funktionieren FAQs ähnlich wie [Intentionen](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/intentionen): Beide erkennen anhand der Nutzereingabe, was gemeint ist. Es gibt jedoch wichtige Unterschiede: * FAQs können **nicht** im space.vars.TERM\_FLOW\_BUILDER über den Schritt „Intention auswählen" verwendet werden. * Die Antwort wird **direkt im FAQ-Eintrag** hinterlegt – vergleichbar mit einem Intentions-Schritt, dem unmittelbar ein Text- oder Button-Block folgt. * FAQs benötigen **keinen eigenen Flow**. Sie eignen sich daher ideal für schnelle, statische Antworten. *** ### Verwendung – Was kann man mit FAQs machen? FAQs ermöglichen es deinem space.vars.TERM\_AI\_AGENT, schnell und präzise auf wiederkehrende Fragen zu reagieren. Sobald die Nutzereingabe einem hinterlegten Ausdruck ähnlich genug ist, wird die Antwort direkt ausgegeben. #### Antwortmöglichkeiten In der Antwort eines FAQ-Paares kannst du folgende Inhalte hinterlegen: * **Textnachrichten:** Statische Texte ohne Variablen oder dynamische Platzhalter. Du kannst mehrere Textnachrichten hinzufügen. * **Buttons:** Feste URLs oder Links (mit `https://`) – ebenfalls ohne Variablen oder dynamische Inhalte. * **Kombination aus beidem:** Text und Buttons können innerhalb eines FAQ-Paares kombiniert werden. {% hint style="info" %} Variablen oder dynamische Platzhalter werden in FAQ-Antworten nicht unterstützt. Für dynamische Antworten solltest du stattdessen Intentionen und Flows verwenden. {% endhint %} #### Verhalten im Gesprächsfluss Nach der Ausgabe der FAQ-Antwort bleibt der space.vars.TERM\_AI\_AGENT im aktuellen Flow. Der Dialog wird nicht unterbrochen oder umgeleitet – der space.vars.TERM\_AI\_AGENT kann anschließend normal weiterarbeiten. *** ### Verwaltung – Erstellung, Bearbeitung und Löschen #### FAQ erstellen 1. **Navigiere zu** `AI Agent → Entwicklung → FAQs` und klicke auf den Button **„FAQ-Paar erstellen"**. 2. **Name festlegen:** Gib dem FAQ-Paar einen aussagekräftigen und eindeutigen Namen. Dieser Name dient der späteren Zuordnung und Auffindbarkeit im System. 3. **Sprache auswählen:** Jedes FAQ-Paar kann Ausdrücke und Antworten in mehreren Sprachen enthalten. Über das Dropdown-Menü wählst du die gewünschte Sprache aus. Es werden jeweils nur die Ausdrücke und Antworten der aktuell ausgewählten Sprache angezeigt. Der Name des FAQ-Paares bleibt sprachunabhängig. Die verfügbaren Sprachen müssen zuvor in den space.vars.TERM\_AI\_AGENT-Einstellungen [im Reiter „Sprache" hinzugefügt](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/sprache) werden. 4. **Ausdrücke hinzufügen:** Gib im Feld „Neuen Ausdruck hinzufügen" die Fragen oder Formulierungen ein, die diesem FAQ-Paar zugeordnet werden sollen. Bestätige jeden Ausdruck mit `Enter`. **Tipp:** Drücke `Shift` + `Enter`, um den Ausdruck hinzuzufügen und gleichzeitig eine automatische Übersetzung für alle konfigurierten Sprachen zu erzeugen. 5. **Antwort definieren:** Hinterlege die Antwort, die der space.vars.TERM\_AI\_AGENT ausgeben soll. Du kannst Textnachrichten, Buttons oder eine Kombination aus beidem verwenden. Über „Nachricht hinzufügen" fügst du weitere Textnachrichten hinzu, über „Button hinzufügen" weitere Buttons. 6. **Speichern:** Klicke auf **„FAQ-Paar speichern"**, um den Eintrag zu sichern. {% hint style="success" %} Du kannst den [Epic AI Copilot](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/ki-einstellungen/automatisch-generieren) nutzen, um Beispielausdrücke für ein FAQ-Paar automatisch generieren zu lassen. {% endhint %} {% hint style="warning" %} Ausdrücke können nicht doppelt vergeben werden – weder innerhalb eines FAQ-Paares noch über mehrere FAQs oder Intentionen hinweg. Bei einem Duplikat erscheint eine Fehlermeldung und das Hinzufügen wird abgebrochen. {% endhint %} #### FAQ bearbeiten FAQ-Paare können jederzeit angepasst werden. Du kannst: * Neue Ausdrücke und Antworten hinzufügen * Bestehende Ausdrücke und Antworten entfernen * Ausdrücke und Antworten in weiteren Sprachen ergänzen * Den Namen des FAQ-Paares ändern Öffne dazu das gewünschte FAQ-Paar in der Übersicht und nimm die Änderungen vor. Vergiss nicht, anschließend zu speichern. #### FAQ löschen Um ein FAQ-Paar zu löschen, klicke in der FAQ-Übersicht auf das Mülltonne-Symbol am rechten Ende der entsprechenden Zeile. {% hint style="warning" %} Beim Löschen eines FAQ-Paares wird dieses vollständig entfernt. Der space.vars.TERM\_AI\_AGENT kann danach nicht mehr auf die zugehörigen Fragen reagieren. {% endhint %} *** ### Beispiele #### Beispiel 1: Anschrift **Ausdrücke:** * „Wie lautet Ihre Anschrift?" * „Wo befindet sich Ihr Büro?" * „Können Sie mir Ihre Adresse nennen?" * „An welcher Adresse sind Sie zu finden?" **Antwort:** „Unsere Anschrift lautet: Musterstraße 12, 12345 Musterstadt." #### Beispiel 2: Öffnungszeiten **Ausdrücke:** * „Wann haben Sie geöffnet?" * „Wie sind Ihre Öffnungszeiten?" * „Ab wann ist Ihr Büro erreichbar?" * „Wann machen Sie morgens auf?" **Antwort:** „Wir sind Montag bis Freitag von 9 bis 18 Uhr erreichbar." {% hint style="info" %} Die Antwort ist statisch. Auch spezifische Fragen wie „Wann haben Sie mittwochs geöffnet?" werden mit der vollständigen Standardantwort beantwortet. {% endhint %} #### Beispiel 3: Kontaktaufnahme **Ausdrücke:** * „Wie kann ich Sie kontaktieren?" * „Wie erreiche ich den Kundenservice?" * „Welche Telefonnummer haben Sie?" * „Wie lautet Ihre E-Mail-Adresse?" **Antwort (Text + Button):** * **Text:** „Sie erreichen uns per E-Mail unter oder telefonisch unter 01234 / 567890." * **Button:** Label „Kontaktformular" → Link zu `https://musterfirma.de/kontaktformular` *** ### Best Practices * **Eindeutige Fragen formulieren:** Jede FAQ sollte eine klar erkennbare Fragestellung abdecken. Vermeide doppelte oder zu ähnliche Fragen, um Überschneidungen bei der Erkennung zu vermeiden. * **Klare und präzise Antworten geben:** Die Antwort sollte kurz, eindeutig und selbsterklärend sein. FAQs eignen sich ideal für häufig gestellte, statische Fragen. * **Variationen in den Ausdrücken einbauen:** Füge unterschiedliche Formulierungen hinzu, die Nutzer für dieselbe Frage verwenden könnten. So erkennt der space.vars.TERM\_AI\_AGENT auch abweichende, aber gleichbedeutende Eingaben. Hinterlege mindestens 3–5 verschiedene Formulierungen pro FAQ-Paar, um eine zuverlässige Erkennung sicherzustellen. * **Inhaltlich ähnliche FAQs vermeiden:** Wenn zwei FAQs inhaltlich zu nahe beieinanderliegen (z. B. „Wie kann ich Sie kontaktieren?" und „Wie lautet Ihre Telefonnummer?"), überlege, ob sie zusammengefasst oder klarer voneinander abgegrenzt werden sollten. * **Regelmäßig prüfen und anpassen:** Analysiere Chatverläufe, um zu erkennen, welche Fragen häufig gestellt werden oder welche falsch zugeordnet wurden. Erweitere oder überarbeite die FAQ-Ausdrücke entsprechend. * **Nur für statische Informationen verwenden:** FAQs sind ideal für feste Antworten wie Öffnungszeiten, Anschrift oder Kontaktdaten. Für dynamische oder kontextabhängige Antworten (z. B. Preisabfragen oder Kontostatus) solltest du stattdessen Intentionen und Flows verwenden. * **Einheitlicher Stil bei Antworten:** Formuliere alle Antworten im gleichen Ton und Stil – z. B. stets als vollständige Sätze und mit konsistenter Ansprache. # Wissen Mit der Funktion „Wissen" kannst du deinem AI Agent externe Informationen zur Verfügung stellen. ## Quellen ### Wo finde ich das? Die Wissensverwaltung erreichst du direkt über den Menüpunkt `Wissen` in der Hauptnavigation. In der linken Seitenleiste werden dir dort zwei Bereiche angezeigt: **Quellen** (mit Anzahl und Status-Punkt je Quelle) und **Gruppen** (mit Anzahl der enthaltenen Quellen je Gruppe). Ein Klick auf eine einzelne Quelle in der Seitenleiste öffnet direkt deren Detailansicht. Ein Klick auf die Überschrift „Quellen" öffnet die vollständige Übersichtstabelle mit den Spalten Quelle, Typ, Status und das Einspeisungsdatum. *** ### Erklärung – Was genau ist Wissen? Wissen bezeichnet die Sammlung externer Inhalte, auf die dein space.vars.TERM\_AI\_AGENT bei der Beantwortung von Nutzeranfragen zugreifen kann. Die Inhalte werden im Hintergrund verarbeitet, indexiert und stehen dem space.vars.TERM\_AI-Modell anschließend als Kontext zur Verfügung. Es werden zwei Quellentypen unterstützt: #### PDF-Dateien Du kannst eine oder mehrere PDF-Dateien gleichzeitig hochladen. Die Inhalte der PDFs werden automatisch extrahiert und für den space.vars.TERM\_AI\_AGENT aufbereitet. {% hint style="info" %} Aktuell werden ausschließlich PDF-Dateien als Datei-Upload unterstützt. Weitere Formate sind derzeit nicht verfügbar. {% endhint %} #### Websites Du kannst eine Website-URL hinterlegen, die automatisch gecrawlt wird. Dabei werden auch Unterseiten erfasst. Beim Hinzufügen einer Website stehen dir folgende Einstellungen zur Verfügung: * **Pfade einschließen:** Lege fest, welche URL-Pfade gecrawlt werden sollen (z. B. `/docs` oder `/hilfe/*`). * **Pfade ausschließen:** Schließe bestimmte URL-Pfade vom Crawling aus (z. B. `/blog` oder `/intern/*`). * **Maximale Crawl-Tiefe:** Bestimme, wie viele Ebenen tief die Website gecrawlt werden soll. Der Standardwert liegt bei `100`. Du kannst diesen Wert über ein Zahlenfeld anpassen. {% hint style="info" %} Websites werden in regelmäßigen Abständen automatisch erneut gecrawlt, damit die Inhalte aktuell bleiben. {% endhint %} *** ### Verwendung – Was kann man mit Wissen machen? #### Quellen im space.vars.TERM\_AI\_AGENT nutzen Die hinterlegten Wissensquellen stehen deinem space.vars.TERM\_AI\_AGENT in den Generative-space.vars.TERM\_AI-Schritt zur Verfügung. Du kannst sie an folgenden Stellen einbinden: * [**Gespräch führen**](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/gen-ai-gesprach-fuhren) * [**Prompt ausführen**](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/gen-ai-prompt-ausfuhren) * [**KI-Einstellungen (Fallback)**](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/ki-einstellungen) Dabei kannst du entweder alle Quellen verwenden oder gezielt einzelne Quellen über [Wissensgruppen](broken://pages/fbOEOuNppnXZspf87qJo) zuweisen. {% hint style="info" %} Quellen sind grundsätzlich global für den gesamten space.vars.TERM\_AI\_AGENT verfügbar. Über Wissensgruppen lässt sich die Zuordnung bei Bedarf einschränken. {% endhint %} #### Quellen anzeigen und prüfen In der Quellenübersicht unter `Wissen` werden alle hinterlegten Quellen in einer Tabelle dargestellt. Ein Klick auf eine Quelle öffnet die Detailansicht mit dem extrahierten Inhalt, einem Inhaltsverzeichnis der erkannten Abschnitte sowie Kennzahlen zu Chunks und Wörtern. Websites werden in der Übersicht zusammen mit ihren Unterseiten gruppiert angezeigt. *** ### Verwaltung – Erstellung, Bearbeitung und Löschen #### Quelle hinzufügen: PDF-Dateien 1. Navigiere zu `Wissen`. 2. Klicke auf „Quellen hinzufügen". 3. Wähle den Quellentyp „Datei hochladen" aus. 4. Ziehe eine oder mehrere PDF-Dateien in den Upload-Bereich oder wähle sie über den Dateidialog aus (max. 25 MB pro Datei, 200 MB gesamt). 5. Die Dateien werden im Hintergrund verarbeitet. Der aktuelle Verarbeitungsstatus wird in der Übersicht angezeigt. {% hint style="info" %} Die Verarbeitung kann je nach Umfang der Dateien einige Minuten in Anspruch nehmen. Sobald die Verarbeitung abgeschlossen ist, stehen die Inhalte dem space.vars.TERM\_AI\_AGENT automatisch zur Verfügung. {% endhint %} #### Quelle hinzufügen: Website 1. Navigiere zu `Wissen`. 2. Klicke auf „Quellen hinzufügen". 3. Wähle den Quellentyp „Website" aus. 4. Gib die Start-URL der Website ein. 5. Konfiguriere bei Bedarf: * Pfadfilter (Regex) zum Ein- bzw. Ausschließen (z. B. `/produkte/.*` einschließen, `/intern/.*` ausschließen) * Maximale Tiefe (Standard: `10`, max. `100)` * Maximale Seitenanzahl (Standard: `100`, max. `1000`) Starte den Import. Die Website wird im Hintergrund gecrawlt und verarbeitet. {% hint style="info" %} Die Verarbeitung kann je nach Umfang der Website einige Minuten in Anspruch nehmen. Sobald die Verarbeitung abgeschlossen ist, stehen die Inhalte dem space.vars.TERM\_AI\_AGENT automatisch zur Verfügung. {% endhint %} #### Crawl bearbeiten Bestehende Crwals können nachträglich bearbeitet werden. Es lassen sich eingeschlossene und ausgeschlossene Pfade sowie die maximale Crawl-Tiefe einstellen. 1. Navigiere zu `Wissen`. 2. Öffne die Quelle, die du bearbeiten möchtest. 3. Passe die gewünschten Einstellungen an. 4. Speichere die Änderungen. #### Quelle löschen 1. Navigiere zu `Wissen`. 2. Wähle die Quelle aus, die du löschen möchtest. 3. Bestätige das Löschen im angezeigten Bestätigungsdialog. {% hint style="warning" %} Gelöschte Quellen stehen dem space.vars.TERM\_AI\_AGENTnicht mehr zur Verfügung. Stelle sicher, dass die Quelle nicht mehr benötigt wird, bevor du sie entfernst. {% endhint %} *** ### Beispiele #### Beispiel: Hilfe-Center als Wissensquelle einbinden Du betreibst ein Hilfe-Center unter `https://hilfe.beispiel.de` und möchtest, dass dein space.vars.TERM\_AI\_AGENT Fragen auf Basis dieser Inhalte beantwortet. 1. Navigiere zu `Wissen`. 2. Füge eine neue Website-Quelle hinzu. 3. Gib die URL `https://hilfe.beispiel.de` ein. 4. Schließe den Pfad `/intern/*` aus, da dieser nur interne Inhalte enthält. 5. Belasse die maximale Crawl-Tiefe beim Standardwert `100`. 6. Starte den Import und warte, bis die Verarbeitung abgeschlossen ist. Dein space.vars.TERM\_AI\_AGENT kann nun Fragen beantworten, die sich auf die Inhalte deines Hilfe-Centers beziehen. Die verwendeten Quellen werden dem Nutzer im Chat als Referenz angezeigt. #### Beispiel: Produktkatalog als PDF bereitstellen Du möchtest, dass dein space.vars.TERM\_AI\_AGENT Fragen zu deinem aktuellen Produktsortiment beantworten kann. 1. Navigiere zu `Wissen`. 2. Lade die aktuelle Version deines Produktkatalogs als PDF hoch. 3. Warte, bis die Verarbeitung abgeschlossen ist. Der space.vars.TERM\_AI\_AGENTkann nun Informationen aus dem Katalog in seine Antworten einbeziehen – z. B. Produktnamen, Preise oder Verfügbarkeiten. *** ### Best Practices * Halte deine Wissensquellen aktuell. Veraltete Informationen können zu falschen oder irreführenden Antworten führen. Websites werden zwar automatisch erneut gecrawlt, aber PDF-Dateien musst du bei Änderungen manuell erneut hochladen. * Nutze aussagekräftige Dateinamen für deine PDFs (z. B. `Produktkatalog_2026.pdf` statt `Dokument1.pdf`). Das erleichtert die Verwaltung in der Quellenübersicht. * Verwende die Pfad-Einstellungen beim Website-Crawling gezielt, um irrelevante Inhalte auszuschließen (z. B. Impressum, interne Bereiche oder Blog-Artikel). Je relevanter die Quellen sind, desto präziser werden die Antworten deines space.vars.TERM\_AI\_AGENTs. * Nutze [Wissensgruppen](broken://pages/fbOEOuNppnXZspf87qJo), um Quellen gezielt bestimmten Schritt zuzuordnen. So stellst du sicher, dass der space.vars.TERM\_AI\_AGENT in jedem Kontext nur die passenden Informationen heranzieht. *** ## Wissensgruppen ### **Wo finde ich das?** Wissensgruppen findest du als Unterbereich im Menüpunkt `Wissen` in der linken Navigation, unterhalb der Quellenliste. Jede Gruppe zeigt dort direkt an, wie viele Quellen sie enthält. ### **Erklärung – Was genau sind Wissensgruppen?** Eine Wissensgruppe ist eine Sammlung von Wissensquellen, die du nach eigenen Kriterien zusammenstellst. Du kannst beliebig viele Quellen in einer Gruppe bündeln – z. B. alle Quellen zu einem bestimmten Thema, Produkt oder Einsatzbereich. Eine Quelle kann dabei in mehreren Wissensgruppen gleichzeitig enthalten sein. So lassen sich flexibel und überlappende Strukturen abbilden, ohne Quellen doppelt pflegen zu müssen. ### **Verwendung – Was kann man mit Wissensgruppen machen?** #### **Quellen gezielt filtern** Der Hauptvorteil von Wissensgruppen liegt in der gezielten Steuerung, welche Quellen dein AI Agent in einem bestimmten Kontext nutzt. Anstatt immer auf das gesamte Wissen zuzugreifen, kannst du den Zugriff auf eine oder mehrere Wissensgruppen einschränken. Die Auswahl einer Wissensgruppe ist an folgenden Stellen möglich: * [**Gespräch führen**](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/gen-ai-gesprach-fuhren) * [**Prompt ausführen**](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/gen-ai-prompt-ausfuhren) * [**AI-Einstellungen (Fallback)**](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/ki-einstellungen) In jedem dieser Schritte kannst du eine oder mehrere Wissensgruppen auswählen. Es lassen sich auch mehrere Gruppen gleichzeitig kombinieren – der AI Agent greift dann auf alle Quellen aus den ausgewählten Gruppen zu. {% hint style="info" %} Wenn in einem Schritt keine Wissensgruppe ausgewählt wird, greift der space.vars.TERM\_AI\_AGENT automatisch auf alle verfügbaren Quellen zu. {% endhint %} ### **Praxisbeispiel: Quellen nach Thema aufteilen** Du betreibst einen AI Agent für den Kundenservice, der sowohl Fragen zu Produkten als auch zu Versand und Retouren beantworten soll. Dafür erstellst du zwei Wissensgruppen: * **Produktwissen** – enthält den Produktkatalog (PDF) und die Produkt-FAQ-Seite (Website). * **Versand & Retouren** – enthält die Versandrichtlinien (PDF) und die Retouren-Hilfeseite (Website). In einem Schritt, der sich ausschließlich mit Retourenfragen befasst, wählst du nur die Gruppe „Versand & Retouren" aus. So vermeidest du, dass der AI Agent irrelevante Produktinformationen in seine Antwort einbezieht. ### **Verwaltung – Erstellung, Bearbeitung und Löschen** #### **Wissensgruppe erstellen** 1. Navigiere zu `Wissen → Gruppen`. 2. Klicke auf „Wissensgruppe erstellen". 3. Vergib einen Namen für die Gruppe im Feld „Name der Wissensgruppe". 4. Klicke auf „Erstellen". 5. Öffne die neue Gruppe und klicke auf „Wissensquellen bearbeiten". Füge über das Suchfeld „Wissensquelle hinzufügen" die gewünschten Quellen per Checkbox hinzu. #### **Wissensgruppe bearbeiten** Du kannst jederzeit Quellen zu einer bestehenden Wissensgruppe hinzufügen oder daraus entfernen. 1. Navigiere zu `Wissen → Gruppen`. 2. Öffne die Wissensgruppe, die du bearbeiten möchtest. 3. Klicke auf „Wissensquellen bearbeiten". 4. Füge Quellen über die Checkboxen hinzu oder entferne bestehende. **Wissensgruppe löschen** 1. Navigiere zu `Wissen → Gruppen`. 2. Wähle die Wissensgruppe aus, die du löschen möchtest. 3. Bestätige das Löschen. {% hint style="info" %} Beim Löschen einer Wissensgruppe werden ausschließlich die Gruppierung und die Zuordnung aufgelöst. Die Quellen selbst bleiben im space.vars.TERM\_AI\_AGENT erhalten und stehen weiterhin zur Verfügung. {% endhint %} {% hint style="warning" %} Wenn eine gelöschte Wissensgruppe in einem Schritt referenziert wurde, greift dieser Schritt anschließend auf alle verfügbaren Quellen zu, da keine Einschränkung mehr aktiv ist. Prüfe daher nach dem Löschen, ob die betroffenen Schritt angepasst werden müssen. {% endhint %} ### **Beispiele** #### **Beispiel: Mehrsprachiges Wissen aufteilen** Du bietest deinen AI Agent in Deutsch und Englisch an. Deine Wissensquellen liegen ebenfalls in beiden Sprachen vor. 1. Erstelle die Wissensgruppe „Wissen DE" und füge alle deutschsprachigen Quellen hinzu. 2. Erstelle die Wissensgruppe „Wissen EN" und füge alle englischsprachigen Quellen hinzu. 3. Wähle im jeweiligen sprachspezifischen Schritt die passende Wissensgruppe aus. So stellst du sicher, dass der AI Agent nur Quellen in der richtigen Sprache heranzieht und keine sprachlich gemischten Antworten erzeugt. *** ### **Best Practices** * Benenne Wissensgruppen klar und eindeutig – z. B. nach Thema, Produkt oder Einsatzbereich. Das erleichtert die Zuordnung, wenn du mehrere Gruppen verwaltest. * Nutze Wissensgruppen auch dann, wenn du aktuell nur wenige Quellen hast. Eine saubere Struktur von Anfang an spart Aufwand, sobald weitere Quellen hinzukommen. * Beschränke die Wissensgruppen in einem Schritt auf das, was tatsächlich relevant ist. Je weniger irrelevante Quellen der AI Agent durchsuchen muss, desto präziser und schneller fallen die Antworten aus. # Mediathek Die Mediathek ist der zentrale Speicherort für Dateien innerhalb deines AI Agents. Hier kannst du Dateien hochladen, verwalten und anschließend im Flow-Builder oder über die Inbox verwenden. ### Wo finde ich die Mediathek? Die Mediathek erreichst du über `Entwicklung → Mediathek`. Beim Öffnen siehst du eine Übersicht aller bereits hochgeladenen Dateien. Ist die Mediathek noch leer, wird der Hinweis „Keine Dateien vorhanden" angezeigt. *** ### Erklärung – Was ist die Mediathek? Die Mediathek dient als Dateiverwaltung für deinen space.vars.TERM\_AI\_AGENT. Du kannst dort beliebige Dateien hochladen – darunter Bilder, Videos, Audiodateien, PDFs oder andere Formate. Die maximale Dateigröße beträgt **25 MB** pro Datei. Hochgeladene Dateien stehen dir anschließend an zwei Stellen zur Verfügung: * **Im** space.vars.TERM\_FLOW\_BUILDER**:** Du kannst Dateien aus der Mediathek direkt in [Elemente](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/block/elemente-dateien) wie Bild, Video, Audio oder Datei einbinden. * **In der Inbox:** Du kannst Dateien aus der Mediathek an Nutzer senden. *** ### Verwendung – Was kann man mit der Mediathek machen? #### Dateien hochladen 1. Öffne die Mediathek über `Entwicklung → Mediathek`. 2. Klicke auf den Button **„Datei hochladen"** unten rechts. 3. Es öffnet sich ein Dialog mit zwei Möglichkeiten: * **Datei hierher ziehen:** Ziehe eine oder mehrere Dateien per Drag-and-Drop in den markierten Bereich. * **„Vom Computer hochladen":** Klicke auf den Button, um Dateien über den Datei-Explorer auszuwählen. 4. Die Datei wird hochgeladen und erscheint anschließend in der Mediathek-Übersicht. Alternativ kannst du Dateien auch direkt per Drag-and-Drop in das Browserfenster der Mediathek ziehen, ohne den Upload-Dialog zu öffnen. {% hint style="info" %} Du kannst mehrere Dateien gleichzeitig hochladen. Alle Dateiformate sind erlaubt. Die maximale Dateigröße beträgt 25 MB pro Datei. {% endhint %} #### Dateien ansehen Um eine hochgeladene Datei zu öffnen, doppelklicke auf die gewünschte Datei in der Übersicht. Die Datei wird in einem neuen Browser-Tab geöffnet. #### Dateien im space.vars.TERM\_FLOW\_BUILDER verwenden Hochgeladene Dateien stehen im space.vars.TERM\_FLOW\_BUILDER in den entsprechenden Elementen zur Auswahl – z. B. in Bild-, Video-, Audio- oder [Datei-Elementen](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/block/elemente-dateien). #### Dateien über die Inbox versenden \[TODO: Link zum Inbox-Artikel ergänzen] #### Dateien löschen Jede Datei in der Mediathek zeigt oben rechts ein **Papierkorb-Symbol**. Klicke darauf, um die Datei zu löschen. {% hint style="warning" %} Das Löschen einer Datei kann nicht rückgängig gemacht werden. Wenn eine gelöschte Datei in einem Flow-Builder-Element verwendet wurde, bleibt das Element bestehen, funktioniert aber nicht mehr korrekt. Du musst in diesem Fall entweder eine andere Datei auswählen oder das Element manuell entfernen. {% endhint %} {% hint style="info" %} Prüfe vor dem Löschen, ob die Datei noch in einem Flow-Builder-Element oder in der Inbox verwendet wird. {% endhint %} *** ### Best Practices * **Aussagekräftige Dateinamen verwenden:** Benenne deine Dateien vor dem Upload so, dass ihr Inhalt leicht erkennbar ist – z. B. `willkommensbild-startseite.png` statt `IMG_2847.png`. Da Dateien in der Mediathek nicht umbenannt werden können, lohnt es sich, den Namen vorab festzulegen. * **Dateigröße beachten:** Halte Dateien möglichst klein, um schnelle Ladezeiten für deine Nutzer zu gewährleisten. Die maximale Dateigröße beträgt 25 MB. * **Nicht mehr benötigte Dateien entfernen:** Lösche regelmäßig Dateien, die nicht mehr verwendet werden, um die Übersicht in der Mediathek zu behalten. # Daten # Trainingsdaten Trainingsdaten sind echte Benutzereingaben, die dein AI Agent gesammelt hat. Du kannst sie nutzen, um die Erkennungsqualität deines AI Agents gezielt zu verbessern. ### Wo finde ich die Trainingsdaten? Die Trainingsdaten erreichst du über den Navigationspfad: `AI Agent → Optimierung → Trainingsdaten` Auf der Übersichtsseite siehst du die Kachel **„Trainingsstapel verarbeiten"** mit einer Zusammenfassung aller gesammelten Eingaben, aufgeteilt nach Übereinstimmungsstufen. Zugeordnete Trainingsdaten werden anschließend als Ausdrücke direkt in den jeweiligen [Intentionen](/epic-ai-platform/epic-ai-platform/ai-agent/build/intentionen) aufgeführt. *** ### Erklärung – Was genau sind Trainingsdaten? Trainingsdaten sind konkrete Benutzereingaben aus Chat- oder Voice-Konversationen, bei denen der space.vars.TERM\_AI\_AGENT versucht hat, eine passende Intention oder FAQ zu erkennen. Jede Eingabe zeigt, wie stark sie mit den vorhandenen Intentionen übereinstimmt – also wie sicher der space.vars.TERM\_AI\_AGENT war, die Absicht des Nutzers richtig zu interpretieren. Dieser Wert wird als **Sicherheit** (in Prozent) angezeigt. #### Die Trainingsstapel Eingaben werden automatisch nach ihrer höchsten Übereinstimmung in Stapel eingeteilt. Jeder Stapel enthält dabei auch alle Eingaben der darunter liegenden Stufen – der Stapel ≤ 50 % enthält also auch die Eingaben aus ≤ 10 % und ≤ 30 %. Die Farben der Stapel signalisieren auf einen Blick den Handlungsbedarf:
StapelBeschreibungFlow ausgelöst?
≤ 10 %

Sehr geringe Übereinstimmung:

Der space.vars.TERM_AI_AGENT konnte keine passende Intention finden.

Nein
≤ 30 %

Geringe Übereinstimmung:

Keine Intention eindeutig erkannt.

Nein
≤ 50 %

Mittlere Übereinstimmung:

Die Schwelle wurde nicht überschritten.

Nein
≤ 70 %

Übereinstimmung:

Übereinstimmung vorhanden, aber unterhalb der Erkennungsschwelle.

Nein
> 70 %

Hohe Übereinstimmung:

Mindestens eine Intention wurde eindeutig erkannt. Wenn mehrere Intentionen über 70 % liegen, wird automatisch diejenige mit dem höchsten Wert gewählt.

Ja
{% hint style="info" %} Alle Eingaben innerhalb eines Stapels werden absteigend nach ihrem Übereinstimmungswert sortiert. {% endhint %} *** ### Verwendung – Was kann man mit Trainingsdaten machen? #### Erkennungsqualität nachvollziehen Die Trainingsdaten zeigen dir, wie gut dein space.vars.TERM\_AI\_AGENT Benutzereingaben aktuell erkennt. Du siehst auf einen Blick: * wie viele Eingaben in welchem Stapel landen, * wie hoch die durchschnittliche Sicherheit insgesamt ist, * und ob häufig Eingaben unterhalb der Erkennungsschwelle bleiben. #### Eingaben Intentionen zuordnen Falsch oder gar nicht erkannte Eingaben kannst du manuell der richtigen Intention zuordnen. So lernt dein space.vars.TERM\_AI\_AGENT, ähnliche Formulierungen künftig korrekt zu erkennen. Für jede Eingabe stehen zwei Aktionen zur Verfügung: * **„Ausdruck zuordnen"**: Ordnet die Eingabe der gewählten Intention zu und fügt sie dort als neuen Beispielausdruck hinzu. Die Zuordnung wird erst nach aktivem Klick auf den Button wirksam. Die Intention mit der höchsten Übereinstimmung ist dabei dunkel hervorgehoben – sie wird aber erst nach Bestätigung tatsächlich übernommen. * **„Ausdruck nicht zuordnen"**: Verwirft die Eingabe, ohne sie einer Intention zuzuordnen. **Schritt-für-Schritt: Eingabe einer Intention zuordnen** 1. Navigiere zu `AI Agent → Optimierung → Trainingsdaten`. 2. Wähle einen Stapel aus, den du bearbeiten möchtest – oder klicke auf **„Stapel jetzt zuordnen"**, um alle Eingaben unter 70 % auf einmal zu öffnen. 3. Die Detailansicht einer Eingabe öffnet sich. Du siehst: * den Eingabetext des Nutzers, * die **vorhergesagte Intention** (sofern vorhanden), * den **Sicherheitswert**, das Erstellungsdatum und die Sprache. 4. Unter **„Vorhersagen für alle Intentionen"** werden alle Intentionen mit ihrem Übereinstimmungswert aufgelistet. * Nutze das Suchfeld **„Intentionen filtern..."**, um schnell zur richtigen Intention zu navigieren. * Mit **„Intentionen unter 5 % einblenden/ausblenden"** kannst du sehr schwach übereinstimmende Intentionen ein- oder ausblenden. 5. Klicke bei der passenden Intention auf **„Ausdruck zuordnen"**, um die Eingabe zuzuordnen. 6. Oder klicke auf **„Ausdruck nicht zuordnen"** (roter Button), wenn die Eingabe keiner Intention zugeordnet werden soll. *** ### Beispiele #### Beispiel 1: Intention nicht erkannt – inhaltlich aber passend **Situation:** Ein Nutzer schreibt „Ich möchte meine Bestellung zurückziehen". Der space.vars.TERM\_AI\_AGENT hat die Eingabe nur zu 60 % der Intention „Stornierung" zugeordnet – unterhalb der Erkennungsschwelle. Die Eingabe landet im Stapel ≤ 70 %, kein Flow wurde ausgelöst. **Was tun?** Inhaltlich passt die Eingabe klar zur Intention „Stornierung". Öffne die Eingabe in der Detailansicht und klicke bei der Intention „Stornierung" auf **„Ausdruck zuordnen"**. Künftig erkennt der space.vars.TERM\_AI\_AGENT ähnliche Formulierungen mit höherer Sicherheit. #### Beispiel 2: Intention fälschlicherweise erkannt – inhaltlich nicht passend **Situation:** Ein Nutzer schreibt „Ich will meine Bestellung stornieren". Der space.vars.TERM\_AI\_AGENT hat die Eingabe mit 74 % der Intention „Reklamation" zugeordnet – der falsche Flow wurde ausgelöst. **Was tun?** Öffne die Eingabe im Stapel > 70 %. Die Intention „Reklamation" ist hervorgehoben, passt inhaltlich aber nicht. Suche im Filterfeld nach „Stornierung" und klicke dort auf **„Ausdruck zuordnen"**. So lernt der space.vars.TERM\_AI\_AGENT, die Absicht künftig korrekt einzuordnen. *** ### Best Practices * **Regelmäßig bearbeiten:** Bearbeite die Stapel regelmäßig. So verbessert sich die Erkennungsqualität deines space.vars.TERM\_AI\_AGENTs kontinuierlich. * **Unzugeordnete Eingaben prüfen:** Eingaben, die keiner Intention zugeordnet wurden, können wertvolle Hinweise liefern: Sie können außerhalb des Zuständigkeitsbereichs liegen, nachträglich aufgenommen werden oder als Grundlage für neue Intentionen dienen. * **Nur passende Ausdrücke zuordnen:** Ordne ausschließlich Eingaben zu, die inhaltlich wirklich zu einer Intention passen. Bei Eingaben, die zu mehreren Intentionen passen könnten, ist es besser, keine Zuordnung vorzunehmen – sonst wird die Intention verwässert und die Erkennungsqualität sinkt. * **Auch hohe Übereinstimmungen prüfen:** Eingaben im Stapel > 70 % wurden zwar erkannt, können aber trotzdem falsch zugeordnet sein. Prüfe diese regelmäßig – sie können sowohl Fehler enthalten als auch als besonders gute Beispiele dienen. * **Nachbearbeitung konsequent nutzen:** Falsch erkannte oder nicht erkannte Eingaben manuell zuzuordnen ist eine der effektivsten Methoden, um deinen space.vars.TERM\_AI\_AGENT gezielt zu verbessern. Je mehr reale Benutzereingaben korrekt zugeordnet sind, desto zuverlässiger reagiert der space.vars.TERM\_AI\_AGENT künftig. # Entitäten labeln Beim Labeln markierst du Textstellen in Trainingsbeispielen, damit der AI Agent diese Entitäten in zukünftigen Eingaben automatisch erkennt und zuordnet. ### Wo finde ich „Entitäten labeln"? Den Bereich „Entitäten labeln" findest du unter: `AI Agent → Optimierung → Entitäten labeln` *** ### Erklärung – Was genau ist „Entitäten labeln"? Wenn Nutzer mit deinem space.vars.TERM\_AI\_AGENT schreiben, versucht das System, bestimmte Begriffe in der Eingabe automatisch zu erkennen – zum Beispiel Ortsnamen, Daten oder IBANs. Damit das funktioniert, muss das Modell zuvor an Beispielen lernen, wie solche Begriffe aussehen. Genau das passiert beim Labeln: Du markierst in bestehenden Beispielen die relevanten Textstellen und weist ihnen eine [Entität](/epic-ai-platform/epic-ai-platform/ai-agent/build/entitaten) zu – ähnlich wie mit einem Textmarker. Auf Basis dieser Markierungen trainiert das System, die entsprechenden Begriffe in echten Nutzereingaben zu erkennen. Das Labeln ist ausschließlich für Beispiele innerhalb von Intentionen möglich. Losgelöste Beispiele – ohne Zugehörigkeit zu einer Intention – gibt es nicht. Markierungen für Entitäten ohne erlernte Komponente sind zwar technisch möglich, haben aber keine Auswirkung auf die Erkennung oder das Verhalten des space.vars.TERM\_AI\_AGENTs. Damit eine Markierung wirksam ist, muss die Entität eine [Erlernte Komponente](/epic-ai-platform/epic-ai-platform/ai-agent/build/entitaten#erlernte-komponenten) besitzen. *** ### Verwendung – Was kann man mit „Entitäten labeln" machen? #### Sprache auswählen Lege zunächst die gewünschte Sprache fest. Nach der Auswahl werden alle Beispiele dieser Sprache angezeigt, in denen du Entitäten markieren kannst. #### Entitäten in Beispielen markieren Innerhalb der angezeigten Beispiele kannst du einzelne Textstellen direkt anklicken und markieren. Wähle anschließend die passende Entität aus der Liste auf der rechten Seite aus. Rechts im Panel sind alle im System hinterlegten Entitäten farbig dargestellt. Wähle eine Entität aus und markiere dann den gewünschten Text innerhalb eines Beispiels. #### Markierungen entfernen Bereits markierte Entitäten lassen sich jederzeit wieder entfernen. Klicke dazu auf das **X**-Symbol, das beim Hover über die Markierung erscheint. #### Beispiele laden In der Übersicht werden stets **25 Beispiele** aus allen Intentionen angezeigt, sortiert nach Erstellungsdatum. Über die Schaltfläche **„Weitere Einträge laden"** kannst du zusätzliche Beispiele einblenden. {% hint style="info" %} Ein direkter Rückschluss darauf, zu welcher Intention ein Beispiel gehört, ist in dieser Ansicht nicht möglich. {% endhint %} *** ### Verwaltung – Beispiele hinzufügen und löschen #### Neues Beispiel hinzufügen Im oberen Bereich der Seite findest du den Abschnitt **„Neues Beispiel hinzufügen"**. 1. Wähle im Feld **„Intention"** die passende Intention aus dem Dropdown aus. 2. Trage im Feld **„Beispiel"** den Beispieltext ein. 3. Klicke auf **„Hinzufügen"**. Das neue Beispiel erscheint in der Liste und kann anschließend direkt mit Entitäten gelabelt werden. #### Beispiel löschen Jedes Beispiel in der Liste enthält ein **Papierkorb-Symbol**. Klicke darauf, um das Beispiel zu entfernen. {% hint style="warning" %} Beim Löschen wird nicht angezeigt, zu welcher Intention das jeweilige Beispiel ursprünglich gehörte. Das Löschen kann nicht rückgängig gemacht werden. {% endhint %} *** ### Beispiel #### Entität „Ort" in einem Buchungsbeispiel labeln **Szenario:** Dein space.vars.TERM\_AI\_AGENT soll Ortsnamen in Buchungsanfragen automatisch erkennen. 1. Navigiere zu `AI Agent → Optimierung → Entitäten labeln`. 2. Wähle die gewünschte Sprache aus (z. B. Deutsch). 3. Suche in der Beispielliste nach einem passenden Beispiel – oder füge ein neues hinzu: * Intention: `Ticketbuchung` * Beispiel: `Ich möchte ein Ticket nach Berlin buchen.` 4. Klicke auf das Wort **„Berlin"** im Beispieltext, um es zu markieren. 5. Wähle rechts im Panel die Entität **„Ort"** aus. 6. Die Markierung ist gesetzt. Das Modell lernt beim nächsten Training, dass „Berlin" ein Ortsname ist. **Ergebnis:** Zukünftige Eingaben wie „Ich brauche ein Ticket nach Hamburg" werden vom space.vars.TERM\_AI\_AGENT automatisch mit der Entität „Ort" verknüpft. *** ### Best Practices * **Regelmäßig labeln:** Markiere Entitäten kontinuierlich in neuen und bestehenden Beispielen. Jede neue Markierung verbessert die Erkennungsleistung des space.vars.TERM\_AI\_AGENTs. * **Nur relevante Stellen markieren:** Markiere ausschließlich Textstellen, die tatsächlich zur erlernten Komponente der Entität gehören. Unklare oder fehlerhafte Markierungen können die Erkennung verfälschen. * **Erlernte Komponenten beachten:** Stelle sicher, dass die Entität eine erlernte Komponente besitzt, bevor du sie verwendest. Entitäten ohne erlernte Komponente haben keinen Einfluss auf das Verhalten des space.vars.TERM\_AI\_AGENTs. * **Alte oder fehlerhafte Labels entfernen:** Entferne nicht mehr relevante oder falsch gesetzte Markierungen über das **X**-Symbol. Eine saubere Trainingsbasis führt zu besseren Erkennungsergebnissen. * **Neue Beispiele ergänzen:** Wenn bestimmte Eingabetypen oder Formulierungen bisher nicht korrekt erkannt werden, füge gezielt neue Beispiele mit passenden Entitätsmarkierungen hinzu. * **Beispiele regelmäßig prüfen:** Kontrolliere gelabelte Beispiele auf Richtigkeit und Relevanz – insbesondere nach Änderungen an Intentionen oder Entitätsdefinitionen. # Modelle Das AI-Modell ist die Grundlage für die Sprachverständnis-Fähigkeiten deines AI Agents. Es wird auf Basis deiner Intentionen und Entitäten trainiert. ### Wo finde ich das? Du findest die Modelle-Übersicht unter `Optimierung → Modelle`. Zusätzlich wird der aktuelle Status des Modells auch in der Seitennavigation angezeigt. Dort siehst du auf einen Blick, ob ein Training erforderlich ist, gerade läuft oder abgeschlossen wurde – inklusive Fortschrittsanzeige während eines laufenden Trainings. *** ### Erklärung – Was genau sind space.vars.TERM\_AI-Modelle? Ein space.vars.TERM\_AI-Modell wird aus den von dir definierten Intentionen und Entitäten erstellt. Durch das Training lernt das Modell, Nutzereingaben den richtigen Intentionen zuzuordnen und relevante Entitäten wie z. B. eine IBAN, ein Datum oder eine Telefonnummer zu erkennen. Jedes Mal, wenn du Änderungen an deinen Intentionen oder Entitäten vornimmst, muss ein neues Modell trainiert werden, damit diese Änderungen wirksam werden. Änderungen am Flow selbst erfordern kein neues Training. #### Trainings- und Evaluations-Phase Das Training eines Modells besteht aus zwei Phasen: * **Training:** In dieser Phase lernt das Modell anhand deiner Daten. Der Fortschritt wird als Prozentanzeige dargestellt. * **Evaluation:** Nach dem Training wird das [Modell automatisch ausgewertet](/epic-ai-platform/epic-ai-platform/ai-agent/daten/modelle/auswertung), um die Qualität der Erkennung sicherzustellen. #### Modellstatus In der Modelle-Übersicht und in der Navigation wird der aktuelle Status deines Modells angezeigt. Folgende Status sind möglich: * **Training erforderlich:** Du hast Änderungen an Intentionen oder Entitäten vorgenommen, die ein neues Training erfordern. * **Training läuft:** Das Modell wird gerade trainiert. Du kannst den Fortschritt in der Karte und in der Navigation verfolgen. * **Modell wird evaluiert:** Das Training ist abgeschlossen und die Evaluations-Phase läuft. * **Training abgeschlossen:** Das Modell wurde erfolgreich trainiert und steht zur Verfügung. * **Training fehlgeschlagen:** Das Training konnte nicht erfolgreich abgeschlossen werden. In diesem Fall kannst du einfach ein neues Training starten. *** ### Verwendung – Neues Modell trainieren Das Training muss immer manuell gestartet werden. Ein automatisches Training findet nicht statt. #### Training starten 1. Navigiere zu `Optimierung → Modelle`. 2. Wenn Änderungen an Intentionen oder Entitäten vorgenommen wurden, siehst du den Hinweis „Training erforderlich" mit einer kurzen Erklärung. 3. Klicke auf den Button **„Neues Modell trainieren"**, um das Training zu starten. 4. Das Training beginnt und der Fortschritt wird sowohl in der Modelle-Übersicht als auch in der Navigation in Echtzeit angezeigt. {% hint style="info" %} Es kann immer nur ein Modell gleichzeitig trainiert werden. Du kannst während des Trainings jedoch ganz normal weiter an deinem space.vars.TERM\_AI\_AGENT arbeiten. Das Modelltraining kann – je nach Datenmenge – wenige Minuten bis einige Stunden in Anspruch nehmen. {% endhint %} #### Nach dem Training Sobald das Training und die Evaluation erfolgreich abgeschlossen sind, wechselt der Status auf „Training abgeschlossen". Das trainierte Modell wird anschließend verwendet und kann über die [Versionen](/epic-ai-platform/epic-ai-platform/ai-agent/versionen-and-bereitstellungsumgebungen) verwaltet werden. #### Wenn ein Training fehlschlägt Sollte ein Training fehlschlagen, wird dir der Status „Training fehlgeschlagen" angezeigt. In diesem Fall kannst du einfach ein neues Training starten. Dein space.vars.TERM\_AI\_AGENT arbeitet in der Zwischenzeit weiterhin mit dem zuletzt erfolgreich trainierten Modell. ### Modellverlauf In der Modelle-Übersicht findest du unterhalb der Statuskarte eine Tabelle mit allen bisherigen Trainingsläufen. Jeder Eintrag zeigt: * **ID:** Eine eindeutige Kennung des Trainings. * **Status:** Der Abschlussstatus (z. B. „Abgeschlossen"). * **Erstellt am:** Datum und Uhrzeit, zu der das Training gestartet wurde. * **Zuletzt aktualisiert am:** Datum und Uhrzeit der letzten Statusänderung. * **Trainingszeit:** Die Gesamtdauer des Trainings. {% hint style="info" %} Ältere Modellversionen werden nach einer gewissen Zeit der Inaktivität automatisch gelöscht. Du kannst verschiedene Versionen über die [Versionsverwaltung](/epic-ai-platform/epic-ai-platform/ai-agent/versionen-and-bereitstellungsumgebungen) nutzen. {% endhint %} *** ### Best Practices * **Regelmäßig trainieren:** Starte nach jeder größeren Änderung an deinen Intentionen oder Entitäten ein neues Training, damit dein space.vars.TERM\_AI\_AGENT immer auf dem aktuellen Stand arbeitet. * **Änderungen bündeln:** Wenn du mehrere Anpassungen an Intentionen oder Entitäten planst, nimm alle Änderungen zuerst vor und starte dann ein einziges Training. Das spart Zeit, da immer nur ein Training gleichzeitig laufen kann. # Auswertung Die Modell-Bewertung zeigt dir, wie gut dein trainiertes AI-Modell Intentionen und Entitäten erkennt. ### Wo finde ich das? 1. Navigiere zu `Optimierung → Modelle`. 2. Klicke in der Modellverlauf-Tabelle auf das gewünschte Modell. 3. Die Modell-Bewertung öffnet sich mit der Übersichtsseite. ### Erklärung – Was genau ist die Modell-Bewertung? Die Modell-Bewertung gibt dir einen detaillierten Einblick, wie zuverlässig dein space.vars.TERM\_AI-Modell arbeitet. Dabei werden die Erkennungsleistungen für Intentionen und Entitäten separat ausgewertet. Über den Filter **„Modelltyp"** kannst du zwischen der Auswertung für Intentionen und Entitäten wechseln. Die Bewertung ist in vier Bereiche (Tabs) unterteilt: * **Übersicht:** Zeigt die wichtigsten Kennzahlen auf einen Blick. * **Performance:** Listet die Erkennungsleistung für jede einzelne Intention bzw. Entität auf. * **Datenverteilung:** Zeigt, wie deine Trainingsdaten auf die einzelnen Intentionen bzw. Entitäten verteilt sind. * **Confusion Matrix:** Visualisiert, welche Intentionen bzw. Entitäten das Modell verwechselt. #### Die drei Kennzahlen verstehen In der Modell-Bewertung begegnen dir drei zentrale Kennzahlen. Alle drei Werte liegen zwischen 0 % und 100 % – je höher, desto besser. * **Precision (Präzision):** Gibt an, wie oft das Modell richtig liegt, wenn es eine bestimmte Intention oder Entität erkennt. Eine hohe Precision bedeutet: Wenn das Modell sagt „Das ist Intention X", dann stimmt das in den meisten Fällen auch. Einfach gesagt: Wie verlässlich sind die Treffer? * **Recall:** Gibt an, wie gut das Modell alle tatsächlichen Fälle einer Intention oder Entität findet. Ein hoher Recall bedeutet: Das Modell verpasst nur wenige relevante Eingaben. Einfach gesagt: Wie vollständig werden die Fälle erkannt? * **F1-Score:** Ist der Mittelwert aus Precision und Recall. Er fasst beide Werte in einer einzigen Kennzahl zusammen. Ein hoher F1-Score bedeutet, dass das Modell sowohl verlässlich als auch vollständig erkennt. Der F1-Score eignet sich daher am besten als Gesamtbewertung der Erkennungsqualität. ### Die vier Bereiche im Detail #### Übersicht Die Übersicht zeigt die drei Kennzahlen (F1-Score, Precision und Recall) als Diagramme für alle Intentionen bzw. Entitäten zusammengefasst. Du siehst hier auf einen Blick, wie gut dein Modell insgesamt abschneidet. Dieser Bereich eignet sich besonders, um nach einem Training schnell einzuschätzen, ob die Erkennungsqualität zufriedenstellend ist. #### Performance Der Performance-Tab zeigt eine detaillierte Tabelle mit den Erkennungswerten für jede einzelne Intention bzw. Entität. Für jeden Eintrag siehst du: * **Name:** Der Name der Intention bzw. Entität. * **F1:** Der F1-Score für diese Intention bzw. Entität. * **Precision:** Die Präzision für diese Intention bzw. Entität. * **Recall:** Der Recall für diese Intention bzw. Entität. * **TP (True Positives):** Anzahl der Fälle, die korrekt als diese Intention erkannt wurden. * **TN (True Negatives):** Anzahl der Fälle, die korrekt als eine andere Intention erkannt wurden. * **FP (False Positives):** Anzahl der Fälle, die fälschlicherweise als diese Intention erkannt wurden, obwohl sie einer anderen Intention zugehören. * **FN (False Negatives):** Anzahl der Fälle, die zu dieser Intention gehören, aber fälschlicherweise einer anderen zugeordnet wurden. Dieser Bereich hilft dir, gezielt die Intentionen oder Entitäten zu identifizieren, bei denen das Modell Schwächen zeigt. Intentionen mit niedrigen Werten sollten überarbeitet werden – z. B. durch zusätzliche [Trainingsbeispiele](/epic-ai-platform/epic-ai-platform/ai-agent/build/intentionen). #### Datenverteilung Der Datenverteilungs-Tab zeigt, wie viele Trainingsbeispiele pro Intention bzw. Entität vorhanden sind und wie diese auf Trainings- und Testdaten aufgeteilt wurden. Für jeden Eintrag siehst du: * **Name:** Der Name der Intention bzw. Entität. * **Training:** Anzahl der Beispiele, die für das Training verwendet wurden. * **Test:** Anzahl der Beispiele, die für die Evaluation verwendet wurden. * **Zusammen:** Gesamtanzahl der verfügbaren Beispiele. Am oberen Rand wird zusätzlich die Gesamtzahl der Trainings- und Testdaten mit prozentualem Anteil angezeigt. {% hint style="info" %} Eine ungleiche Verteilung der Trainingsdaten kann die Erkennungsqualität beeinflussen. Intentionen oder Entitäten mit sehr wenigen Beispielen werden tendenziell schlechter erkannt. {% endhint %} #### Confusion Matrix Die Confusion Matrix zeigt in einer Matrix-Darstellung, wie das Modell die einzelnen Intentionen bzw. Entitäten einander zuordnet. Sie macht sichtbar, welche Intentionen oder Entitäten das Modell miteinander verwechselt. So liest du die Matrix: Jede Zeile steht für die tatsächliche Intention, jede Spalte für die vom Modell vorhergesagte Intention. Ein Wert auf der Diagonale (z. B. grün hinterlegt) bedeutet, dass das Modell korrekt erkannt hat. Werte außerhalb der Diagonale (z. B. rot oder gelb hinterlegt) zeigen Verwechslungen an. Über den Filter **„Format"** kannst du zwischen zwei Darstellungen wechseln: * **Normalisiert:** Zeigt die Werte als Prozentangaben (0 bis 1). So siehst du den Anteil der korrekt bzw. falsch zugeordneten Fälle. * **Absolute Anzahl:** Zeigt die tatsächliche Anzahl der Fälle. So siehst du die konkreten Zahlen. {% hint style="info" %} Nutze die normalisierte Ansicht, um Verwechslungsmuster zu erkennen, und die absolute Ansicht, um die tatsächlichen Fallzahlen zu prüfen. {% endhint %} ### Best Practices * **F1-Score als Leitwert nutzen:** Der F1-Score gibt dir die zuverlässigste Gesamtbewertung. Achte darauf, dass er für deine wichtigsten Intentionen möglichst hoch ist. * **Schwache Intentionen gezielt verbessern:** Prüfe im Performance-Tab, welche Intentionen niedrige Werte haben. Häufig hilft es, zusätzliche und vielfältigere [Trainingsbeispiele](/epic-ai-platform/epic-ai-platform/ai-agent/build/intentionen) hinzuzufügen. * **Verwechslungen analysieren:** Wenn die Confusion Matrix zeigt, dass zwei Intentionen häufig verwechselt werden, sind ihre Trainingsbeispiele möglicherweise zu ähnlich. Überarbeite in diesem Fall die betroffenen Intentionen, damit sie sich klarer voneinander unterscheiden. * **Auf ausgewogene Datenverteilung achten:** Intentionen mit deutlich weniger Trainingsbeispielen werden oft schlechter erkannt. Versuche, die Anzahl der Beispiele pro Intention möglichst gleichmäßig zu halten. * **Beide Modelltypen prüfen:** Vergiss nicht, die Auswertung sowohl für Intentionen als auch für Entitäten zu kontrollieren. Wechsle dazu einfach über den Modelltyp-Filter. # Statistiken Die Statistiken geben dir einen detaillierten Überblick über die Nutzung und Performance deiner AI Agents. Du kannst Konversationen, Interaktionen, erkannte Intentionen und weitere Kennzahlen auswerte ### Wo finde ich die Statistiken? Die Statistiken erreichst du über den Menüpunkt `Statistiken` in der linken Seitennavigation. Dort findest du folgende Unterpunkte: * **Übersicht** – kanalübergreifende Zusammenfassung * **Einzelne Kanäle** – pro Kanal (Chat oder Voice) ein eigener Bericht * **Inbox Statistiken** – Auswertung zur Nutzung der Inbox durch menschliche Agenten Wenn du mehrere Chat- oder Voice-Kanäle eingerichtet hast, wird für jeden Kanal ein eigener Bericht angezeigt. ### Zeitraum auswählen Für alle Statistikberichte kannst du den Zeitraum frei wählen. Klicke dazu auf das Datumsfeld oben rechts. Es öffnet sich ein Kalender mit den folgenden Schnellauswahl-Optionen: * Heute * Gestern * Letzte 7 Tage * Letzte 14 Tage * Letzte 28 Tage * Dieser Monat * Letzter Monat * Letzte 3 Monate Alternativ kannst du über den Kalender einen individuellen Zeitraum definieren. Bestätige deine Auswahl mit „Übernehmen". {% hint style="info" %} Alle prozentualen Veränderungen (z. B. „+3,19 %") beziehen sich auf den Vergleich mit dem gleich langen Vorzeitraum. Wählst du beispielsweise die letzten 7 Tage aus, wird mit den 7 Tagen davor verglichen. {% endhint %} ### Bezeichnungen ausgeführter Schritte In den Statistiken zu ausgeführten Schritten wird zu jedem Eintrag die Bezeichnung des jeweiligen Schritts angezeigt. So erkennst du auf einen Blick, welcher Schritt ausgeführt wurde. Das gilt für alle Schritte, die im space.vars.TERM\_FLOW\_BUILDER existieren. Die Bezeichnung wird zum Zeitpunkt der Ausführung gespeichert. Wird ein Schritt später umbenannt, bleibt in älteren Statistik-Einträgen der vorherige Name erhalten. Die zugehörige ID bleibt unverändert und ermöglicht eine eindeutige Zuordnung. Kann keine Bezeichnung ermittelt werden, wird der Eintrag in den Plattform-Statistiken als „Unbenannter Schritt" bzw. „Unbenannte Intention" dargestellt. Wurde ein Schritt zwischenzeitlich gelöscht, wird er in den Statistiken weiterhin mit seiner zuletzt bekannten Bezeichnung und mit einem Badge „Gelöscht" dargestellt. ### Übersicht – Alle Kanäle Die Übersicht zeigt die wichtigsten Kennzahlen über alle Kanäle hinweg. Sie eignet sich, um schnell den Gesamtstatus deines space.vars.TERM\_AI\_AGENTs zu erfassen. {% hint style="info" %} Hat ein Schritt in verschiedenen Bereitstellungsumgebungen (z. B. Test oder Prod) unterschiedliche Namen, richtet sich der in der Übersicht angezeigte Name nach der Bereitstellungsumgebung der aktuellsten Konversation. War die letzte Konversation in der Umgebung „Test", steht dort z. B. „Begrüßung Test". War sie in „Prod", steht dort „Begrüßung Prod". {% endhint %} #### Kennzahlen-Karten * **Konversationen** – Gesamtanzahl aller Gespräche (Chats und Anrufe) im gewählten Zeitraum. * **Interaktionen** – Gesamtanzahl aller Interaktionen. Eine Interaktion ist eine eingehende Nachricht eines Nutzers inklusive der zugehörigen Verarbeitung durch den space.vars.TERM\_AI\_AGENT. Eine Konversation kann mehrere Interaktionen enthalten. * **Nachrichten** – Aufschlüsselung der Nachrichten in drei Werte: Empfangen (vom Nutzer), Versandt (vom space.vars.TERM\_AI\_AGENT) und Gesamt. Jede Kennzahlen-Karte zeigt zusätzlich die absolute und prozentuale Veränderung im Vergleich zum Vorzeitraum an. #### Diagramme und Auswertungen * **Konversationen im Zeitverlauf** – Liniendiagramm, das zeigt, wie sich die Anzahl der Konversationen über den gewählten Zeitraum verteilt. * **Intentionen erkannt** – Auflistung der am häufigsten erkannten Intentionen mit absoluter Anzahl und prozentualem Anteil. Über „Alle anzeigen" lässt sich die vollständige Liste aufrufen. * **Nachrichten im Zeitverlauf** – Liniendiagramm mit drei Linien: Gesamt, Gesendet und Empfangen. * **Nachrichten pro Konversation (Mittelwert)** – Durchschnittliche Anzahl der Nachrichten pro Gespräch. * **Interaktionen im Zeitverlauf** – Liniendiagramm zur zeitlichen Verteilung der Interaktionen. * **Intent Score (Mittelwert)** – Durchschnittliche Konfidenz der Intenterkennung in Prozent. Ein hoher Wert bedeutet, dass der space.vars.TERM\_AI\_AGENT die Absichten der Nutzer mit hoher Sicherheit erkennt. * **Schritte ausgeführt** – Zeigt, welche Schritte im space.vars.TERM\_FLOW\_BUILDER wie häufig durchlaufen wurden – inklusive prozentualem Anteil. * **Konversationen pro Kanaltyp** – Verteilung der Konversationen auf die verschiedenen Kanäle (z. B. WhatsApp, Telefonie) mit absoluter Anzahl und Prozentwert. * **Sprachen der Konversationen** – Zeigt die Konversationssprache (in der Telefonie wird diese durch die Ländervorwahl ermittelt). {% hint style="info" %} Wenn für eine Kennzahl keine Daten vorliegen, wird die entsprechende Karte mit „Keine Daten" angezeigt. {% endhint %} ### Chat-Kanal-Berichte Für jeden Chat-Kanal gibt es einen eigenen Bericht. Dieser enthält dieselben Kennzahlen wie die Übersicht, bezieht sich jedoch ausschließlich auf den jeweiligen Kanal. #### Enthaltene Kennzahlen * Konversationen (Gesamt, Veränderung zum Vorzeitraum) * Interaktionen (Gesamt, Veränderung zum Vorzeitraum) * Nachrichten (Empfangen, Versandt, Gesamt – jeweils mit Veränderung) * Konversationen im Zeitverlauf * Intentionen erkannt * Nachrichten im Zeitverlauf (Gesamt, Gesendet, Empfangen) * Nachrichten pro Konversation (Mittelwert) * Interaktionen im Zeitverlauf * Intent Score (Mittelwert) * Schritte ausgeführt * Sprachen der Konversationen Der Chat-Kanal-Bericht enthält im Gegensatz zur Übersicht keine Aufschlüsselung nach Kanaltyp, da er sich bereits auf einen einzelnen Kanal bezieht. ### Voice-Kanal-Berichte Für jeden Voice-Kanal gibt es einen eigenen Bericht. Dieser enthält zusätzlich zu einigen der bekannten Kennzahlen auch voice-spezifische Metriken. #### Voice-spezifische Kennzahlen * **Gesprächsdauer** – Gesamtdauer aller Gespräche, angezeigt in Stunden (HH:MM) und Minuten (MM:SS), jeweils mit Veränderung zum Vorzeitraum. * **Benutzereingaben (Mittelwert)** – Durchschnittliche Anzahl der Spracheingaben pro Gespräch. * **Gesprächsdauer (Mittelwert)** – Durchschnittliche Dauer eines einzelnen Gesprächs im Format MM:SS. * **Ausgangsschritte** – Die Schritte im space.vars.TERM\_FLOW\_BUILDER, an denen Gespräche beendet wurden. Zeigt den jeweiligen Schritt mit absoluter Anzahl und prozentualem Anteil. * **Gesprächsende** – Zeigt, wie viele Gespräche vom space.vars.TERM\_AI\_AGENT und wie viele vom Nutzer beendet wurden. * **Weiterleitungsziele** – Zeigt, an welche Ziele Gespräche weitergeleitet wurden. #### Weitere Kennzahlen im Voice-Bericht * Konversationen (Gesamt, Veränderung zum Vorzeitraum) * Interaktionen (Gesamt, Veränderung zum Vorzeitraum) * Konversationen im Zeitverlauf * Intentionen erkannt * Intent Score (Mittelwert) * Interaktionen im Zeitverlauf * Schritte ausgeführt ### Inbox Statistiken Die Inbox Statistiken zeigen dir, wie die Inbox von deinem Team genutzt wird. Hier siehst du, wie viele Gespräche an menschliche Agenten weitergeleitet wurden und wie diese bearbeitet werden. #### Enthaltene Kennzahlen * **Weitergeleitet an Agenten:** Gesamtanzahl der Konversationen, die an menschliche Agenten übergeben wurden. * **Agenten Performance:** Tabellarische Übersicht pro Agent mit Anzahl der bearbeiteten Konversationen und der durchschnittlichen Bearbeitungszeit (Ø Zeit in Minuten). * **Annahme-Status:** Aufschlüsselung in „Angenommen" und „Nicht angenommen", um zu sehen, wie viele weitergeleitete Gespräche tatsächlich von Agenten übernommen wurden. * **Ø Zeit bis Beitritt:** Durchschnittliche Wartezeit (in Minuten und Sekunden), bis ein Agent dem Gespräch beigetreten ist. * **Agenten Online:** Zeigt die aktuell in der Inbox aktiven Agenten (Mitarbeitende) mit dem Zeitpunkt „Zuletzt gesehen". Ist der Abwesenheitsmodus eines Mitarbeitenden aktiviert, wird er nicht als online angezeigt. ### Datenexport Die Rohdaten aller Events können exportiert werden. Eine ausführliche Anleitung dazu findest du im separaten Artikel zum Datenexport. [Mehr über den Datenexport erfahren](/epic-ai-platform/epic-ai-platform/ai-agent/statistiken/export-and-datenmodell) ### Best Practices * **Regelmäßig auswerten:** Prüfe die Statistiken mindestens wöchentlich, um Trends frühzeitig zu erkennen – etwa steigende Fallback-Raten oder sinkende Intent Scores. * **Intent Score im Blick behalten:** Ein hoher Intent Score (z. B. über 95 %) zeigt, dass dein space.vars.TERM\_AI\_AGENT die Nutzerabsichten zuverlässig erkennt. Sinkt der Wert, solltest du die Trainingsdaten und Intentionen überprüfen. * **Ausgangsschritte bei Voice-Kanälen analysieren:** Wenn viele Gespräche an unerwarteten Stellen beendet werden, kann das auf Probleme im Flow hindeuten. Prüfe in diesem Fall die betroffenen Schritte im space.vars.TERM\_FLOW\_BUILDER. * **Übersicht vs. Einzelberichte nutzen:** Verwende die Übersicht für einen schnellen Gesamteindruck. Für die detaillierte Analyse eines bestimmten Kanals wechsle in den jeweiligen Einzelbericht. * **Inbox-Performance optimieren:** Achte auf die Kennzahlen „Nicht angenommen" und „Ø Zeit bis Beitritt" in den Inbox Statistiken. Hohe Werte können darauf hindeuten, dass mehr Agenten benötigt werden oder die Weiterleitung optimiert werden sollte. # Export & Datenmodell Der Export ermöglicht es dir, die Rohdaten der Statistiken eines AI Agents als CSV-Datei herunterzuladen. So kannst du die Daten extern weiterverarbeiten, analysieren oder archivieren. ## Export ### Wo finde ich das? Navigiere zu `Stats → Export`. ### Erklärung – Was genau ist der Export? Der Export liefert die Rohdaten der Statistiken eines space.vars.TERM\_AI\_AGENTs für einen ausgewählten Zeitraum. Die Daten werden als CSV-Datei bereitgestellt. Eine CSV-Datei ist ein einfaches Tabellenformat, das sich mit gängigen Tools wie Microsoft Excel, Google Sheets oder Datenanalyse-Software öffnen und weiterverarbeiten lässt. *** ### Verwendung – Export durchführen #### Zeitraum auswählen und exportieren 1. Navigiere zu `Stats → Export`. 2. Klicke auf das Datumsfeld, um den Kalender zu öffnen. 3. Wähle einen Starttag und einen Endtag aus. * Zur schnellen Auswahl stehen links vordefinierte Zeiträume bereit: z. B. „Gestern", „Letzte 7 Tage", „Letzter Monat" oder „Letzte 3 Monate". * Der gewählte Zeitraum wird im Kalender farblich hervorgehoben. 4. Bestätige die Auswahl mit „Übernehmen". 5. Klicke auf „Exportieren". Der Export wird nun verarbeitet. Während der Verarbeitung erscheint ein Ladeindikator mit dem Hinweis, die Seite nicht zu schließen. {% hint style="info" %} Schließe das Fenster nicht, solange der Export noch läuft. Der Prozess kann einige Minuten in Anspruch nehmen. {% endhint %} #### Download-Link aufrufen Sobald der Export abgeschlossen ist, wird ein Download-Link angezeigt. Dieser ist für 15 Minuten gültig. Lade die Datei daher unmittelbar nach Erscheinen des Links herunter. Der Exportzeitraum ist auf maximal drei Monate begrenzt. ### Best Practices * Nutze die vordefinierten Zeiträume (z. B. „Letzter Monat") für regelmäßige, vergleichbare Auswertungen. * Lade die CSV-Datei unmittelbar nach Erscheinen des Download-Links herunter, da der Link nach 15 Minuten abläuft. *** ## Datenmodell
Event-Tabelleevent_idtypetimestampbot_idconversation_idcontact_idversion_idpayloadenvironmentchannel_typechannel_idlabelflow_label
BeschreibungID des Events die festlegt, dass jeder Eintrag einzigartig istDer Typ des Events legt fest, welche Art von Event stattfandZeitpunkt des EventsID des space.vars.TERM_AI_AGENTsID der KonversationID des KontaktsID der space.vars.TERM_AI_AGENT-VersionDer aufgefasste Inhalt des EventsUmgebung, in der das Event stattfand (Test, Produktion oder Entwicklung)Typ des verwendeten ChannelsID des verwendeten ChannelsName des ausgeführten SchrittsName des Flows, in dem der Schritt sich befindet
DatentypuuidCALL_START | CALL_END | CONTACT_CREATE | CONVERSATION_CREATE | ENTITY_DETECT | INTENT_DETECT | MESSAGE_SEND | MESSAGE_RECEIVE | MESSAGE_STATUS_UPDATE | ORGANIZATION_CREATE | CALL_TRANSFER | INTERACTION | STEP_EXECUTE | STEP_CONDITION_EXECUTE | STEP_SPLIT_EXECUTE | STEP_CONTEXT_EXECUTE | STEP_APP_MODULE_EXECUTE | CONVERSATION_TAG_ADDED | CONVERSATION_OPENED | CONVERSATION_CLOSED | REQUESTED_AGENT_HANDOVERtimestampstringstringstringstringJSON stringstringstringstringstringstring
Beschreibung des Event-Typen und des Payloads

Dokumentiert den Start eines Anrufs.

Beinhaltet:

  • die Rufnummer inklusive Ländervorwahl
  • ob es sich um eine mobile Nummer handelt
CALL_START
{
  "callStart": {
    "countryCode": "number",
    "isMobile": "boolean",
    "calledNumber": "string"
  },
}
Dokumentiert das Ende eines Anrufs.
Beinhaltet auch den Grund und die Art des Anruf-Endes.
Falls es sich um einen Transfer handelte, wird das Transferziel angegeben.		CALL_END
{
  "callEnd": {
    "reason": "string",
    "disconnectedBy": "string",
    "transferTarget": "string"
  }
}
Dokumentiert das Erstellen eines Kontakts und legt dessen ID fest.CONTACT_CREATE/
Dokumentiert die Erstellung einer Konversation und deren Sprache.CONVERSATION_CREATE
{
  "conversationCreate": {
    "language": "string"
  }
}
Dokumentiert die Erkennung einer Entität und deren ID. Gibt Auskunft, mit welcher Genauigkeit diese getroffen wurde.ENTITY_DETECT
{
  "entityDetect": {
    "entityId": "string",
    "score": "number"
  }
}
Dokumentiert die Erkennung einer Intention und deren ID. Gibt Auskunft, mit welcher Genauigkeit diese getroffen wurde.INTENT_DETECT
{
  "intentDetect": {
    "intentId": "string",
    "score": "number"
  }
}

Dokumentiert den Versand einer Nachricht vom Agenten oder space.vars.TERM_AI_AGENT.

Beinhaltet:

  • die ID der Nachricht
  • die Länge der Nachricht
  • die Größe (falls Datei)
  • die ID des Agenten (falls null, dann ist die Nachricht vom space.vars.TERM_AI_AGENT)
  • den Typ der Nachricht
MESSAGE_SEND
{
  "messageSend": {
    "messageId": "string",
    "type": "string",
    "operatorId": "string",
    "length": "number",
    "size": "number"
  }
}

Dokumentiert den Empfang einer Nachricht vom User.

Beinhaltet:

  • die ID der Nachricht
  • die Länge der Nachricht
  • die Größe (falls Datei)
  • den Typ der Nachricht
MESSAGE_RECEIVE
{
  "messageReceive": {
    "messageId": "string",
    "type": "string",
    "length": "number",
    "size": "number"
  }
}
Dokumentiert den Status einer Nachricht:
0 = SENT
1 = READ
2 = DELIVERED
3 = FAILED
-1 = UNRECOGNIZED		MESSAGE_STATUS_UPDATE
{
  "messageStatusUpdate": {
    "messageId": "string",
    "status": "string"
  }
}
Dokumentiert das Erstellen einer Organisation und deren ID.ORGANIZATION_CREATE
 {
  "organizationCreate": {
    "organizationId": "string"
  }
}
Dokumentiert den Transfer eines Anrufs und das Transferziel.CALL_TRANSFER
 {
  "callTransfer": {
    "target": "string"
  }
}
Dokumentiert die Antworten der KI-Einstellung "Generative KI" (mit RAG).GENERATIVE_AI_DETECT
{"generativeAiDetect"     {"sourceIds": [] ,"trigger":"question_answering"}
}
/INTERACTION/

Dokumentiert die Ausführung von Schritten im space.vars.TERM_AI_AGENT.

Beinhaltet:

  • die ID des Flows
  • die ID des Schrittes
  • den Typ des Schrittes
STEP_EXECUTE
{
  "stepExecute": {
    "flowId": "string",
    "stepId": "string",
    "type": "string"
  }
}

Dokumentiert die Ausführung eines Bedingungs-Schrittes.

Beinhaltet:

  • die ID des Flows
  • die ID des Schrittes
  • das Resultat der Bedingung, wobei “t” für wahr und “f” für falsch steht
STEP_CONDITION_EXECUTE
{
  "stepConditionExecute": {
    "flowId": "string",
    "stepId": "string",
    "result": "string"
  }
}

Dokumentiert die Ausführung eines A/B-Split-Schrittes.

Beinhaltet:

  • die ID des Flows
  • die ID des Schrittes
  • das Resultat des Splits, welches entweder “a” oder “b” ist
STEP_SPLIT_EXECUTE
{
  "stepSplitExecute": {
    "flowId": "string",
    "stepId": "string",
    "result": "string"
  }
}

Dokumentiert die Ausführung eines Kontext-Schrittes.

Beinhaltet:

  • die ID des Flows
  • die ID des Schrittes
  • den verwendeten Ausstieg
  • die ID der wahrscheinlichsten Intention
STEP_CONTEXT_EXECUTE
 {
  "stepContextExecute": {
    "flowId": "string",
    "stepId": "string",
    "outlet": "string",
    "topIntent": "string"
  }
}

Dokumentiert die Ausführung eines App-Modul-Schrittes.

Beinhaltet:

  • die ID des Flows
  • die ID des Schritts
  • die ID der App
  • die ID des App-Moduls
  • den Status-Code
  • die Dauer bis zur Antwort
  • ob die Ausführung erfolgreich war
STEP_APP_MODULE_EXECUTE
{
  "stepAppModuleExecute": {
    "flowId": "string",
    "stepId": "string",
    "appId": "string",
    "moduleId": "string",
    "statusCode": "number",
    "responseTime": "number",
    "responseOk": "boolean"
  }
}
Dokumentiert das Hinzufügen eines “Tags” zur Konversation und die ID des “Tags”.CONVERSATION_TAG_ADDED
{
  "conversationTagAdded": {
    "tagId": "string"
  }
}
Dokumentiert das (erneute) Eröffnen einer Konversation.
Gibt an, ob diese von einem space.vars.TERM_AI_AGENT (null) oder einem Agenten (ID des Agenten)(wieder-)eröffnet wurde.		CONVERSATION_OPENED

{
"conversationOpened": {
"openedBy": "string",
"operatorId": "string"
}
}
Dokumentiert das Abschließen einer Konversation.
Gibt an, ob diese von einem space.vars.TERM_AI_AGENT (null) oder einem Agenten (ID des Agenten) abgeschlossen wurde.		CONVERSATION_CLOSED
{
"conversationClosed": {
"closedBy": "string",
"operatorId": "string"
}
}
Dokumentiert die Ausführung des »Übergabe an Agenten«-Elements.REQUESTED_AGENT_HANDOVER

{
}
# Einstellungen Der Bereich Einstellungen ist die zentrale Anlaufstelle für grundlegenden und administrativen Konfigurationen deines AI Agents. Er ist über das Zahnrad-Icon unten links in der Navigation erreichbar. Die Einstellungen sind in folgende Kategorien unterteilt: * [**Allgemein**](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/allgemein)**:** Passe den internen Namen deines space.vars.TERM\_AI\_AGENTs an und lege die Zeitzone fest, nach der sich zeitabhängige Funktionen richten. Hier kannst du bei Bedarf auch die Löschung des space.vars.TERM\_AI\_AGENTs beantragen. * [**Sprache**](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/sprache)**:** Konfiguriere deinen space.vars.TERM\_AI\_AGENT für mehrsprachige Szenarien. Du kannst unterstützte Sprachen hinzufügen, eine Standardsprache festlegen und die automatische Übersetzung aktivieren. * [**Benutzer**](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/benutzer) **&** [**Teams**](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/teams)**:** Verwalte die Zugriffsrechte deines Teams. Lade Workspace-Mitglieder ein, weise ihnen Rollen zu (z. B. Inhaber, Bearbeiter oder Inbox-Benutzer) und fasse sie in Teams zusammen, um Konversationen gezielt zuzuweisen. * [**AI-Einstellungen**](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/ki-einstellungen) **&** [**Modelle**](/epic-ai-platform/epic-ai-platform/ai-agent/daten/modelle)**:** Aktiviere und konfiguriere die generative space.vars.TERM\_AI zur Beantwortung von Nutzeranfragen. Schalte intelligente Inbox-Features frei – etwa automatische Zusammenfassungen oder Antwortgenerierung. Außerdem findest du in dieser Sektion Beschreibungen zu Modelleinstellungen und Prompt-Editor. * [**API-Schlüssel**](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/api-schlussel)**:** Generiere und verwalte API-Keys, um externe Systeme, Dienste und Webhooks sicher mit deinem space.vars.TERM\_AI\_AGENT zu verbinden. * [**Kanäle**](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/kanale)**:** Richte die Kommunikationswege ein, über die Nutzer mit deinem space.vars.TERM\_AI\_AGENT interagieren. Hier verwaltest du Anbindungen für Telefonie, Web-Widgets, E-Mail sowie Messenger wie WhatsApp. # Allgemein Die Seite Allgemein ist die zentrale Einstellungsseite deines AI Agents. Hier kannst du den Namen und die Zeitzone deines AI Agents anpassen sowie bei Bedarf die Löschung beantragen. ### Wo finde ich das? `Einstellungen → Allgemein` Der Bereich ist in drei Abschnitte unterteilt: **Allgemein** (Name & Zeitzone), **Details** (technische Informationen) und **Sensibler Bereich** (AI Agent löschen). *** ### **Allgemein** #### **Name des AI Agents** Der Name identifiziert deinen AI Agent innerhalb der Plattform. Er wird ausschließlich intern verwendet – z. B. in der Übersicht deiner AI Agents – und ist für Endnutzer nicht sichtbar. **Name ändern:** 1. Navigiere zu `Einstellungen → Allgemein`. 2. Klicke in das Feld Name des AI Agents und passe den Namen an. 3. Klicke oben rechts auf Speichern. *** ### Zeitzone Die Zeitzone bestimmt, nach welcher Ortszeit zeitabhängige Funktionen des space.vars.TERM\_AI\_AGENTs ausgeführt werden. Sie beeinflusst unter anderem: * **Zeitstempel** innerhalb der Plattform * **Variablen**, die das aktuelle Datum oder die aktuelle Uhrzeit liefern * Die **Datumsangaben, die das** space.vars.TERM\_AI**-Modell** bei der Verarbeitung von Anfragen erhält **Zeitzone ändern:** 1. Navigiere zu `Einstellungen → Allgemein`. 2. Klicke auf das Feld **Zeitzone**. 3. Tippe einen Suchbegriff ein (z. B. „Berlin" oder „Europe") oder scrolle durch die Liste, um eine Zeitzone auszuwählen. 4. Wähle die gewünschte Zeitzone aus dem Dropdown aus. 5. Klicke oben rechts auf **Speichern**. {% hint style="success" %} Stelle die Zeitzone passend zum Einsatzort deines space.vars.TERM\_AI\_AGENTs ein. Wenn dein space.vars.TERM\_AI\_AGENT primär in Deutschland genutzt wird, wähle `Europe/Berlin`. {% endhint %} *** ### **Details** Hier findest du technische Informationen zu deinem AI Agent: * **AI Agent ID** – wird automatisch vom System vergeben und kann nicht geändert werden. Sie dient zur internen Identifikation und ist ausschließlich für technische Zwecke relevant. Über die Schaltfläche Kopieren lässt sich die ID schnell in die Zwischenablage übernehmen. * **Erstellt** – Datum und Uhrzeit, zu der der AI Agent angelegt wurde. *** ### space.vars.TERM\_AI\_AGENT löschen Das direkte Löschen eines space.vars.TERM\_AI\_AGENTs über die Oberfläche ist nicht möglich. Um deinen space.vars.TERM\_AI\_AGENT löschen zu lassen, wende dich bitte per E-Mail an die in der Oberfläche angezeigten E-Mail Adresse. Nach Eingang deiner Anfrage wird die Löschung durch das Support-Team bearbeitet. Der space.vars.TERM\_AI\_AGENT wird nach einer Bestätigung innerhalb von 30 Tagen gelöscht. {% hint style="danger" %} Sobald die Löschanfrage bearbeitet wurde, kann der Vorgang nicht mehr rückgängig gemacht werden. Wenn du die Löschung verhindern möchtest, wende dich **schnellstmöglich** nach Einreichung der Anfrage an den Support. {% endhint %} # Apps / Appstore Der Appstore ermöglicht es, Apps direkt in einem AI Agent zu installieren und so externe Dienste in den Flow einzubinden. Er zeigt sowohl öffentliche als auch private Apps an. ### **Wo finde ich den App Store?** `AI Agent → Einstellungen → App Store` ### **Aufbau des App Store** Der App Store gliedert sich in der linken Navigation in zwei Bereiche: * **Entdecken** – zum Durchsuchen und Installieren neuer Apps (bisher „Appstore"). * **Deine Apps** – zur Verwaltung bereits installierter Apps, unterteilt in „Installiert" und „Privat" (bisher „Meine Apps"). Zusätzlich lässt sich über **Kategorien** gezielt filtern: CRM, E-Commerce, ERP, Helpdesk, Termine, HR, Projekte, Sonstige. Oben rechts steht ein Suchfeld („Apps durchsuchen…") zur Verfügung. #### **Entdecken** Auf der Startseite von „Entdecken" werden oben drei Themen-Kacheln hervorgehoben (z. B. „CRM & Vertrieb", „E-Commerce", „Helpdesk & ITSM") mit einem „Entdecken →"-Link. Darunter folgen die einzelnen Kategorie-Abschnitte (z. B. „CRM", „E-Commerce", „ERP") mit den zugehörigen App-Karten. Besonders häufig genutzte Apps tragen ein „Beliebt"-Badge. Über „Alle anzeigen →" lässt sich die vollständige Liste einer Kategorie öffnen. #### **Deine Apps** * **Installiert**: zeigt alle installierten Apps, gruppiert nach Kategorie, mit Name und Installationsdatum. Öffentliche Apps sind mit dem Badge „Öffentlich" gekennzeichnet, privat erstellte Apps mit dem Badge „Privat" *(vormals durch unterschiedliche Weltkugel-Icons unterschieden)*. * **Privat**: zeigt ausschließlich die im eigenen Workspace erstellten und installierten privaten Apps. *** ### App installieren **App installieren** 1. Navigiere zu `AI Agent → Einstellungen → App Store → Entdecken / Privat` . 2. Suche die gewünschte App – über die Kategorien in der linken Navigation, die Themen-Kacheln oder die Suche. 3. Klicke bei der gewünschten App auf „Installieren". 4. Es öffnet sich der Dialog „Version auswählen". Wähle die gewünschte Version der App aus. 5. Klicke auf „Version installieren". Nach der Installation landest du direkt auf der App-Detailseite. Falls die App eine Verbindung mit Authentifizierung erfordert (z. B. einen API-Key), wirst du mit einem orangefarbenen Warnhinweis darauf aufmerksam gemacht. {% hint style="info" %} Eine App kann erst vollständig genutzt werden, wenn alle erforderlichen Verbindungen eingerichtet wurden. Module, deren Verbindung noch nicht konfiguriert ist, sind im space.vars.TERM\_FLOW\_BUILDER nicht einsatzbereit. {% endhint %} #### **App-Detailseite** Ein Klick auf eine installierte App öffnet die App-Detailseite. Dort siehst du: * Name, Typ-Badge (**Öffentlich** / **Privat**), App-ID und Status („Installiert") * Beschreibung der App (sofern vom App-Ersteller hinterlegt) * **Verbindungen** mit ihrem aktuellen Status (Aktiv oder Inaktiv) * **Module** mit dem Namen der jeweils verknüpften Verbindung * Installations- und Aktualisierungsdatum Ein Modul kann nur verwendet werden, wenn die verknüpfte Verbindung eingerichtet und aktiv ist. #### Verbindung nach der Installation einrichten Falls eine Verbindung noch nicht konfiguriert ist, erscheint auf der App-Detailseite ein orangefarbener Warnhinweis. Module, die von dieser Verbindung abhängen, sind mit einem Warnsymbol gekennzeichnet und können im Flow Builder nicht genutzt werden. 1. Klicke auf „Verbindung einrichten" im Warnhinweis oder auf das Stift-Icon neben der jeweiligen Verbindung. 2. Trage die erforderlichen Zugangsdaten ein – je nach Verbindungstyp z. B. API-Key oder Benutzername und Passwort. 3. Klicke auf „Speichern". Nach dem Speichern wird die Verbindung geprüft (Health Check). Ist der Health Check erfolgreich, wechselt der Status von **„Inaktiv"** auf **„Aktiv"** und die zugehörigen Module sind einsatzbereit. #### **App aktualisieren** Wenn eine neuere Version einer installierten App verfügbar ist, erscheint auf der App-Detailseite ein blauer Hinweis mit Angabe von Veröffentlichungsdatum und -uhrzeit (z. B. „Veröffentlicht am 06.07.2026 um 15:26 Uhr"). Über den Button „Aktualisieren" bringst du die App auf die neueste Version. Alternativ kannst du über „Version ändern" manuell eine bestimmte Version auswählen. Nach einer Aktualisierung oder einem Versionswechsel können sich Module oder Verbindungen geändert haben. Prüfe anschließend, ob alle Verbindungen noch aktiv sind und die Module im Flow Builder wie erwartet funktionieren. #### **App deinstallieren** Auf der App-Detailseite findest du im Abschnitt „App deinstallieren" den roten Button „Deinstallieren". Damit wird die App aus dem AI Agent entfernt. 1. Klicke auf „Deinstallieren". 2. Im Bestätigungsdialog musst du zur Sicherheit den Namen der App exakt eingeben. Der Button „App deinstallieren" ist erst danach aktiv. 3. Bestätige mit „App deinstallieren" oder brich mit „Abbrechen" ab. Nach dem Deinstallieren stehen die Module der App im Flow Builder nicht mehr zur Verfügung. Bereits eingebundene App-Modul-Schritte im Flow können dadurch zu Fehlern führen. Prüfe vorher, ob die App noch aktiv im Flow verwendet wird. Möglicherweise gehen zudem Daten verloren, die über diese App erfasst wurden. *** ### **Apps im Flow-Builder verwenden** Nach der Installation und erfolgreichen Einrichtung aller Verbindungen können die Module einer App im Flow Builder genutzt werden. Es gibt zwei Möglichkeiten: **Als eigener Schritt im Flow**\ Du kannst ein App-Modul als eigenständigen Schritt an einer beliebigen Stelle im Flow einbauen. Die Antwort des Moduls wird automatisch in den Variablen des jeweiligen Moduls gespeichert. Diese Variablen lassen sich anschließend über den Variablen-Picker im weiteren Verlauf des Flows verwenden – z. B. in Nachrichten, Bedingungen oder weiteren Modulaufrufen. Ein Modul kann mehrfach im Flow eingesetzt werden. Wird dasselbe App-Modul mehrmals aufgerufen, überschreibt jeder spätere Aufruf die Werte des vorherigen. Die Variablen enthalten danach nur noch die Daten des letzten Modulaufrufs. **Als Tool in „Gespräch führen"**\ App-Module können auch als Tool im Schritt „Gespräch führen" eingebunden werden. Dort wählst du das gewünschte Modul aus und hinterlegst eine Anmerkung, wann das Tool eingesetzt werden soll. Zusätzlich definierst du den Einsatz mittels Variablen-Picker im Prompt. Der Agent entscheidet dann automatisch, ob und wann er das Tool während der Konversation aufruft. Die Verarbeitung der Antworten erfolgt ebenfalls automatisch. # Sprache Der Bereich Sprachen ermöglicht es dir, deinen AI Agent für mehrere Sprachen zu konfigurieren. So kann dein AI Agent Nutzer in ihrer jeweiligen Sprache verstehen und ansprechen. ### Wo finde ich das? `Einstellungen → Sprachen` Der Bereich „Sprachen" befindet sich in den Einstellungen deines space.vars.TERM\_AI\_AGENTs, im unteren Bereich der linken Navigationsleiste. *** ### Erklärung – Was genau sind Sprachen? Im Bereich „Sprachen" legst du fest, welche Sprachen dein space.vars.TERM\_AI\_AGENT unterstützt. Jede hinzugefügte Sprache erscheint in der Übersicht mit ihrem Namen und dem entsprechenden Länderkürzel (z. B. `DE` für Deutsch, `EN-GB` für Englisch (GB)). Eine der konfigurierten Sprachen ist als Standardsprache markiert (Badge **Standard**). Diese dient als Basis für Übersetzungen aller statischen Schritte im Flow Builder (siehe Abschnitt „Automatische Übersetzung"). Die Standardsprache wird bei der Einrichtung des AI Agents festgelegt und kann nachträglich nicht mehr über die Oberfläche geändert werden. *** ### Verwendung – Was kann man damit machen? #### Automatische Übersetzung Im unteren Bereich der Spracheinstellungen findest du den Abschnitt **Automatische Übersetzung**. Wenn du diese Option aktivierst, werden (vom space.vars.TERM\_AI\_AGENT) ausgehende Nachrichten automatisch übersetzt – immer dann, wenn die Sprache eines Nutzers nicht unter den konfigurierten Sprachen hinterlegt ist. Zusätzlich gilt: * space.vars.TERM\_AI**-Schritte** werden automatisch in alle konfigurierten Sprachen übersetzt. * **Statische Schritte** (z.B. feste Textnachrichten im space.vars.TERM\_FLOW\_BUILDER) werden auf Basis der Standardsprache in die anderen konfigurierten Sprachen übersetzt. {% hint style="info" %} Wenn die automatische Übersetzung aktiv ist, müssen statische Schritte nicht manuell in jeder Sprache gepflegt werden. Die Standardsprache bleibt die einzige Quelle, die du aktiv bearbeiten musst. {% endhint %} *** ### Verwaltung – Erstellung, Bearbeitung und Löschen #### Sprache hinzufügen 1. Klicke oben rechts auf **„Sprache hinzufügen"**. 2. Ein Dialog öffnet sich. 3. Klicke auf das Dropdown-Feld **„Sprache"** und wähle die gewünschte Sprache aus der Liste aus. Es stehen zahlreiche Weltsprachen zur Verfügung, darunter z. B. Englisch, Arabisch, Bulgarisch und viele weitere. 4. Klicke auf **„Sprache hinzufügen"**, um die Sprache zu speichern. Die neue Sprache erscheint anschließend in der Übersichtstabelle mit ihrem Länderkürzel. #### Sprache löschen 1. Fahre mit der Maus über die Sprache, die du entfernen möchtest. 2. Klicke auf das **Mülltonnen-Icon** rechts neben der Sprache. {% hint style="warning" %} **Achtung:** Das Löschen einer Sprache ist nicht rückgängig zu machen. Dabei werden unwiderruflich gelöscht: * Alle **Sprachbausteine** in den Schritt des space.vars.TERM\_FLOW\_BUILDERs, die für diese Sprache gepflegt wurden. * Alle **sprachspezifischen Einstellungen** des space.vars.TERM\_AI\_AGENTs. * Alle **Trainingsdaten**, die für diese Sprache hinterlegt sind. Prüfe daher sorgfältig, ob die Sprache noch irgendwo aktiv verwendet wird, bevor du sie entfernst. {% endhint %} *** ### Beispiele #### Mehrsprachigen space.vars.TERM\_AI\_AGENT einrichten **Szenario:** Du möchtest deinen space.vars.TERM\_AI\_AGENT auf Deutsch pflegen, er soll aber auch Französisch, Englisch und Italienisch unterstützen. 1. Navigiere zu `Einstellungen → Sprachen`. 2. Füge über „Sprache hinzufügen" die Sprachen **Französisch**, **Englisch (GB)** und **Italienisch** hinzu. 3. Aktiviere die **Automatische Übersetzung** über den Toggle im unteren Bereich. Ergebnis: Du pflegst alle Inhalte im space.vars.TERM\_FLOW\_BUILDER ausschließlich auf Deutsch. Schreibt ein Nutzer auf Französisch, übersetzt das System die Nachrichten automatisch. *** ### Best Practices * Lege die Sprache, in der du deinen space.vars.TERM\_AI\_AGENT primär pflegst, als Standardsprache fest. Nur so kann die automatische Übersetzung statischer Schritte korrekt funktionieren – sie basiert immer auf der Standardsprache als Quelle. * Aktiviere die automatische Übersetzung, wenn dein space.vars.TERM\_AI\_AGENT Nutzer in verschiedenen Sprachen betreuen soll. So musst du Inhalte nicht mehrfach manuell übersetzen und pflegen. * Lösche Sprachen nur dann, wenn du sicher bist, dass sie nicht mehr benötigt werden. Das Löschen entfernt auch alle zugehörigen Trainingsdaten – diese können nicht wiederhergestellt werden. # Benutzer Im Bereich „Benutzer" kannst du festlegen, welche Personen aus deinem Workspace Zugriff auf einen bestimmten AI Agent haben. ### Wo finde ich das? Navigiere zu `Einstellungen → Benutzer`. Du siehst dort eine Tabelle mit allen Benutzern, die dem AI Agent zugeordnet sind. Die Tabelle zeigt Name, E-Mail-Adresse und das Datum, an dem der Benutzer hinzugefügt wurde. Über das Suchfeld oberhalb der Tabelle kannst du gezielt nach einzelnen Benutzern suchen. ### Erklärung – Was sind Benutzer? Benutzer sind Personen aus deinem Workspace, denen du Zugriff auf einen space.vars.TERM\_AI\_AGENT gewährt hast. Jeder Benutzer erhält eine oder mehrere Rollen, die festlegen, welche Funktionen er nutzen darf. {% hint style="info" %} Nur Personen, die bereits [Mitglied deines Workspaces](/epic-ai-platform/epic-ai-platform/workspace/benutzer) sind, können als Benutzer hinzugefügt werden. Es ist nicht möglich, externe Personen direkt hinzuzufügen – sie müssen zuerst dem Workspace beitreten. {% endhint %} #### Rollen im Überblick Jedem Benutzer wird mindestens eine Rolle zugewiesen. Ein Benutzer kann auch mehrere Rollen gleichzeitig besitzen. Die verfügbaren Rollen sind: * **Inhaber**: Kann den AI Agent uneingeschränkt verwalten und nutzen. * **Administrator**: Kann den AI Agent verwalten und nutzen, ihn aber nicht löschen. * **Bearbeiter**: Kann den AI Agent bearbeiten, aber keine Benutzer verwalten oder Nachrichten versenden. * **Inbox-Administrator**: Kann die Inbox-Einstellungen vollumfänglich verwalten und Nachrichten versenden. * **Inbox-Benutzer**: Kann Nachrichten versenden, aber keine Inbox-Einstellungen verwalten. * **Inbox-Benutzer** (extern): Kann Nachrichten versenden, sieht aber nur die eigenen und die dem eigenen Team zugewiesenen Konversationen. * **Mitglied**: Kann andere Mitglieder sehen, aber keine Änderungen vornehmen. * **Statistik-Betrachter**: Kann die Statistiken des AI Agents einsehen. ### Verwaltung – Benutzer hinzufügen, bearbeiten und entfernen {% hint style="info" %} Um Benutzer hinzuzufügen oder zu entfernen, benötigst du die Rolle **Inhaber** oder **Administrator**. {% endhint %} #### Benutzer hinzufügen 1. Navigiere zu `Einstellungen → Benutzer`. 2. Klicke oben rechts auf den Button **„Benutzer hinzufügen"**. 3. Wähle im Feld „Benutzer" eine Person aus der Liste der verfügbaren Workspace-Mitglieder aus und weise ihr im Feld „Rolle" direkt eine Rolle zu. 4. Über „+ Weiteren Benutzer hinzufügen" kannst du in einem Schritt weitere Personen ergänzen, jeweils mit eigener Rolle. 5. Klicke auf „Benutzer hinzufügen", um die Auswahl zu bestätigen. Die Benutzer werden anschließend nacheinander hinzugefügt; der Fortschritt wird dir live angezeigt. Zum Abschluss siehst du eine Übersicht, welche Personen erfolgreich hinzugefügt wurden. #### Rollen ändern Rollen können jederzeit angepasst werden. Klicke auf den gewünschten Benutzer in der Tabelle, um dessen Detailansicht zu öffnen. Diese ist in mehrere Bereiche unterteilt: * **Profil:** Name, E-Mail-Adresse und Datum des Hinzufügens. * **Rollen:** Tabelle mit allen aktuell zugewiesenen Rollen inklusive Beschreibung. Über „Rolle hinzufügen" kannst du weitere Rollen ergänzen – im Auswahlmenü werden dabei nur Rollen angezeigt, die der Benutzer noch nicht besitzt. Um eine bestehende Rolle zu entfernen, fährst du in der Tabelle mit der Maus über die entsprechende Zeile; dort erscheint ein Löschsymbol. * **Teams:** Zeigt, in welchen Teams der Benutzer Mitglied ist. Ist er in keinem Team, wird dies entsprechend angezeigt. #### Benutzer entfernen 1. Klicke auf den Benutzer in der Tabelle, um die Detailansicht zu öffnen. 2. Klicke im Bereich „Sensibler Bereich" auf den Button „Entfernen". 3. Bestätige den Vorgang im Dialog mit „Benutzer entfernen". {% hint style="info" %} Das Entfernen eines Benutzers entzieht nur den Zugriff auf den jeweiligen space.vars.TERM\_AI\_AGENT. Die Person bleibt weiterhin Mitglied des Workspaces. {% endhint %} {% hint style="warning" %} Inhaber können nur von anderen Inhabern entfernt werden. Ein Inhaber kann sich selbst nicht entfernen. So wird sichergestellt, dass der space.vars.TERM\_AI\_AGENT nie ohne Inhaber ist. {% endhint %} ### Best Practices * **Rollen gezielt vergeben:** Weise Benutzern nur die Rollen zu, die sie für ihre Arbeit tatsächlich benötigen. So vermeidest du unbeabsichtigte Änderungen am AI Agent. * **Mindestens zwei Inhaber einrichten:** Falls ein Inhaber das Team verlässt, bleibt der volle Zugriff auf den AI Agent gewährleistet. * **Inbox-Rollen differenziert einsetzen:** Nutze die Rolle „Inbox Benutzer (Extern)" für externe Mitarbeitende oder Partner, die nur ihre eigenen Konversationen sehen sollen. Für interne Teamleiter eignet sich die Rolle „Inbox Administrator", um Inbox-Einstellungen selbstständig verwalten zu können. * **Berechtigungen regelmäßig prüfen:** Kontrolliere in regelmäßigen Abständen, ob die zugewiesenen Rollen noch den aktuellen Aufgaben der Benutzer entsprechen. # Teams Mit Teams kannst du Benutzer deines AI Agents zu Gruppen zusammenfassen. ### Wo finde ich das? Du findest die Team-Verwaltung unter `Einstellungen → Teams`. Dort werden alle vorhandenen Teams in einer Übersichtstabelle mit Name, Anzahl der Mitglieder, Erstellungsdatum und **Team-ID** angezeigt. Die Team-ID lässt sich über das Kopier-Symbol direkt in die Zwischenablage übernehmen — praktisch, wenn du das Team z. B. per API oder in einer Konfiguration referenzieren musst. ### Erklärung – Was genau sind Teams? Ein Team ist eine Gruppe von Benutzern deines space.vars.TERM\_AI\_AGENTs. Du kannst beliebig viele Teams erstellen und jedem Team beliebig viele Mitglieder zuweisen. Als Mitglieder stehen ausschließlich [Benutzer](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/benutzer) zur Verfügung, die im space.vars.TERM\_AI\_AGENT angelegt sind. Einer Konversation kann immer nur ein Team gleichzeitig zugeordnet werden. {% hint style="warning" %} Teams sind nicht für Voice-Anrufe verfügbar. Sie können ausschließlich für textbasierte Konversationen genutzt werden. {% endhint %} ### Verwendung – Was kann man mit Teams machen? #### Konversationen automatisch zuweisen Im Flow Builder kannst du mit dem Aktions-Element „[Team zuweisen](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/block/elemente-aktionen)" ein Team automatisch einer Konversation zuordnen. Das ist praktisch, um eingehende Konversationen je nach Thema oder Kontext direkt an das passende Team weiterzuleiten. #### Konversationen manuell zuweisen In der Inbox kannst du einer Konversation auch manuell ein [Team zuweisen](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/block#aktionen) oder ein bereits zugewiesenes Team ändern. Dazu öffnest du die Konversation und wählst über ein Auswahlmenü das gewünschte Team aus. Es kann immer nur ein Team gleichzeitig ausgewählt werden. #### Gefilterte Ansichten in der Inbox Für jedes Team wird in der Inbox eine eigene gefilterte Ansicht angezeigt. So können Teammitglieder gezielt die Konversationen einsehen, die ihrem [Team zugeordnet](/epic-ai-platform/epic-ai-platform/ai-agent/inbox/konversationsdetails-rechte-seite#team-zuweisen) sind. #### Berechtigungen für die Rolle „Inbox Benutzer Extern" Die Rolle „[Inbox Benutzer Extern](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/benutzer#rollen-im-uberblick)" nutzt Teams zusätzlich zur Steuerung von Berechtigungen. Benutzer mit dieser Rolle sehen ausschließlich Konversationen, die dem eigenen Team zugeordnet sind. ### Verwaltung – Erstellung, Bearbeitung und Löschen #### Team erstellen 1. Navigiere zu `Einstellungen → Teams`. 2. Klicke oben rechts auf den Button **„Team erstellen"**. 3. Vergib einen Namen für das neue Team. Der Name ist ein Pflichtfeld. 4. Klicke auf **„Erstellen"**. Das Team wird nun in der Übersichtstabelle angezeigt. {% hint style="info" %} Der Name eines Teams kann nach der Erstellung nicht mehr geändert werden. Wähle daher einen aussagekräftigen Namen. {% endhint %} #### Mitglieder bearbeiten 1. Navigiere zu `Einstellungen → Teams`. 2. Klicke auf das gewünschte Team, um die Detailansicht zu öffnen. Dort siehst du eine Tabelle mit allen aktuellen Mitgliedern (Name und E-Mail-Adresse). 3. Klicke oben rechts auf den Button „Mitglieder bearbeiten". 4. Es öffnet sich ein Dialog mit einer Liste aller verfügbaren Benutzer des AI Agents. Bereits hinzugefügte Mitglieder sind mit einem Häkchen markiert. Über das Suchfeld kannst du Mitglieder nach Name oder E-Mail-Adresse filtern. 5. Setze oder entferne die Häkchen bei den gewünschten Benutzern, um Mitglieder hinzuzufügen oder zu entfernen. Änderungen an der Mitgliederliste werden automatisch gespeichert. #### Team löschen 1. Navigiere zu `Einstellungen → Teams`. 2. Klicke in der Übersichtstabelle auf den Löschen-Button des gewünschten Teams. {% hint style="warning" %} Das Löschen eines Teams hat folgende Auswirkungen: * Konversationen, die diesem Team zugewiesen waren, verlieren ihre Zuordnung. * Im space.vars.TERM\_FLOW\_BUILDER bleibt das Element „Team zuweisen" bestehen, enthält aber kein gültiges Team mehr. Du musst das Element manuell entfernen und gegebenenfalls ein anderes Team zuweisen. {% endhint %} {% hint style="info" %} Prüfe vor dem Löschen eines Teams, ob es noch in aktiven Flows oder Konversationen verwendet wird. Kontrolliere nach dem Löschen zusätzlich deine Flows auf ungültige Zuweisungen. {% endhint %} ### Best Practices * **Aussagekräftige Namen verwenden:** Da Teamnamen nicht nachträglich geändert werden können, solltest du direkt einen klaren, eindeutigen Namen wählen – z. B. „Support Level 1", „Vertrieb DACH" oder „Buchhaltung". * **Teams nach Zuständigkeiten strukturieren:** Orientiere dich an den tatsächlichen Verantwortlichkeiten deines Teams. So lassen sich Konversationen im space.vars.TERM\_FLOW\_BUILDER gezielt weiterleiten und in der Inbox übersichtlich filtern. * **Mitgliederliste aktuell halten:** Wenn Benutzer das Unternehmen verlassen oder die Zuständigkeit wechseln, solltest du die Teammitglieder zeitnah anpassen. So stellst du sicher, dass Konversationen immer den richtigen Personen angezeigt werden. * **Automatische Zuweisung im** space.vars.TERM\_FLOW\_BUILDER **nutzen:** Nutze das Element „Team zuweisen", um eingehende Konversationen direkt dem passenden Team zuzuordnen. Das spart manuelle Arbeit und beschleunigt die Bearbeitung. # KI-Einstellungen In den KI-Einstellungen legst du fest, wie dein AI Agent generative KI nutzt und welche KI-gestützten Funktionen in der Inbox aktiv sind. ### Wo finde ich das? `Einstellungen → KI-Einstellungen` Die Seite ist in zwei Bereiche aufgeteilt: * space.vars.TERM\_AI**-Einstellungen:** Steuert das Verhalten der Generativen space.vars.TERM\_AI im space.vars.TERM\_AI\_AGENT * **Inbox Einstellungen:** Steuert space.vars.TERM\_AI-Funktionen für Mitarbeitende in der Inbox *** ### Erklärung – Was genau sind die space.vars.TERM\_AI-Einstellungen? Die space.vars.TERM\_AI-Einstellungen ermöglichen es dir, generative space.vars.TERM\_AI gezielt für deinen space.vars.TERM\_AI\_AGENT zu aktivieren und zu konfigurieren. Zusätzlich kannst du space.vars.TERM\_AI-Funktionen für die Inbox aktivieren, die Mitarbeitende beim Beantworten von Nachrichten unterstützen. *** ### Verwendung – Was kann man damit machen? #### Generative space.vars.TERM\_AI Anfragen, die keiner [Intention](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/intentionen) oder keinem [FAQ-Paar](/epic-ai-platform/epic-ai-platform/ai-agent/build/faqs) zugeordnet werden können, werden automatisch von der generativen space.vars.TERM\_AI beantwortet. Dabei kann auf das hinterlegte [Wissen](/epic-ai-platform/epic-ai-platform/ai-agent/build/wissen) zugegriffen werden. {% hint style="warning" %} Durch die Aktivierung der Generativen space.vars.TERM\_AI erhöht sich der benötigte Confidence-Score für Intentionen und FAQ-Paare. Das bedeutet: Der space.vars.TERM\_AI\_AGENT ordnet Anfragen schwieriger einer definierten Intention oder einem FAQ-Paar zu – mehr Anfragen werden stattdessen durch die generative space.vars.TERM\_AI beantwortet. {% endhint %} **So aktivierst du die Generative** space.vars.TERM\_AI**:** 1. Navigiere zu `Einstellungen → KI-Einstellungen`. 2. Aktiviere den Toggle **„Generative** space.vars.TERM\_AI**"**. 3. Trage im Feld **„Benutzerdefinierter Prompt"** einen Prompt ein. 4. Klicke auf **„Speichern"**. Ein Prompt ist zwingend erforderlich. Ohne Prompt kann die Einstellung nicht gespeichert werden. Das System zeigt in diesem Fall die Fehlermeldung „Es muss ein Prompt festgelegt werden" an. **Was gehört in den Prompt?** Der Prompt gibt der generativen space.vars.TERM\_AI Anweisungen darüber, wie sie antworten soll – z. B. Tonalität, Themenbeschränkungen oder spezifische Verhaltensregeln. Die [Modell-Einstellungen](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/ki-einstellungen/modelleinstellungen) werden in einem separaten Artikel beschrieben. *** #### Inbox Einstellungen Die Inbox Einstellungen stellen Mitarbeitenden space.vars.TERM\_AI-Unterstützung beim Bearbeiten von Nachrichten bereit. Wird eine der untenstehenden Funktionen aktiviert, erscheint in der Inbox ein dazu passendes Icon. Jede Funktion kann mit Klick auf dieses Icon ausgeführt werden. Die Einstellungen gelten global für alle Nutzer dieses space.vars.TERM\_AI\_AGENTs. **Umformulierungen** Mitarbeitende erhalten beim Verfassen einer Nachricht in der Inbox einen space.vars.TERM\_AI-generierten Alternativvorschlag – eine Umformulierung des eingegebenen Texts. **So aktivierst du Umformulierungen:** 1. Aktiviere den Toggle **„Umformulierungen aktivieren"**. 2. Trage im Feld **„Prompt"** einen Prompt ein. 3. Klicke auf **„Speichern"**. Der Prompt steuert, wie die Umformulierung erfolgen soll. Beispiel: > „Formuliere den Text professioneller und kürzer. Behalte den inhaltlichen Kern bei." *** **Automatische Zusammenfassung** Eingehende Textnachrichten werden zusammengefasst. Die Zusammenfassung wird Mitarbeitenden in der Inbox angezeigt und erleichtert das schnelle Erfassen des Anliegens. **So aktivierst du die Automatische Zusammenfassung:** 1. Aktiviere den Toggle **„Automatische Zusammenfassung aktivieren"**. 2. Trage im Feld **„Benutzerdefinierter Prompt"** einen Prompt ein. 3. Klicke auf **„Speichern"**. Beispiel-Prompt: > „Fasse die Nachricht in maximal zwei Sätzen zusammen. Hebe das Hauptanliegen hervor." *** **Automatische Antwortgenerierung** Zu eingehenden Nachrichten werden Antwortvorschläge generiert. Diese werden Mitarbeitenden in der Inbox angezeigt und können direkt übernommen oder angepasst werden. **So aktivierst du die Automatische Antwortgenerierung:** 1. Aktiviere den Toggle **„Automatische Antwortgenerierung aktivieren"**. 2. Klicke auf **„Speichern"**. *** ### Verwaltung – Einstellungen speichern und anpassen Alle Änderungen auf der Seite „space.vars.TERM\_AI-Einstellungen" werden erst durch einen Klick auf **„Speichern"** wirksam. So nimmst du Änderungen vor: 1. Navigiere zu `Einstellungen → AI-Einstellungen`. 2. Aktiviere oder deaktiviere den gewünschten Toggle. 3. Passe bei Bedarf den Prompt im Textfeld an. 4. Klicke auf **„Speichern"**. *** ### Best Practices * **Prompts präzise formulieren:** Je konkreter der Prompt, desto vorhersehbarer verhält sich die generative space.vars.TERM\_AI. Gib klare Anweisungen zu Tonalität, Themenbereich und Einschränkungen. * **Generative** space.vars.TERM\_AI **gezielt einsetzen:** Die Aktivierung erhöht den Confidence-Score für Intentionen und FAQ-Paare. Prüfe nach der Aktivierung, ob dein space.vars.TERM\_AI\_AGENT weiterhin die gewünschten Intentionen korrekt zuordnet. * **Prompts regelmäßig überprüfen:** Wenn sich die Anfragen oder der Kommunikationsstil ändern, sollten auch die Prompts angepasst werden. # Prompt-Editor Der Prompt-Editor ist das Texteingabefeld für alle Prompts in der Plattform. Er ermöglicht es, Inhalte sowohl über eine Formatierungsleiste als auch direkt per Markdown-Syntax zu gestalten. ### Wo finde ich den Prompt-Editor? Der Prompt-Editor erscheint an allen Stellen der Plattform, an denen ein Prompt eingegeben werden kann – z. B. in den [KI-Einstellungen](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/ki-einstellungen) eines space.vars.TERM\_AI\_AGENTs oder in den [KI-Schritten](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/gen-ai-gesprach-fuhren). ### Erklärung – Was genau ist der Prompt-Editor? Der Prompt-Editor kombiniert zwei Eingabemethoden in einem Textfeld: * **Formatierungsleiste:** Klicke auf die Buttons in der Toolbar, um Formatierungen anzuwenden – ohne Markdown-Kenntnisse. * **Markdown-Eingabe:** Tippe Markdown-Syntax direkt in das Textfeld. Die Formatierung wird sofort live als Vorschau gerendert. Beide Methoden können frei kombiniert werden. Es gibt keinen separaten Umschalter – du entscheidest selbst, wie du arbeitest. #### Die Toolbar Die Toolbar befindet sich am oberen Rand des Editors und bietet folgende Funktionen:
ButtonFunktion
BText fett formatieren
IText kursiv formatieren
PParagraph – normalen Fließtext formatieren
Ungeordnete ListeAufzählungsliste erstellen
Geordnete ListeNummerierte Liste erstellen
Puzzle-IconVariablen-Picker öffnen (siehe Abschnitt Variablen einfügen)
↩ / ↪Rückgängig / Wiederholen
Kopieren-IconInhalt kopieren
Speichern-IconInhalt speichern
#### Unterstützte Markdown-Elemente Folgende Markdown-Elemente werden im Prompt-Editor unterstützt: * `# Überschrift 1` → H1 * `## Überschrift 2` → H2 * `### Überschrift 3` → H3 * `**Text**` → **fett** * `*Text*` → *kursiv* * `- Element` → Ungeordnete Liste * `1. Element` → Geordnete Liste * ` ```code``` ` → Codeblock * `> Text` → Zitat (Blockquote) {% hint style="info" %} Die Formatierung wird sofort live im Editor sichtbar – du siehst direkt beim Tippen, wie der fertige Text aussieht. {% endhint %} ### Verwendung – Was kann man mit dem Prompt-Editor machen? #### Text formatieren Du kannst Text auf zwei Wegen formatieren: **Über die Toolbar:** 1. Markiere den gewünschten Text. 2. Klicke auf den entsprechenden Button in der Toolbar (z. B. **B** für fett). **Per Markdown-Syntax:** 1. Tippe die Markdown-Syntax direkt in das Textfeld (z. B. `**Wichtig**` > **Wichtig**). 2. Die Formatierung wird sofort live gerendert. #### Variablen einfügen Variablen ermöglichen es, Prompts dynamisch mit Inhalten aus der laufenden Unterhaltung zu befüllen – z. B. mit dem Namen des Nutzers oder einer erkannten IBAN. Im Prompt-Editor eingefügte Variablen werden automatisch blau hervorgehoben. So fügst du eine Variable ein: 1. Setze den Cursor an die Stelle im Text, an der die Variable erscheinen soll. 2. Klicke auf das **Puzzle-Icon** in der Toolbar, um den [Variablen-Picker](/epic-ai-platform/epic-ai-platform/ai-agent/build/variablen#variablen-picker) zu öffnen. 3. Wähle die gewünschte Variable aus. 4. Die Variable wird an der Cursorposition eingefügt und blau hervorgehoben. *** ### Speichern und Verwerfen #### Änderungen speichern Klicke auf das **Speichern-Icon** in der Toolbar, um deine Eingaben zu sichern. #### Ungespeicherte Änderungen Wenn du den Editor verlässt, ohne gespeichert zu haben, erscheint ein Hinweisdialog (wie im folgenden Screenshot dargestellt): Du hast drei Optionen: * **Zurück:** Kehre zum Editor zurück, ohne etwas zu ändern. * **Verwerfen:** Alle ungespeicherten Änderungen werden unwiderruflich gelöscht. * **Speichern:** Änderungen werden gespeichert und du verlässt den Editor. {% hint style="warning" %} Achtung: Ein Klick auf „Verwerfen" kann nicht rückgängig gemacht werden. Alle nicht gespeicherten Inhalte gehen verloren. {% endhint %} *** ### Best Practices * **Formatierung gezielt einsetzen:** Nutze Überschriften (H2, H3) und Listen, um lange Prompts übersichtlich zu gliedern. Das erleichtert die spätere Bearbeitung und macht den Prompt für das Modell leichter verarbeitbar. * **Variablen statt statischer Texte:** Verwende Variablen überall dort, wo sich Inhalte je nach Unterhaltung unterscheiden – z. B. Namen, Nummern oder Produktauswahlen. So muss der Prompt nicht manuell angepasst werden. * **Regelmäßig speichern:** Speichere deinen Prompt regelmäßig während der Bearbeitung. So vermeidest du den Verlust von Änderungen, falls du den Editor versehentlich verlässt. * **Markdown oder Toolbar – je nach Präferenz:** Wer Markdown kennt, kann schneller direkt tippen. Wer unsicher ist, nutzt einfach die Toolbar-Buttons. Beide Methoden führen zum gleichen Ergebnis. # Modelleinstellungen Einstellungen, die für das ausgewählte AI-Modell übernommen werden können. Derzeit steht ausschließlich das space.vars.TERM\_AI**-Modell** Gemini 2.5 Flash zur Auswahl. Es bietet eine optimale Balance zwischen hoher Geschwindigkeit und präziser Logik. **Thinking Budget (Reasoning)** Das **Thinking Budget** steuert, wie intensiv das Modell über eine Antwort nachdenkt, bevor es antwortet – also wie viel „Denkzeit" oder Rechenaufwand es investieren darf. * **Wert `-1`:** Das Budget wird automatisch vom Modell festgelegt. * **Wert `0`:** Reasoning ist deaktiviert – das Modell antwortet direkt ohne Denkphase. * **Werte `1` bis `24576`:** Manuell festgelegtes Token-Budget für das Reasoning. Für das Modell Gemini 2.5 Flash muss das Thinking Budget zwischen `0` und `24576` Token liegen. Ein höheres Budget führt zu langsameren, aber tendenziell präziseren Antworten. Ein niedriges Budget liefert schnellere, aber tendenziell weniger gründliche Ergebnisse. Empfehlung: Verwende höhere Werte bei komplexen Logik-Aufgaben und niedrige Werte für einfache Aufgaben wie Smalltalk oder kurze Transformationen. Um die Kreativität und Stabilität der Antworten zu steuern, können außerdem folgende Parameter angepasst werden.
ParameterFunktionEmpfehlung
SeedEin fester Wert, um die Reproduzierbarkeit der Antworten zu erhöhen.Den Wert leer lassen für natürliche Variation; eine feste Zahl eintragen für identische Tests.
TemperaturSteuert die "Kreativität" oder den Zufall der Antwort.

0.0 - 0.3: Für faktenbasierte Aufgaben & Support.

1.0: Standardwert für normale Dialoge.

> 1.2: Für kreative Gespräche (Vorsicht: instabil).

Top-PBeeinflusst die Auswahl der Wörter basierend auf ihrer Wahrscheinlichkeit.

0.1 – 0.5: Sehr fokussierte, logische Antworten. Gut für technische Anleitungen.

0.9 – 1.0: Natürlicher Sprachfluss mit angemessener Vielfalt.

# Automatisch generieren Diese Funktion ist ein KI-gestützter Assistent, der automatisch Beispielphrasen für Intentionen und FAQs generiert. ### Wo finde ich die Funktion? Die Funktion ist innerhalb von [Intentionen](/epic-ai-platform/epic-ai-platform/ai-agent/build/intentionen) und [FAQs](/epic-ai-platform/epic-ai-platform/ai-agent/build/faqs) verfügbar. Wenn du eine Intention oder ein FAQ-Paar öffnest, klicke unterhalb des Eingabefeldes auf "Automatisch generieren". *** ### Wofür benutze ich es? Mit "Automatisch genereieren" kannst du passende Beispielphrasen zu einem von dir gewählten Thema generieren lassen. Diese Phrasen dienen als Trainingsbeispiele für Intentionen oder FAQ-Paare deines space.vars.TERM\_AI\_AGENTs. Er steht dir in Intentionen und FAQs zur Verfügung: In beiden Bereichen gibst du ein Thema ein, wählst die gewünschte Anzahl an Phrasen und lässt sie so generieren. {% hint style="info" %} Generierten Phrasen werden beim Hinzufügen automatisch in alle aktivierten Sprachen übersetzt. Du musst die Übersetzung also nicht manuell vornehmen. {% endhint %} *** #### Phrasen generieren 1. Klicke im Feld „Neuen Ausdruck hinzufügen" rechts auf **Automatisch generieren**. 2. Es öffnet sich das Dialogfenster „Phrasen generieren". 3. Gib im Feld **Thema** ein Thema ein, zu dem die Phrasen generiert werden sollen – z. B. `Bestellstatus` oder `Passwort zurücksetzen`. 4. Lege im Feld **Anzahl** fest, wie viele Phrasen generiert werden sollen. Der Standardwert ist `10`. 5. Klicke auf **Phrasen generieren**. Der Copilot erstellt nun die gewünschte Anzahl an Beispielphrasen in alle konfigurierten Sprachen und zeigt sie unter „Generierte Phrasen (X)" als Liste an. #### Phrasen auswählen und hinzufügen Nach der Generierung werden alle Phrasen in einer Übersicht aufgelistet. Jede Phrase hat eine Checkbox zur Auswahl. 1. Prüfe die generierten Phrasen und wähle die passenden aus, indem du die jeweilige Checkbox anklickst. Alternativ kannst du oben rechts über **Alle auswählen** sämtliche Phrasen auf einmal markieren. 2. Am unteren Rand des Dialogfensters siehst du die Anzahl der ausgewählten Phrasen – z. B. „2 Phrasen hinzufügen". 3. Klicke auf den Button **„X Phrasen hinzufügen"**, um die ausgewählten Phrasen als Trainingsbeispiele zu übernehmen. 4. Bist du mit dem Ergebnis nicht zufrieden, klicke auf **Neu generieren**, um einen neuen Vorschlag zum gleichen Thema zu erhalten. 5. Um den Vorgang abzubrechen, schließe das Dialogfenster über das **×**-Symbol oben rechts. Die hinzugefügten Phrasen erscheinen anschließend als Trainingsbeispiele in deiner Intention bzw. deinem FAQ-Paar. #### Phrasen nachträglich bearbeiten oder löschen Die vom Copilot generierten Phrasen können nach dem Hinzufügen jederzeit bearbeitet oder gelöscht werden – genau wie manuell erstellte Trainingsbeispiele. #### Beispiel: Trainingsbeispiele für eine FAQ zur Bestellverfolgung erstellen Angenommen, du hast ein FAQ-Paar zum Thema „Bestellstatus abfragen" und möchtest schnell passende Trainingsbeispiele erstellen. 1. Öffne das entsprechende FAQ-Paar. 2. Klicke im Feld „Neuen Ausdruck hinzufügen" auf **Automatisch generieren**. 3. Gib im Feld „Thema" den Text `Bestellstatus abfragen` ein. 4. Belasse die Anzahl auf `10` und klicke auf „Phrasen generieren". 5. Der Copilot generiert Phrasen wie z. B.: * „Wo ist meine Bestellung?" * „Können Sie mir den Status meiner Lieferung mitteilen?" * „Ich möchte wissen, wann mein Paket ankommt." * „Gibt es eine Möglichkeit, meine Bestellung zu verfolgen?" 6. Wähle die passenden Phrasen aus und klicke auf „Phrasen hinzufügen". Die ausgewählten Phrasen stehen nun als Trainingsbeispiele bereit und wurden automatisch in alle aktivierten Sprachen übersetzt. #### Best Practices * Wähle ein möglichst konkretes und beschreibendes Thema. Je präziser das Thema formuliert ist, desto relevantere Phrasen generiert der Copilot. Statt eines allgemeinen Begriffs wie `Hilfe` eignet sich z. B. `Passwort zurücksetzen` oder `Rechnung reklamieren` deutlich besser. * Prüfe die generierten Phrasen vor dem Hinzufügen. Nicht jede generierte Phrase passt perfekt zu deinem Anwendungsfall. Wähle gezielt aus und passe Phrasen bei Bedarf nach dem Hinzufügen an. * Nutze den Copilot als Startpunkt und ergänze manuell. Die KI-generierten Phrasen bilden eine solide Basis. Ergänze diese um branchen- oder unternehmensspezifische Formulierungen, die der Copilot nicht kennen kann. * Generiere Phrasen in mehreren Durchgängen mit leicht unterschiedlichen Themen, um eine größere Vielfalt an Trainingsbeispielen zu erhalten – nutze dazu direkt „Neu generieren" oder starte den Dialog erneut mit einem angepassten Thema. # API-Schlüssel Der API-Schlüssel ermöglicht es, externe Systeme und Webhooks sicher mit deinem AI Agent zu verbinden. Er dient zur Authentifizierung bei API-Anfragen an die Epic AI Platform. ### Wo finde ich das? `AI Agent → Einstellungen → API-Schlüssel` *** ### Was genau ist ein API-Schlüssel? Ein API-Schlüssel (auch: API-Key) ist ein eindeutiger, geheimer Zugangscode. Er wird bei jeder Anfrage an die space.vars.PRODUCT\_NAME-API mitgeschickt, um zu bestätigen, dass die Anfrage von einem autorisierten System stammt. Der Schlüssel wird im HTTP-Header unter dem Namen `x-chatcaptain-key` übermittelt. #### Zwei Schlüssel – ein Zweck Zu jedem space.vars.TERM\_AI\_AGENT stehen zwei gleichwertige Schlüssel zur Verfügung. Beide haben identische Berechtigungen. Der Vorteil: Du kannst einen Schlüssel rotieren, ohne den Betrieb zu unterbrechen. **Typisches Vorgehen bei der Schlüssel-Rotation:** 1. Generiere einen neuen Schlüssel (z. B. Schlüssel 2). 2. Trage den neuen Schlüssel in dein externes System ein. 3. Stelle sicher, dass das externe System den neuen Schlüssel verwendet. 4. Generiere anschließend Schlüssel 1 neu, um den alten ungültig zu machen. *** ### Verwendung – Was kann man damit machen? #### Externe Systeme anbinden Mit dem API-Schlüssel kannst du externe Systeme und Webhooks mit deinem space.vars.TERM\_AI\_AGENTverbinden. Der Schlüssel wird dabei im HTTP-Header jeder Anfrage mitgesendet. *** ### Verwaltung – Generieren und Erneuern #### API-Schlüssel generieren So generierst du einen Schlüssel: 1. Navigiere zu `AI Agent → Einstellungen → API-Schlüssel`. 2. Klicke unter dem gewünschten Schlüssel auf **„Neu generieren"**. 3. Der Schlüssel wird sofort erstellt und angezeigt. #### API-Schlüssel anzeigen und kopieren Der Schlüsselwert ist standardmäßig verdeckt (als Punkte dargestellt). * Klicke auf das **Auge-Symbol**, um den Schlüssel im Klartext anzuzeigen. * Klicke auf das **Kopier-Symbol**, um den Schlüssel direkt in die Zwischenablage zu kopieren. #### API-Schlüssel neu generieren Du kannst jeden Schlüssel jederzeit neu generieren – zum Beispiel, wenn ein Schlüssel kompromittiert wurde oder du ihn regelmäßig rotieren möchtest. So gehst du vor: 1. Navigiere zu `AI Agent → Einstellungen → API-Schlüssel`. 2. Klicke unter dem gewünschten Schlüssel auf **„Neu generieren"**. 3. Ein neuer Schlüssel wird sofort erstellt. {% hint style="warning" %} Der bisherige Schlüssel wird sofort und unwiderruflich ungültig. Alle externen Systeme, die diesen Schlüssel verwenden, können keine Anfragen mehr stellen, bis sie mit dem neuen Schlüssel aktualisiert wurden. Stelle sicher, dass du den neuen Schlüssel zuerst in allen betroffenen Systemen hinterlegst, bevor du den alten neu generierst. {% endhint %} *** ### Best Practices * **Schlüssel geheim halten:** Teile deinen API-Schlüssel niemals öffentlich – z. B. nicht in öffentlichen Code-Repositories, Screenshots oder E-Mails. Wer den Schlüssel kennt, kann im Namen deines space.vars.TERM\_AI\_AGENTs Anfragen stellen. * **Zwei Schlüssel aktiv nutzen:** Nutze beide Schlüssel aktiv, um Ausfallzeiten bei der Rotation zu vermeiden. Wechsle zuerst das externe System auf den neuen Schlüssel, bevor du den alten neu generierst. * **Schlüssel bei Verdacht sofort erneuern:** Wenn du vermutest, dass ein Schlüssel in falsche Hände geraten ist, generiere ihn sofort neu. Der alte Schlüssel ist damit sofort ungültig. * **Regelmäßige Rotation:** Erneuere deine API-Schlüssel regelmäßig (z. B. alle 90 Tage) als Sicherheitsmaßnahme – auch wenn kein konkreter Verdacht besteht. # Kanäle Kanäle bilden die Schnittstellen zwischen AI Agent und Endnutzern. Sie definieren die Kommunikationswege und Plattformen, über die Interaktionen stattfinden können. ### Wo finde ich die Kanäle? Um die Kanäle zu verwalten, gehe wie folgt vor: 1. Klicke auf das Zahnrad-Symbol (Einstellungen) unten links in der Navigation. 2. Wähle in der nun erscheinenden Navigationsleiste den Punkt „Kanäle“. Hier befindet sich eine strukturierte Übersicht aller aktiven Kanäle, gruppiert nach Kanaltyp und Erstellungsdatum. *** ## Verfügbare Kanaltypen **Telefonie** * [Voice-Kanal](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/kanale/voice-kanal) * [Audiocodes](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/kanale/audiocodes-kanal) **E-Mail** * [E-Mail](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/kanale/e-mail-kanal) * [Microsoft Exchange](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/kanale/microsoft-exchange) **Chat** * [Web](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/kanale/web-kanal) * [WhatsApp](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/kanale/whatsapp-kanal) * [Telegram](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/kanale/telegram-kanal) * [Facebook Messenger](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/kanale/facebook-messenger) Debug * [Debug-Channel](/epic-ai-platform/epic-ai-platform/ai-agent/debugging#debug-kanal) *** ### Verwaltung der Kanäle In der Übersicht stehen verschiedene Funktionen zur Steuerung zur Verfügung: * **Kanal erstellen:** Über die Schaltfläche „Kanal hinzufügen“ (oben rechts) können neue Kanäle erstellt werden. Der Einrichtungsprozess unterscheidet sich je nach gewähltem Kanaltyp. * **Kanal löschen:** Ein Kanal kann dauerhaft über das Mülltonnensymbol entfernt werden. Gelöschte Kanäle können nicht wiederhergestellt werden. * **Detailansicht:** Mit Klick auf eine Kanal-Kachel wird die Detailansicht geöffnet. Die Basisdaten sind für alle Kanäle identisch: * **Kanalname:** Zur internen Identifikation. Er kann durch Klick auf den Namen geändert werden. Änderungen werden mit `Enter` bestätigt. * **Kanaltyp:** Dieser kann nachträglich nicht angepasst werden. * **Erstellungsdatum & -zeit:** Automatischer Zeitstempel der Einrichtung. * **Beschreibung:** Optionales Feld für interne Notizen. Änderungen werden mit `Enter` bestätigt. * **Bereitstellungsumgebung:** Gibt an, in welcher Bereitstellungsumgebung der Kanal operiert (Entwicklung, Test, Produktiv). Nicht nachträglich änderbar. Die *Spezifischen Informationen* unterscheiden sich nach Kanaltyp. # Voice-Kanal Vergibt eine Rufnummer, über die der AI Agent erreichbar ist. Der Voice-Kanal ermöglicht es, den space.vars.TERM\_AI\_AGENT direkt mit dem Telefonnetz zu verbinden. Durch die automatisierte Zuweisung einer Rufnummer ist der space.vars.TERM\_AI\_AGENT sofort nach der Erstellung telefonisch erreichbar, ohne dass externe Konten bei Drittanbietern erforderlich sind. ## Erstellung des Kanals Folge diesen Schritten, um eine neue Telefonverbindung einzurichten: 1. **Kanal hinzufügen:** Navigiere zu *Einstellungen > Kanäle* und klicke auf „Kanal hinzufügen“. 2. **Typ wählen:** Wähle die Option „Telefonie verbinden“ und klicke auf „Fortfahren“. 3. **Kanalname:** Vergib einen Kanalnamen. Dieser kann später angepasst werden. 4. **Kanalbeschreibung** (optional)**:** Füge eine Beschreibung hinzu. Diese kann später angepasst werden. 5. **Bereitstellungsumgebung:** Wähle die passende Bereitstellungsumgebung (Entwicklung, Test oder Produktiv). 6. **Abschluss:** Bestätige mit „Fertigstellen“. Die Rufnummer wird nun automatisch generiert. {% hint style="info" %} Die zugewiesene Rufnummer wird in der [Detailansicht](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/kanale#verwaltung-der-kanale) unter „Spezifische Informationen“ angezeigt. Diese Nummer ist fest vergeben und kann nicht geändert werden. {% endhint %} *** ## Konfiguration und Spracheinstellungen Um das Verhalten und die Stimme deines space.vars.TERM\_VOICE\_AGENTs anzupassen, klicke in der Kanalübersicht auf die Schaltfläche „Voice-Kanal konfigurieren“ des gewünschten Kanals. Folgende Einstellungen können vorgenommen werden: * **Stimme:** Zur Auswahl stehen hochwertige Stimmen in verschiedenen Sprachen. * **Timeout für Spracheingabe:** Zeitspanne, nach der der space.vars.TERM\_AI\_AGENT erkennt, dass der Nutzer aufgehört hat zu sprechen (verhindert „ins Wort fallen“). * **Timeout Nachfrage:** Wartezeit bis zur erneuten Eingabeaufforderung, wenn keine Nutzereingabe erfolgt. * **Text für Nachfrage:** Der Standardtext, der nach Ablauf des Timeouts zur erneuten Eingabe auffordert. * **Anzahl Nachfragen:** Maximale Versuche der Nachfrage. Danach wird das Gespräch automatisch beendet. * **Barge-In erlauben:** Globale Einstellung; Aktiviert die Unterbrechungsfunktion. Der space.vars.TERM\_AI\_AGENT stoppt die Ausgabe, sobald der Nutzer spricht. * **DTMF-Eingabe:** Globale Einstellung; Ermöglicht die Eingabe von Daten (z. B. Kundennummern) über die Telefontastatur. #### Mehrsprachigkeit Die Einstellungen für *Stimme* und *Text für Nachfrage* können für jede im space.vars.TERM\_AI\_AGENT hinterlegte Sprache individuell definiert werden. Wähle die zu bearbeitende Sprache einfach über das blaue Drop-down-Menü aus. Alle weiteren Parameter gelten global für den gesamten Kanal. *** #### Spracherkennung Die Spracherkennung ermöglicht es dem space.vars.TERM\_AI\_AGENT, die Sprache des Anrufenden automatisch zu erkennen und das Gespräch in der erkannten Sprache fortzuführen. Die Einstellung wird direkt in den Kanaleinstellungen vorgenommen. Aktiviere die Option „Spracherkennung aktivieren", um die untenstehenden Einstellungsmöglichkeiten freizuschalten. **Unterstützte Sprachen**\ Wähle aus, für welche Sprachen die automatische Spracherkennung aktiv sein soll. Dabei gelten folgende Regeln: * Eine Sprache ist als **Standard** festgelegt – das ist die Basissprache des space.vars.TERM\_AI\_AGENTs und kann nicht abgewählt werden. * Es können bis zu **10 alternative Sprachen** zusätzlich ausgewählt werden. * Aktuell verfügbare Sprachen: Englisch (GB), Deutsch, Französisch, Italienisch. {% hint style="info" %} Die Zuverlässigkeit der Erkennung kann je nach Anwendungsfall variieren und sollte individuell getestet werden. {% endhint %} **Anzahl der berücksichtigten Nutzereingaben**\ Legt fest, nach wie vielen Nutzereingaben die erkannte Sprache verbindlich festgelegt wird. Der Standardwert ist `1`. Hinweis: Diese Einstellung hat keine Auswirkung, wenn die dauerhafte Spracherkennung aktiv ist. **Dauerhafte Spracherkennung (Beta)**\ Wenn diese Option aktiviert ist, wird die Sprache des Anrufenden kontinuierlich – also bei jeder Eingabe – neu ausgewertet. {% hint style="warning" %} Bei dauerhafter Erkennung können kurze oder nicht eindeutig einer Sprache zuweisbare Antworten (z. B. „Ja", „Ok") ungewollte Sprachwechsel auslösen. Ist die Option deaktiviert, erfolgt die Prüfung nur für die oben definierte Anzahl an Nachrichten. {% endhint %} *** #### Hintergrundgeräusche Mit der Funktion „Hintergrundgeräusche" lässt sich während des Gesprächs ein dezentes Umgebungsgeräusch einblenden. Das macht den space.vars.TERM\_VOICE\_AGENT natürlicher und angenehmer für den Anrufenden. Die Einstellung wird direkt in den Kanaleinstellungen vorgenommen. Aktiviere die Option „Hintergrundgeräusche aktivieren", um die untenstehenden Einstellungsmöglichkeiten freizuschalten. **Geräusch auswählen**\ Wähle über das Dropdown-Menü das gewünschte Hintergrundgeräusch aus. Mit dem Play-Button rechts neben dem Dropdown kannst du das Geräusch direkt vorhören, bevor du es aktivierst. Folgende Geräusche stehen zur Verfügung: * **Büro 1** – ruhige Büroatmosphäre * **Büro 2** – etwas belebtere Büroatmosphäre * **Hotel Rezeption** – typische Hotellobby-Geräuschkulisse * **Restaurant** – Restaurantumgebung mit Stimmen und Besteck * **Stadt/Urban** – Straßengeräusche und Stadtleben **Lautstärke**\ Passe die Lautstärke des Hintergrundgeräuschs über den Schieberegler an. Der Wert reicht von `-10` bis `+10`, der Standardwert ist `0`. Empfehlung: Wähle eine niedrige Lautstärke, damit die Sprachausgabe des space.vars.TERM\_AI\_AGENTs jederzeit gut verständlich bleibt. *** ### Stilllegung und Löschung * **Reservierung:** Wird ein Voice-Kanal gelöscht, bleibt die damit verknüpfte Rufnummer 30 Tage lang reserviert. * **Wiederherstellung:** Innerhalb dieser Frist kann die Nummer auf Anfrage manuell durch unseren Support reaktiviert werden. Nach Ablauf der 30 Tage wird die Nummer wieder in den allgemeinen Pool freigegeben. *** ### Best Practices * Sollte der space.vars.TERM\_AI\_AGENT den Anrufenden häufig unterbrechen, obwohl dieser nur eine kurze Sprechpause macht, kann der *Timeout für Spracheingabe* schrittweise erhöht werden. # AudioCodes-Kanal Verbinde den AI Agent mit deinem AudioCodes-Account. {% hint style="info" %} Für die Erstellung dieses Kanaltyps wird ein eigener AudioCodes-Zugang benötigt. Einstellungen müssen möglicherweise in unserer Oberfläche und zusätzlich in der AudioCodes space.vars.TERM\_AI\_AGENT-Connection vorgenommen werden. {% endhint %} AudioCodes ermöglicht es, den space.vars.TERM\_AI\_AGENT über einen AudioCodes-Account direkt mit dem Telefonnetz zu verbinden. Für eine Telefonie-Anbindung ohne erforderlichen Zugang kann unser [Voice-Kanal](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/kanale/voice-kanal) verwendet werden. ## Erstellung des Kanals Folge diesen Schritten, um eine neue Telefonverbindung einzurichten: 1. **Kanal hinzufügen:** Navigiere zu *Einstellungen > Kanäle* und klicke auf „Kanal hinzufügen“. 2. **Typ wählen:** Wähle die Option „AudioCodes verbinden“ und klicke auf „Fortfahren“. 3. **Kanalname:** Vergib einen Kanalnamen. Dieser kann später angepasst werden. 4. **Kanalbeschreibung** (optional)**:** Füge eine Beschreibung hinzu. Diese kann später angepasst werden. 5. **Rufnummer:** Vergib die gewünschte Rufnummer. 6. **Schlüssel:** Ein Authentifizierungsschlüssel wird automatisch generiert. 7. **Bereitstellungsumgebung:** Wähle die passende Bereitstellungsumgebung (Entwicklung, Test oder Produktiv). 8. **Abschluss:** Bestätige mit „Fertigstellen“. {% hint style="info" %} Aus der Kanalübersicht des angelegten Kanals können nun Token und URL für die Verbindung mit AudioCodes kopiert werden. {% endhint %} *** ## Konfiguration und Spracheinstellungen Um das Verhalten und die Stimme deines space.vars.TERM\_VOICE\_AGENTs anzupassen, klicke in der Kanalübersicht auf das Zahnrad-Symbol des gewünschten Kanals. Folgende Einstellungen können vorgenommen werden: * **Stimme:** Die Stimmen können per Freitexteingabe der Stimm-ID geändert werden. Dies ermöglicht auch das hinterlegen von Stimmen anderer Anbieter. Für eine Liste der verfügbaren Azure-Stimmen verweisen wir auf die [Microsoft-Dokumentation](https://learn.microsoft.com/en-us/azure/ai-services/speech-service/language-support?tabs=tts). * **Timeout für Spracheingabe:** Zeitspanne, nach der der space.vars.TERM\_AI\_AGENT erkennt, dass der Nutzer aufgehört hat zu sprechen (verhindert „ins Wort fallen“). * **Timeout Nachfrage:** Wartezeit bis zur erneuten Eingabeaufforderung, wenn keine Nutzereingabe erfolgt. * **Text für Nachfrage:** Der Standardtext, der nach Ablauf des Timeouts zur erneuten Eingabe auffordert. * **Anzahl Nachfragen:** Maximale Versuche der Nachfrage. Danach wird das Gespräch automatisch beendet. * **Barge-In erlauben:** Globale Einstellung; Aktiviert die Unterbrechungsfunktion. Der space.vars.TERM\_AI\_AGENT stoppt die Ausgabe, sobald der Nutzer spricht. * **DTMF-Eingabe:** Globale Einstellung; Ermöglicht die Eingabe von Daten (z. B. Kundennummern) über die Telefontastatur. #### Mehrsprachigkeit Die Einstellungen für *Stimme* und *Text für Nachfrage* können für jede im space.vars.TERM\_AI\_AGENT hinterlegte Sprache individuell definiert werden. Wähle die zu bearbeitende Sprache einfach über das blaue Drop-down-Menü aus. Alle weiteren Parameter gelten global für den gesamten Kanal. *** ### Best Practices * Sollte der space.vars.TERM\_AI\_AGENT den Anrufenden häufig unterbrechen, obwohl dieser nur eine kurze Sprechpause macht, kann der *Timeout für Spracheingabe* schrittweise erhöht werden. # E-Mail-Kanal Gibt dem AI Agent eine E-Mail-Adresse um Mails empfangen zu können. Erlaubt es dem space.vars.TERM\_AI\_AGENT E-Mails zu empfangen. \ Dieser Kanal wird derzeit primär für die Extraktion und Weiterverarbeitung von Informationen sowie der Klassifizierung von E-Mails verwendet. {% hint style="info" %} Das Versenden von E-Mails wird noch nicht unterstützt. Entsprechend ist die Antwort-Option in der Inbox ausgegraut. Kommentare können manuell sowie automatisiert erstellt werden. {% endhint %} ## Erstellung des Kanals Folge diesen Schritten, um eine neue E-Mail-Adresse einzurichten: 1. **Kanal hinzufügen:** Navigiere zu *Einstellungen > Kanäle* und klicke auf „Kanal hinzufügen“. 2. **Typ wählen:** Wähle die Option „E-Mail verbinden“ und klicke auf „Fortfahren“. 3. **Kanalname:** Vergib einen Kanalnamen. Dieser kann später angepasst werden. 4. **Kanalbeschreibung** (optional)**:** Füge eine Beschreibung hinzu. Diese kann später angepasst werden. 5. **Bereitstellungsumgebung:** Wähle die passende Bereitstellungsumgebung (Entwicklung, Test oder Produktiv). 6. **Abschluss:** Bestätige mit „Fertigstellen“. Die E-Mail-Adresse wird nun automatisch generiert. {% hint style="info" %} Die zugewiesene E-Mail-Adresse wird in der [Detailansicht](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/kanale#verwaltung-der-kanale) unter „Spezifische Informationen“ angezeigt. Diese Adresse wird fest vergeben und kann nicht geändert werden. Sie besteht aus: *Kanal-ID+*space.vars.TERM\_AI\_AGENT*<-ID@reply.chatcaptain.com>* {% endhint %} *** ### Funktionsweise * **Einstiegspunkt:** Ein wichtiger technischer Aspekt des E-Mail-Kanals ist die Einordnung der eingehenden Nachrichten. E-Mails starten den Flow grundsätzlich im *Fallback*. * **Hintergrund:** Da eine E-Mail – im Gegensatz zu einem Live-Chat – oft eine zeitversetzte, abgeschlossene Nachricht ohne vorherigen Kontext ist, kann das System nicht sicher zwischen einer Fortsetzung und einem völlig neuen Anliegen unterscheiden. Über den Fallback kann die space.vars.TERM\_AI oder die Intent-Erkennung die Nachricht analysieren und den Nutzer an die richtige Stelle im Flow leiten. * **Dateianhänge:** Es können Anhänge bis zu einer maximalen Größe von 10 MB empfangen werden. * **Threading:** Unterhaltungen werden automatisch in Threads sortiert. Ein Kontakt kann somit mehrere parallele Vorgänge (Threads) eröffnen. # Web-Kanal Das Web-Widget bietet eine barrierefreie Live-Chat-Option für deine Website. Unser Widget ermöglicht eine barrierefreie Live-Chat-Option auf Webseiten. Es ermöglicht Besuchenden die direkte Interaktion mit dem space.vars.TERM\_AI\_AGENT.. Unterhaltungen können über Elemente im Flow gezielt an Teams oder menschliche Agenten übergeben oder über die Inbox jederzeit von Mitarbeitenden übernommen werden. ## Erstellung des Kanals Folge diesen Schritten, um ein neues Web-Widget einzurichten: 1. **Kanal hinzufügen:** Navigiere zu *Einstellungen > Kanäle* und klicke auf „Kanal hinzufügen“. 2. **Typ wählen:** Wähle die Option „Web-Widget verbinden“ und klicke auf „Fortfahren“. 3. **Kanalname:** Vergib einen Kanalnamen. Dieser kann später angepasst werden. 4. **Kanalbeschreibung** (optional)**:** Füge eine Beschreibung hinzu. Diese kann später angepasst werden. 5. **Schlüssel:** Ein Authentifizierungsschlüssel wird automatisch generiert. 6. **Bereitstellungsumgebung:** Wähle die passende Bereitstellungsumgebung (Entwicklung, Test oder Produktiv) und gehe auf "Fortfahren". 7. **Domains:** Hinterlege eine oder mehrere Domains, auf welcher/n das Web-Widget verfügbar sein soll. 8. **Abschluss:** Bestätige mit „Fertigstellen“. Die Rufnummer wird nun automatisch generiert. *** ## Konfiguration und Design Um das Erscheinungsbild des Web-Widgets anzupassen oder technische Details für die Einbindung abzurufen, klicke in der Kanalübersicht auf „Web-Widget konfigurieren“. Alle vorgenommenen Änderungen müssen oben rechts mit „Änderungen speichern“ bestätigt werden. #### Live-Vorschau Auf der linken Seite der Konfigurationsoberfläche befindet sich eine interaktive Visualisierung. Alle Anpassungen an Farben, Texten oder Darstellungen, die auf der rechten Seite vorgenommen werden, werden hier sofort in Echtzeit angezeigt. #### Farben und Darstellung * **Farben:** Die Anpassung erfolgt über Hex-Codes. {% hint style="info" %} **Barrierefreiheit:** Achte bei der Farbwahl auf ausreichende Kontraste, um die Barrierefreiheit für alle Nutzenden zu gewährleisten. {% endhint %} * **Dark-Mode:** Siehe, wie das Widget Nutzenden mit aktiviertem Dark-Mode angezeigt wird. * **Avatar:** Der space.vars.TERM\_AI\_AGENT-Avatar kann optional ein- oder ausgeblendet werden. * **Datenschutzhinweis:** Legt fest, ob Nutzende vor Chat-Start die Nutzungshinweise bestätigen müssen. Optional kann dies direkt an die Cookie-Einstellungen der einbindenden Website gebunden werden. * **Dateiupload:** Aktiviert oder deaktiviert das Icon zum Hochladen von Dateien für den Endnutzer. #### Texte Über das blaue Drop-down-Menü können alle im Widget sichtbaren Texte für jede im space.vars.TERM\_AI\_AGENT verfügbare Sprache individuell angepasst werden. ### Sicherheit und Einbindung #### Domains (Whitelist) Aus Sicherheitsgründen wird das Widget nur auf autorisierten Webseiten geladen. * **Format:** Gib nur die Basis-Domain inklusive Protokoll an, ohne Unterpfade und ohne abschließenden Schrägstrich.\ Beispiel: * Korrekt: `https://example.com` * Falsch: `https://example.com/shop/` #### Einbindung auf der Website In diesem Bereich wird das Code-Script generiert. Kopiere dieses Snippet, um es in den Header oder Body deiner Webseite einzufügen. ### Testen: Das Widget aufrufen Über die Option „Widget aufrufen“ am oberen Seitenrand kannst du das Widget in einem Testfenster öffnen. * **Unterschied zum Debug-Chat:** Im Gegensatz zum [Debug-Chat](/epic-ai-platform/epic-ai-platform/ai-agent/debugging#nutzung-des-debug-chats) werden Nachrichten, die hier erzeugt werden, dauerhaft in der Inbox gespeichert und wie echte Kundenanfragen behandelt. *** ## Best Practice * **Live-Chat-Simluation:** Das Web-Widget eignet sich hervorragend, um reale Support-Szenarien zu testen. * Inbox-Workflow: Öffne die Inbox in einem separaten Tab. * Interaktion: Schreibe dem space.vars.TERM\_AI\_AGENT über das aufgerufene Widget. * Simulation: Nutze die Inbox, um manuell auf space.vars.TERM\_AI\_AGENT-Nachrichten zu antworten, Tags zu vergeben oder gezielt Flows innerhalb der laufenden Unterhaltung anzustoßen. * Bereitstellungsumgebung: Achte darauf, dass das Web-Widget in der Umgebung bereitgestellt wurde, in welcher die Tests erfolgen sollen. * **Vergleich:** Nutze den [Debug-Chat](/epic-ai-platform/epic-ai-platform/ai-agent/debugging#nutzung-des-debug-chats) für schnelle Logik-Tests und das Web-Widget für Tests, die in der Inbox erhalten bleiben sollen. # Telegram-Kanal Der Telegram-Kanal ermöglicht es, deinen AI Agent direkt mit Telegram zu verbinden. ### Wo finde ich das? Navigiere zu `Einstellungen → Kanäle`. Dort siehst du alle bestehenden Kanäle und kannst über „Kanal hinzufügen" einen neuen Telegram-Kanal einrichten (wie im folgenden Screenshot dargestellt). *** ### Erstellung des Kanals Bevor du den Kanal in der space.vars.PRODUCT\_NAME einrichtest, benötigst du einen Telegram-Bot-Token. Diesen erhältst du, indem du in der Telegram-App den offiziellen Bot **@BotFather** kontaktierst und dort einen neuen Bot erstellst. Ein Telegram-Bot-Token sieht z. B. so aus: `123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11` Sobald du deinen Token hast, folge diesen Schritten: 1. **Kanal hinzufügen:** Navigiere zu `Einstellungen → Kanäle` und klicke auf „Kanal hinzufügen". 2. **Typ wählen:** Wähle die Option „Telegram verbinden" und klicke auf „Fortfahren". 3. **Token eingeben:** Trage deinen Telegram-Bot-Token ein und klicke auf „Fortfahren". Die space.vars.PRODUCT\_NAME validiert den Token und zeigt dir anschließend eine Zusammenfassung deines Telegram-Bots an. 4. **Beschreibung (optional):** Füge eine Beschreibung für den Kanal hinzu. Diese kann später angepasst werden. 5. **Bereitstellungsumgebung:** Wähle die passende Bereitstellungsumgebung (Entwicklung, Test oder Produktiv). 6. **Abschluss:** Bestätige mit „Fertigstellen". Der Kanal ist nun aktiv und dein space.vars.TERM\_AI\_AGENT über Telegram erreichbar. *** ### Kanaldetails Nach der Erstellung kannst du die Details des Telegram-Kanals einsehen. Klicke dazu in der Kanalübersicht auf das Info-Symbol des gewünschten Kanals. Folgende Informationen werden angezeigt: * **Kanalname:** Der vergebene Name des Kanals * **Kanaltyp:** Telegram * **Provider-ID:** Der hinterlegte Bot-Token * **Erstellt am:** Erstellungsdatum und -uhrzeit * **Beschreibung:** Die optionale Kanalbeschreibung * **Bereitstellungsumgebung:** Die gewählte Umgebung (z. B. Produktiv) * **Nutzername:** Der Telegram-Username des verknüpften Bots (unter „Spezifische Informationen") {% hint style="info" %} Der Telegram-Nutzername unter „Spezifische Informationen" entspricht dem @Username des Bots in Telegram. Über diesen Namen können Nutzer den Bot in der Telegram-App finden und anschreiben. {% endhint %} *** ### Stilllegung und Löschung Wird ein Telegram-Kanal gelöscht, wird die Verbindung zwischen der space.vars.PRODUCT\_NAME und dem Telegram-Bot sofort getrennt. Der Telegram-Bot selbst bleibt bei Telegram bestehen und kann jederzeit erneut verknüpft werden. {% hint style="warning" %} Nach dem Löschen des Kanals ist der space.vars.TERM\_AI\_AGENT über diesen Telegram-Bot nicht mehr erreichbar. Laufende Gespräche werden abgebrochen. {% endhint %} *** ### Best Practices * Erstelle bei Bedarf für jede Bereitstellungsumgebung (Entwicklung, Test, Produktiv) einen eigenen Telegram-Bot über @BotFather. So vermeidest du, dass Testgespräche im Produktiv-Kanal landen. * Vergib einen aussagekräftigen Kanalnamen, damit du in der Kanalübersicht auf einen Blick erkennst, welcher Bot für welchen Zweck eingerichtet ist. # WhatsApp-Kanal WhatsApp ist ein Messaging-Kanal, über den dein AI Agent direkt mit Nutzern kommunizieren kann. ### Wo finde ich das? Navigiere zu `Einstellungen → Kanäle`. Dort siehst du alle bestehenden Kanäle und kannst über „Kanal hinzufügen" einen neuen WhatsApp-Kanal einrichten. *** ### Voraussetzungen Bevor du den WhatsApp-Kanal in der space.vars.PRODUCT\_NAME einrichtest, benötigst du ein Meta Business-Konto (ehemals Facebook Business Manager). Über dieses Konto werden dein WhatsApp Business Account (WABA) und die zugehörige Telefonnummer verwaltet. Falls du noch kein Meta Business-Konto hast, kannst du es während des Einrichtungsprozesses direkt erstellen. Du benötigst dafür lediglich einen bestehenden Facebook-Account. {% hint style="info" %} Die verwendete Telefonnummer darf nicht bereits mit einem persönlichen WhatsApp-Konto oder der WhatsApp Business App verknüpft sein. Falls die Nummer dort aktiv ist, muss das bestehende Konto zuerst gelöscht werden. {% endhint %} *** ### Erstellung des Kanals Die Einrichtung erfolgt über den sogenannten Embedded Signup von Meta. Das ist ein geführter Anmeldeprozess, bei dem du dich direkt aus der space.vars.PRODUCT\_NAME heraus mit deinem Meta Business-Konto verbindest. Die Verknüpfung, die Telefonnummer und die notwendigen Berechtigungen werden dabei automatisch im Hintergrund eingerichtet. So gehst du vor: 1. **Kanal hinzufügen:** Navigiere zu `Einstellungen → Kanäle` und klicke auf „Kanal hinzufügen". 2. **Typ wählen:** Wähle die Option „WhatsApp verbinden" und klicke auf „Fortfahren". 3. **Mit Meta anmelden:** Klicke auf „Mit Meta anmelden". Es öffnet sich ein Fenster von Meta, das dich durch den Einrichtungsprozess führt: * Melde dich mit deinem Facebook-Konto an. * Wähle ein bestehendes Meta Business-Konto aus oder erstelle ein neues. * Wähle einen bestehenden WhatsApp Business Account (WABA) aus oder erstelle einen neuen. * Bestätige die erforderlichen Berechtigungen, damit Epic AI Nachrichten über deinen WhatsApp-Kanal senden und empfangen kann. 4. **Kanalname vergeben:** Vergib einen aussagekräftigen Namen für den Kanal. 5. **Bereitstellungsumgebung wählen:** Wähle die passende Bereitstellungsumgebung (Entwicklung, Test oder Produktiv). 6. **Abschluss:** Bestätige mit „Fertigstellen". Der Kanal ist nun aktiv und dein space.vars.TERM\_AI\_AGENT über WhatsApp erreichbar. {% hint style="info" %} Meta prüft im Hintergrund, ob dein Unternehmen den WhatsApp-Richtlinien (Commerce Policy) entspricht. In der Regel geschieht das automatisch. Sollte es ein Problem geben, meldet sich Meta innerhalb von 24 Stunden. {% endhint %} *** ### Kanaldetails Nach der Erstellung kannst du die Details des WhatsApp-Kanals einsehen. Klicke dazu in der Kanalübersicht auf das Info-Symbol des gewünschten Kanals. Folgende Informationen werden angezeigt: * **Kanalname:** Der vergebene Name des Kanals * **Kanaltyp:** WhatsApp * **Erstellt am:** Erstellungsdatum und -uhrzeit * **Beschreibung:** Die optionale Kanalbeschreibung * **Bereitstellungsumgebung:** Die gewählte Umgebung (z. B. Produktiv) * **Telefonnummer:** Die mit dem Kanal verknüpfte WhatsApp-Telefonnummer (unter „Spezifische Informationen") Die Telefonnummer unter „Spezifische Informationen" ist die Nummer, über die Nutzer deinen space.vars.TERM\_AI\_AGENT in WhatsApp erreichen können. *** ### Stilllegung und Löschung Wird ein WhatsApp-Kanal in der space.vars.PRODUCT\_NAME gelöscht, wird die Verbindung zwischen Epic AI und dem WhatsApp Business Account getrennt. Die Telefonnummer selbst bleibt in deinem Meta Business-Konto erhalten und kann jederzeit erneut verknüpft werden. {% hint style="warning" %} Nach dem Löschen des Kanals ist der space.vars.TERM\_AI\_AGENT über diese WhatsApp-Nummer nicht mehr erreichbar. Laufende Gespräche werden abgebrochen. {% endhint %} *** ### Best Practices * **Separate Nummern pro Umgebung:** Erstelle bei Bedarf für jede Bereitstellungsumgebung (Entwicklung, Test, Produktiv) eine eigene WhatsApp-Nummer in deinem Meta Business-Konto. So vermeidest du, dass Testgespräche im Produktiv-Kanal landen. * **Aussagekräftige Kanalnamen:** Vergib einen eindeutigen Kanalnamen, damit du in der Kanalübersicht auf einen Blick erkennst, welcher Kanal für welchen Zweck eingerichtet ist. * **Meta Business-Verifizierung:** Lass dein Unternehmen im Meta Business-Konto verifizieren. Ohne Verifizierung gelten Einschränkungen bei der Anzahl der Nachrichten, die du pro Tag versenden kannst. # Facebook Messenger Der Facebook Messenger ist ein Messaging-Kanal, über den dein AI Agent direkt mit Nutzern kommunizieren kann, die deine Facebook-Unternehmensseite kontaktieren. ### Wo finde ich das? Navigiere zu `Einstellungen → Kanäle`. Dort siehst du alle bestehenden Kanäle und kannst über „Kanal hinzufügen" einen neuen Facebook Messenger-Kanal einrichten. *** ### Voraussetzungen Bevor du den Facebook Messenger-Kanal in der space.vars.PRODUCT\_NAME einrichtest, benötigst du eine Facebook-Unternehmensseite. Über diese Seite empfängt und sendet dein space.vars.TERM\_AI\_AGENT Nachrichten im Messenger. Falls du noch keine Facebook-Unternehmensseite hast, erstelle diese vorab über Facebook. Du benötigst dafür einen bestehenden Facebook-Account. *** ### Erstellung des Kanals Die Einrichtung erfolgt über den Signup von Meta. Du meldest dich direkt aus der space.vars.PRODUCT\_NAME heraus mit deinem Facebook-Konto an und wählst die gewünschte Unternehmensseite aus. Die Verknüpfung und die notwendigen Berechtigungen werden dabei automatisch eingerichtet. So gehst du vor: 1. **Kanal hinzufügen:** Navigiere zu `Einstellungen → Kanäle` und klicke auf „Kanal hinzufügen". 2. **Typ wählen:** Wähle die Option „Facebook Messenger verbinden" und klicke auf „Fortfahren". 3. **Mit Meta anmelden:** Klicke auf „Mit Meta anmelden". Es öffnet sich ein Fenster von Meta, in dem du dich mit deinem Facebook-Konto anmeldest und die erforderlichen Berechtigungen bestätigst. 4. **Facebook-Unternehmensseite auswählen:** Nach der Anmeldung zeigt dir Epic AI alle Facebook-Unternehmensseiten an, auf die du Zugriff hast. Wähle die Seite aus, mit der du Epic AI verbinden möchtest. 5. **Zusammenfassung prüfen:** Die space.vars.PRODUCT\_NAME zeigt dir eine Übersicht der gewählten Facebook-Seite und der Änderungen an, die vorgenommen werden: * Die Epic AI App wird zu deiner Facebook-Seite hinzugefügt. * Epic AI ruft eingehende Nachrichten ab. * Epic AI sendet ausgehende Nachrichten. 6. **Beschreibung (optional):** Verfasse eine Beschreibung für den Kanal. Diese kann später angepasst werden. 7. **Bereitstellungsumgebung wählen:** Wähle die passende Bereitstellungsumgebung (Entwicklung, Test oder Produktiv). 8. **Abschluss:** Bestätige mit „Kanal hinzufügen". Der Kanal ist nun aktiv und dein space.vars.TERM\_AI\_AGENT über den Facebook Messenger erreichbar. *** ### Kanaldetails Nach der Erstellung kannst du die Details des Facebook Messenger-Kanals einsehen. Klicke dazu in der Kanalübersicht auf das Info-Symbol des gewünschten Kanals. Folgende Informationen werden angezeigt: * **Kanalname:** Der vergebene Name des Kanals * **Kanaltyp:** Facebook Messenger * **Erstellt am:** Erstellungsdatum und -uhrzeit * **Beschreibung:** Die optionale Kanalbeschreibung * **Bereitstellungsumgebung:** Die gewählte Umgebung (z. B. Produktiv) * **Facebook-Seite:** Der Name der verknüpften Facebook-Unternehmensseite Die Facebook-Seite unter „Spezifische Informationen" ist die Seite, über deren Messenger Nutzer deinen space.vars.TERM\_AI\_AGENT erreichen können. *** ### Stilllegung und Löschung Wird ein Facebook Messenger-Kanal in der space.vars.PRODUCT\_NAME gelöscht, wird die Verbindung zwischen Epic AI und der Facebook-Unternehmensseite getrennt. Die Facebook-Seite selbst bleibt bestehen und kann jederzeit erneut verknüpft werden. {% hint style="warning" %} Nach dem Löschen des Kanals ist der space.vars.TERM\_AI\_AGENT über den Messenger dieser Facebook-Seite nicht mehr erreichbar. Laufende Gespräche werden abgebrochen. Die Nachrichten sind dann direkt über das Postfach deiner Facebook Seite zugänglich, aber nicht mehr über Epic AI. {% endhint %} *** ### Best Practices * **Separate Seiten pro Umgebung:** Erstelle bei Bedarf für jede Bereitstellungsumgebung (Entwicklung, Test, Produktiv) eine eigene Facebook-Seite. So vermeidest du, dass Testgespräche im Produktiv-Kanal landen. * **Aussagekräftige Kanalnamen:** Vergib einen eindeutigen Kanalnamen, damit du in der Kanalübersicht auf einen Blick erkennst, welcher Kanal für welchen Zweck eingerichtet ist. # Microsoft Exchange Verbinde deine Microsoft-Exchange-Postfächer mit dem Agent zum Senden und Empfangen von E-Mails. Der Microsoft-Exchange-Kanal bindet einen vorhandenen Exchange-Posteingang aus deinem Microsoft-365-Mandanten an den space.vars.TERM\_AI\_AGENT an. E-Mails, die an dieses Postfach gehen, werden automatisch als Konversationen verarbeitet. Die Verbindung wird über eine Admin-Zustimmung (Admin-Consent) im Microsoft-365-Mandanten hergestellt. Ein Microsoft-365-Administrator bestätigt dabei die nötigen Berechtigungen für das Postfach. Das Verfahren wird während der Einrichtung Schritt für Schritt durchlaufen. **Hinweis:** Anders als beim [E-Mail-Kanal](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/kanale/e-mail-kanal) wird die Adresse nicht automatisch generiert. Du gibst dein bestehendes Postfach selbst an. ### Verwendung – Was kann man damit machen? #### E-Mails empfangen und versenden Über den Microsoft-Exchange-Kanal kann der space.vars.TERM\_AI\_AGENT E-Mails **empfangen und versenden**. Dies ist auf zwei Wegen möglich: * **Über den Flow:** Der space.vars.TERM\_AI\_AGENT verarbeitet eingehende Nachrichten im Flow Builder und kann automatisiert antworten. * **Über die Inbox:** Konversationen lassen sich manuell in der Inbox beantworten. #### **Anhänge** Empfangene E-Mails können Anhänge enthalten. Es können auch welche versandt werden: Hänge eine oder mehrere Dateien – z. B. Dokumente, Rechnungen oder Bilder – direkt an deine Antwort an oder verschicke sie direkt [über den Flow](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/block/elemente-dateien), um sie im Kontext der Konversation an den Kontakt weiterzugeben. Wird eine Datei über den Flow versandt, werden sie dabei als Teil derselben E-Mail versendet und erzeugen keine separate Nachricht. Es können Dateien bis zu einer Größe von 20 MB versendet werden. Überschreitet eine Datei dieses Limit, wird sie nicht versendet und die betroffene Nachricht erhält eine Fehlermeldung, die du über das Info-Symbol in der Inbox einsehen kannst. #### Funktionsweise * **Einstiegspunkt:** Eingehende E-Mails starten den Flow grundsätzlich im **Fallback**. Hintergrund: Eine E-Mail ist – anders als ein Live-Chat – oft eine zeitversetzte, abgeschlossene Nachricht ohne vorherigen Kontext. Über den Fallback kann die Intentions-Erkennung die Nachricht analysieren und den Nutzer direkt an die passende Stelle im Flow leiten. * **Gebündelter Versand:** Nachrichten, die innerhalb eines Teilflows entstehen – also alle Schritte zwischen zwei Nutzereingaben – werden gesammelt und gemeinsam in einer E-Mail verschickt. Anhänge werden dabei an diese E-Mail angehängt. * **Threading:** Unterhaltungen werden automatisch in Threads sortiert. Ein Kontakt kann so mehrere parallele Vorgänge (Threads) eröffnen. ### Erstellung des Kanals 1. **Kanal hinzufügen:** Navigiere zu *Einstellungen > Kanäle* und klicke auf „Kanal hinzufügen“. 2. **Typ wählen:** Wähle die Option „Microsoft Exchange verbinden“ und klicke auf „Fortfahren“. 3. **Kanalname:** Vergib einen Kanalnamen. Dieser kann später angepasst werden. 4. **Kanalbeschreibung** (optional)**:** Füge eine Beschreibung hinzu. Diese kann später angepasst werden. 5. **Bereitstellungsumgebung:** Wähle die passende Bereitstellungsumgebung (Entwicklung, Test oder Produktiv). 6. **Postfach:** Gib die E-Mail-Adresse des Exchange-Postfachs an, welches du verbinden möchtest. 7. **Verbinden:** Klicke auf **„Mit Microsoft verbinden"**. Es öffnet sich ein Popup-Fenster, in dem ein Microsoft-365-Administrator die Berechtigungen für das angegebene Postfach bestätigen muss. 8. **Abschluss:** Nach erfolgreicher Zustimmung erscheint die Bestätigung **„Verbindung erfolgreich!"**. Schließe die Einrichtung mit **„Fertigstellen"** ab. E-Mails werden sofort empfangen und verarbeitet. # Tags und Trigger Tags können Konversationen manuell oder automatisiert zugewiesen werden, um sie zu kategorisieren und zu filtern. Sie lassen sich sowohl manuell in der Inbox als auch automatisch im Flow-Builder setze ### Wo finde ich das? Tags verwaltest du über: `Inbox → Tags` Die Tag-Verwaltung zeigt dir eine tabellarische Übersicht aller vorhandenen Tags mit Name und zugewiesener Farbe. Im space.vars.TERM\_FLOW\_BUILDER stehen Tags als Aktion zur Verfügung – dort kannst du sie einer Konversation automatisch zuweisen oder als Trigger verwenden. *** ### Was genau sind Tags? Tags sind benannte Markierungen mit einer Farbe, die du Konversationen zuordnest. Sie erfüllen zwei Aufgaben: * **Kategorisierung:** Du kannst Konversationen in der Inbox nach Tags filtern und gruppieren – z. B. alle offenen Support-Fälle zu einem bestimmten Thema auf einen Blick sehen. * **Trigger im** space.vars.TERM\_FLOW\_BUILDER**:** Tags können automatisch gesetzt werden und als Auslöser für weitere Aktionen im Flow dienen – z. B. um einen bestimmten Ablauf zu starten, wenn eine Konversation einen bestimmten Status erreicht. Jeder Tag besteht aus: * einem **Namen: S**ichtbar in der Inbox und im space.vars.TERM\_FLOW\_BUILDER * einer **Farbe:** Zur visuellen Unterscheidung; aus einer vordefinierten Palette wählbar *** ### Verwendung – Was kann man mit Tags machen? #### Tags in der Inbox nutzen In der [Inbox](/epic-ai-platform/epic-ai-platform/ai-agent/inbox) kannst du Konversationen manuell mit einem oder mehreren Tags versehen. Das ermöglicht dir: * **Ansichten erstellen:** Zeige nur Konversationen mit bestimmten Tag(s) an. * **Kategorisieren:** Kennzeichne Konversationen nach Thema, Status oder Priorität – z. B. `Fertig` oder `Stopp`. #### Tags im space.vars.TERM\_FLOW\_BUILDER setzen Im space.vars.TERM\_FLOW\_BUILDER kannst du Tags automatisch einer Konversation [zuweisen](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/block/elemente-aktionen#tag-hinzufugen) oder [entfernen](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/block/elemente-aktionen#tag-entfernen). Das ist besonders nützlich, wenn du Konversationen anhand ihres Verlaufs markieren möchtest – ohne manuellen Eingriff. #### Tags als Trigger verwenden Tags können im space.vars.TERM\_FLOW\_BUILDER als Trigger eingesetzt werden. Sobald eine Konversation mit einem bestimmten [Tag versehen](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/tag-hinzugefugt) wird – oder der [Tag entfernt](/epic-ai-platform/epic-ai-platform/ai-agent/build/flow-builder/tag-entfernt) wird, kann dadurch automatisch ein Flow gestartet oder eine Aktion ausgelöst werden. *** ### Verwaltung – Erstellung, Bearbeitung und Löschen #### Tag erstellen 1. Navigiere zu `Inbox → Tags`. 2. Klicke oben rechts auf **„Tag erstellen"**. 3. Es öffnet sich ein Dialog. 4. Gib einen **Namen** für den Tag ein. 5. Wähle eine **Farbe** aus der vorgegebenen Farbpalette aus. 6. Klicke auf **„Tag erstellen"**, um den Tag zu speichern. {% hint style="info" %} Der Name ist später in der Inbox und im space.vars.TERM\_FLOW\_BUILDER sichtbar. Wähle einen aussagekräftigen Namen, damit der Zweck des Tags auf einen Blick erkennbar ist. {% endhint %} #### Tag bearbeiten 1. Navigiere zu `Inbox → Tags`. 2. Fahre mit der Maus über den Tag, den du bearbeiten möchtest – es erscheinen die Schaltflächen **„Bearbeiten"**, ein Stift-Icon und ein Papierkorb-Icon. 3. Klicke auf **„Bearbeiten"** oder das Stift-Icon. 4. Es öffnet sich der Dialog **„Tag anpassen"**. 5. Passe den **Namen** und/oder die **Farbe** an. 6. Klicke auf **„Änderungen speichern"**. {% hint style="info" %} Änderungen am Namen und der Farbe werden automatisch für alle Konversationen übernommen, denen dieser Tag bereits zugewiesen ist. {% endhint %} #### Tag löschen 1. Navigiere zu `Inbox → Tags`. 2. Fahre mit der Maus über den Tag, den du löschen möchtest. 3. Klicke auf das **Papierkorb-Icon**. {% hint style="warning" %} Wenn du einen Tag löschst, wird er automatisch von allen Konversationen entfernt, denen er zugewiesen war. Diese Aktion kann nicht rückgängig gemacht werden. Prüfe vor dem Löschen, ob der Tag noch aktiv in Konversationen oder im space.vars.TERM\_FLOW\_BUILDER verwendet wird. {% endhint %} *** ### Beispiele #### Neuen Teilflow über einen Tag auslösen (E-Commerce: Retouren-Prozess) **Szenario:** Sobald ein Kunde eine Retoure anmeldet, soll automatisch ein Teilflow gestartet werden, der den Rückgabeprozess einleitet – z. B. eine Bestätigungsnachricht sendet und die Retoure intern weiterleitet. **Umsetzung:** 1. Erstelle den Tag `Retoure` mit der Farbe **Rot**. 2. Öffne den space.vars.TERM\_FLOW\_BUILDER und navigiere zu dem Block, in dem eine Retouren-Anfrage erkannt wird. 3. Füge eine Aktion hinzu, die der Konversation den Tag `Retoure` zuweist. 4. Erstelle einen separaten Teilflow, der durch den Tag `Retoure` als Trigger gestartet wird. 5. Dieser Teilflow kann z. B. folgende Schritte enthalten: * Bestätigungsnachricht an den Kunden senden: *„Deine Retoure wurde erfasst. Wir melden uns innerhalb von 24 Stunden."* * Interne Benachrichtigung an das Logistik-Team auslösen. * Konversation einem zuständigen Agenten in der Inbox zuweisen. **Ergebnis:** Jede Konversation, die den Tag `Retoure` erhält, durchläuft automatisch den Rückgabeprozess. Dabei ist egal, ob das Tag automatisch über den Flow oder manuell über die Inbox gesetzt wurde. #### Neue Abzweigungen mit einem TEST-Tag prüfen **Szenario:** Du hast im space.vars.TERM\_FLOW\_BUILDER eine neue Abzweigung eingebaut – z. B. eine alternative Begrüßung für Stammkunden – und möchtest diese gezielt testen, ohne den produktiven Betrieb zu beeinflussen. Alle Test-Konversationen sollen hinterher leicht auffindbar und überprüfbar sein. **Umsetzung:** 1. Erstelle den Tag `TEST` mit einer auffälligen Farbe – z. B. **Limone**. 2. Weise den Tag `TEST` im space.vars.TERM\_FLOW\_BUILDER am Einstiegspunkt der neuen Abzweigung automatisch zu. 3. Filtere anschließend die Inbox nach dem Tag `TEST`, um alle Test-Konversationen gesammelt einzusehen. 4. Prüfe die Konversationen auf korrekte Abläufe, unerwartete Abzweigungen oder fehlerhafte Ausgaben. 5. Sobald die Tests abgeschlossen und alle Konversationen geprüft sind, entferne den Tag `TEST` aus der Abzweigung im space.vars.TERM\_FLOW\_BUILDER. **Empfehlung:** Lösche den Tag `TEST` nicht sofort aus der Verwaltung – er kann für zukünftige Tests wiederverwendet werden. Entferne ihn lediglich aus dem space.vars.TERM\_FLOW\_BUILDER, sobald der Test abgeschlossen ist. *** ### Best Practices * Verwende kurze, eindeutige Namen für Tags. Je klarer der Name, desto einfacher ist die Orientierung in der Inbox und im space.vars.TERM\_FLOW\_BUILDER. * Nutze Farben konsequent und mit System. Weise z. B. **Rot** durchgehend für kritische oder gestoppte Konversationen und **Limone** für abgeschlossene Vorgänge ein. Das erleichtert die visuelle Orientierung, ohne den Tag-Namen lesen zu müssen. * Halte die Gesamtzahl der Tags überschaubar. Zu viele Tags erschweren die Filterung und die Übersicht. Überprüfe regelmäßig, ob alle vorhandenen Tags noch aktiv genutzt werden. * Lösche Tags nur, wenn du sicher bist, dass sie nicht mehr benötigt werden – weder in der Inbox noch im space.vars.TERM\_FLOW\_BUILDER. Das Löschen entfernt den Tag unwiderruflich von allen Konversationen. # Schnellantworten Schnellantworten sind vorgefertigte Textbausteine, mit denen du in der Inbox häufig verwendete Antworten schnell einfügen kannst. ### Wo finde ich das? Schnellantworten werden in den Einstellungen des jeweiligen space.vars.TERM\_AI\_AGENTs verwaltet: `Einstellungen → Schnellantworten` Dort siehst du eine Übersicht aller angelegten Schnellantworten in einer Tabelle mit den Spalten „Name" und „Nachricht". In der **Inbox** rufst du Schnellantworten direkt im Eingabefeld auf, indem du `/` eingibst. Es öffnet sich eine Dropdown-Liste mit allen verfügbaren Schnellantworten. Du kannst nach dem `/` weitertippen, um die Liste zu filtern – z. B. `/Begrüßung`, um nur passende Einträge anzuzeigen. *** ### Erklärung – Was genau sind Schnellantworten? Eine Schnellantwort besteht aus zwei Bestandteilen: * **Name:** Eine kurze, eindeutige Bezeichnung, über die du die Schnellantwort wiederfindest. Der Name dient als Suchbegriff beim Filtern in der Inbox. * **Antwort:** Der eigentliche Text, der beim Auswählen in das Eingabefeld der Inbox eingefügt wird. Schnellantworten sind reine Textbausteine ohne Formatierung und ohne Variablen. Der gespeicherte Text wird exakt so eingefügt, wie du ihn angelegt hast. {% hint style="info" %} Schnellantworten gelten immer pro space.vars.TERM\_AI\_AGENT. Jeder space.vars.TERM\_AI\_AGENT hat seine eigene Sammlung von Schnellantworten. Wenn du dieselbe Schnellantwort in mehreren space.vars.TERM\_AI\_AGENTs benötigst, musst du sie in jedem space.vars.TERM\_AI\_AGENT einzeln anlegen. {% endhint %} *** ### Verwendung – Was kann man damit machen? #### Schnellantworten in der Inbox verwenden 1. Öffne eine Unterhaltung in der Inbox. 2. Klicke in das Eingabefeld und tippe `/`. 3. Es erscheint eine Dropdown-Liste mit allen verfügbaren Schnellantworten. 4. Tippe nach dem `/` weitere Buchstaben, um die Liste nach dem Namen zu filtern (z. B. `/Begrüßung`). 5. Wähle die gewünschte Schnellantwort aus. Der Text wird in das Eingabefeld eingefügt. 6. Bei Bedarf kannst du den eingefügten Text vor dem Absenden noch anpassen. #### Typische Anwendungsfälle * **Begrüßungen:** Eine einheitliche Willkommensnachricht, z. B. „Hallo! Vielen Dank für deine Nachricht. Wie kann ich dir weiterhelfen?" * **Verabschiedungen:** Ein freundlicher Abschluss, z. B. „Vielen Dank für deine Anfrage. Falls du weitere Fragen hast, melde dich gerne jederzeit!" * **Häufige Auskünfte:** Standardantworten auf wiederkehrende Fragen, z. B. Öffnungszeiten, Rückgabebedingungen oder Kontaktdaten. * **Weiterleitungshinweise:** z. B. „Ich leite dein Anliegen an die zuständige Fachabteilung weiter. Du erhältst in Kürze eine Rückmeldung." *** ### Verwaltung – Erstellung, Bearbeitung und Löschen #### Schnellantwort erstellen 1. Navigiere zu `Einstellungen → Schnellantworten`. 2. Klicke auf den Button **„Antwort erstellen"** (oben rechts in der Übersicht). 3. Es öffnet sich ein Dialog mit zwei Feldern: * **Name:** Gib einen kurzen, aussagekräftigen Namen ein (z. B. „Begrüßung" oder „Öffnungszeiten"). * **Antwort:** Trage den gewünschten Antworttext ein. 4. Klicke auf **„Schnellantwort erstellen"**, um die Schnellantwort zu speichern. Die neue Schnellantwort erscheint anschließend in der Übersichtstabelle und steht sofort in der Inbox zur Verfügung. #### Schnellantwort bearbeiten 1. Navigiere zu `Einstellungen → Schnellantworten`. 2. Klicke auf die Schnellantwort, die du bearbeiten möchtest. 3. Es öffnet sich ein Bearbeitungsdialog (siehe Screenshot). 4. Passe den Antworttext an. 5. Klicke auf **„Änderungen speichern"**. Achtung: Der Name einer Schnellantwort kann nachträglich nicht geändert werden. Wenn du den Namen ändern möchtest, musst du die bestehende Schnellantwort löschen und eine neue mit dem gewünschten Namen erstellen. #### Schnellantwort löschen 1. Navigiere zu `Einstellungen → Schnellantworten`. 2. Klicke in der Tabellenzeile der betreffenden Schnellantwort auf den Löschen-Button. {% hint style="warning" %} Eine gelöschte Schnellantwort kann nicht wiederhergestellt werden. Sie steht danach nicht mehr in der Inbox zur Verfügung. {% endhint %} *** ### Beispiele #### Beispiel: Schnellantwort für eine Begrüßung anlegen 1. Navigiere zu `Einstellungen → Schnellantworten`. 2. Klicke auf **„Antwort erstellen"**. 3. Gib folgende Werte ein: * **Name:** `Begrüßung` * **Antwort:** `Hallo! Vielen Dank für deine Nachricht. Wie kann ich dir weiterhelfen?` 4. Klicke auf **„Schnellantwort erstellen"**. 5. Öffne nun eine Unterhaltung in der Inbox. 6. Tippe `/Begrüßung` in das Eingabefeld. 7. Wähle die Schnellantwort aus der Liste aus – der Text wird eingefügt und kann direkt gesendet werden. *** ### Best Practices * **Aussagekräftige Namen verwenden:** Wähle kurze, eindeutige Namen, die den Inhalt der Antwort sofort erkennen lassen (z. B. „Öffnungszeiten" statt „Antwort1"). Das erleichtert das Filtern in der Inbox. * **Einheitliche Namenskonvention:** Lege ein Schema für die Benennung fest, z. B. nach Kategorie: `Begrüßung-Standard`, `Versand-Rückgabe`, `Support-Weiterleitung`. So bleiben die Schnellantworten auch bei wachsender Anzahl übersichtlich. * **Texte regelmäßig prüfen:** Überprüfe deine Schnellantworten in regelmäßigen Abständen auf Aktualität. Veraltete Informationen (z. B. geänderte Öffnungszeiten oder Konditionen) können zu Verwirrung bei Kunden führen. * **Kurz und präzise formulieren:** Schnellantworten sollten auf den Punkt kommen. Lange Texte können in einem Chat-Kontext überladen wirken. Halte die Antworten so kurz wie nötig und so ausführlich wie sinnvoll. * **Vor dem Absenden prüfen:** Auch wenn die Schnellantwort vorgefertigt ist, lohnt es sich, den Text vor dem Senden kurz zu lesen. So stellst du sicher, dass die Antwort zur aktuellen Unterhaltung passt. # (Inbox) Widgets Widgets ermöglichen es, konversationsbezogene Variablenwerte direkt in der Inbox anzuzeigen und bei Bedarf manuell zu bearbeiten. ### Wo finde ich Widgets? **Erstellung und Verwaltung:** `Einstellungen (⚙) → Inbox → Widgets` **Nutzung:** Auf der rechten Seite einer jeden Konversation (sofern eingeblendet). *** ### Was genau sind Widgets? Ein Widget ist eine benannte Karte, die in der Inbox-Seitenleiste einer Konversation angezeigt werden kann. Jedes Widget besteht aus einem oder mehreren **Feldern**, die jeweils mit einer Variable verknüpft sind. Ändert sich der Wert einer Variable im laufenden Flow – z. B. weil der space.vars.TERM\_AI\_AGENT eine Information abgefragt hat – wird dieser Wert automatisch im Widget aktualisiert. Über die Inbox können Agenten Werte auch direkt im Widget manuell anpassen, ohne in den space.vars.TERM\_FLOW\_BUILDER wechseln zu müssen. #### Widget-Typen In der Inbox-Seitenleiste gibt es drei Kategorien von Karten: * **Standard:** Systemseitige Karten wie Tags, Kontaktdaten, Organisationen und Notizen. Diese sind immer verfügbar und nicht über die Widget-Verwaltung konfigurierbar. * **Benutzerdefiniert:** Manuell erstellte Widgets, die mit eigenen Variablen verknüpft sind. Diese werden im Abschnitt `Einstellungen → Inbox → Widgets` erstellt und verwaltet. * [**App-Karten (DataCards)**](/epic-ai-platform/epic-ai-platform/workspace/apps#datacards)**:** Karten, die beim Erstellen von Apps automatisch angelegt werden können. {% hint style="info" %} Dieser Artikel behandelt ausschließlich **benutzerdefinierte Widgets**. {% endhint %} *** ### Erstellung und Verwaltung #### Widget-Übersicht Unter `Einstellungen (⚙) → Inbox → Widgets` findest du eine Übersicht aller angelegten Widgets mit Titel und Anzahl der enthaltenen Felder. Über den Button **„Widget erstellen"** oben rechts legst du ein neues Widget an. Um ein Widget zu löschen, klicke auf das **Mülltonnensymbol** in der entsprechenden Zeile der Tabelle. {% hint style="warning" %} Das Löschen eines Widgets entfernt es dauerhaft aus der Inbox-Seitenleiste aller Konversationen. Verknüpfte Variablen werden dadurch nicht gelöscht. {% endhint %} #### Widget erstellen {% hint style="info" %} Das Erstellen von Widgets ist [Administratoren und Inhabern ](/epic-ai-platform/epic-ai-platform/ai-agent/einstellungen/benutzer#rollen-im-uberblick)vorbehalten. {% endhint %} 1. Navigiere zu `Einstellungen (⚙) → Inbox → Widgets`. 2. Klicke auf „Widget erstellen". 3. Vergib im Abschnitt „Allgemein" einen aussagekräftigen Titel (Pflichtfeld). Dieser Titel erscheint später als Kartenüberschrift in der Inbox-Seitenleiste. 4. Füge im Abschnitt „Felder" über „+ Feld hinzufügen" ein oder mehrere Felder hinzu. Für jedes Feld legst du Folgendes fest: * **Name** (Pflichtfeld): Die Bezeichnung des Feldes, wie sie in der Karte angezeigt wird – z. B. „Vorname", „Status" oder „Geburtsdatum". * **Variable** (Pflichtfeld): Wähle über „Variable auswählen" die Variable aus, deren Wert das Feld anzeigen soll. Es werden benutzerdefinierte Variablen angezeigt. * **Typ**: Legt fest, wie das Feld in der Inbox dargestellt und welche Werte akzeptiert werden. Der Typ wird nur dann angezeigt, wenn das Feld über die Inbox beschreibbar ist. Die verfügbaren Feldtypen richten sich dabei nach dem [Datentypen der Variable](/epic-ai-platform/epic-ai-platform/ai-agent/build/variablen#variable-erstellen).\ Folgende Typen stehen zur Verfügung: * **Text:** Freitext-Eingabefeld für beliebige Zeichenketten. * **Zahl:** Eingabefeld für numerische Werte. Dezimalstellen werden durch Kommata getrennt. * **Checkbox:** Ja/Nein-Auswahl (Häkchen). * **Dropdown:** Auswahlliste mit vordefinierten Optionen. Bei Wahl dieses Typs erscheint der Bereich „Optionen", über den du mit „+ Option hinzufügen" die verfügbaren Auswahlwerte einträgst (z. B. Status = „Gold", „Silber", „Bronze"). * **Datum:** Öffnet in der Inbox einen Kalender zur Datumsauswahl. * **Nur Lesezugriff:** Ist diese Option aktiviert, kann der Wert in der Inbox nur angezeigt, aber nicht manuell bearbeitet werden. Werden Systemvariablen ausgewählt, wird diese Checkbox automatisch aktiviert, da diese nicht bearbeitet werden können. 5. Die Reihenfolge der Felder lässt sich per Drag-and-drop über das Punkte-Symbol (⠿) links neben jedem Feld anpassen. 6. Klicke auf „Speichern", um das Widget anzulegen. #### Widget bearbeiten Mit Klick auf die gewünschte Tabellenzeile öffnet sich die Bearbeitungsansicht des Widgets. Nimm alle Anpassungen vor und bestätige diese mit Klick auf den Speicher-Button. #### Widget löschen 1. Navigiere zu `Einstellungen (⚙) → Inbox → Widgets`. 2. Klicke in der Zeile des gewünschten Widgets auf das **Mülltonnensymbol**. {% hint style="warning" %} Das Löschen ist nicht rückgängig zu machen. Das Widget verschwindet sofort aus der Inbox-Seitenleiste aller Konversationen. Die verknüpften Variablen bleiben erhalten. {% endhint %} *** ### Beispiel: Widget „Kundenprofil" erstellen **Ziel:** Du möchtest in der Inbox auf einen Blick sehen, ob ein Gesprächspartner bereits Kunde ist, welchen Status er hat und wann er geboren wurde – alles aus Variablen, die der space.vars.TERM\_AI\_AGENT im Gespräch befüllt. **Voraussetzung:** Die benutzerdefinierte Variablen `Bereits Kunde`, `Status` und `Geburtsdatum` existieren bereits. 1. Navigiere zu `Einstellungen (⚙) → Inbox → Widgets`. 2. Klicke auf **„Widget erstellen"**. 3. Vergib den Titel `Kundenprofil`. 4. Füge folgende Felder hinzu: * Name: `Bereits Kunde?` | Variable: `Bereits Kunde` | Typ: `Checkbox` * Name: `Status` | Variable: `Status` | Typ: `Dropdown` | Optionen: `Gold`, `Silber`, `Bronze` * Name: `Geburtsdatum` | Variable: `Geburtsdatum` | Typ: `Datum` 5. Klicke auf **„Speichern"**. Das Widget erscheint ab sofort in der Inbox-Seitenleiste aller Konversationen. Sobald der space.vars.TERM\_AI\_AGENT im Gespräch die entsprechenden Variablen befüllt, werden die Werte automatisch in der Karte angezeigt. *** ### Best Practices * **Aussagekräftige Feldnamen wählen:** Der Feldname ist das, was Agenten in der Inbox sehen. Verwende klare Bezeichnungen wie „Kundenstatus" statt „Status\_var\_2". * **Nur Lesezugriff gezielt einsetzen:** Setze Felder auf „Nur Lesezugriff", wenn der Wert ausschließlich durch den Flow befüllt werden soll und eine manuelle Änderung durch Agenten unerwünscht ist – z.B. bei automatisch berechneten Werten. * **Feldtypen passend wählen:** Nutze `Dropdown` für Felder mit einer begrenzten Anzahl definierter Ausprägungen (z.B. Kundenstatus). So vermeidest du Tippfehler und inkonsistente Einträge. * **Widgets schlank halten:** Begrenze die Anzahl der Felder pro Widget auf das Wesentliche. Zu viele Felder machen die Karte unübersichtlich. Erstelle lieber mehrere thematisch fokussierte Widgets. # Account Die Account-Einstellungen ermöglichen es dir, dein persönliches Benutzerprofil zu verwalten und deinen Verfügbarkeitsstatus zu steuern. ### Wo finde ich die Account-Einstellungen? Die Account-Einstellungen sind in der space.vars.TERM\_AI\_AGENT-Oberfläche verfügbar. Das Account-Symbol befindet sich immer unten links in der Navigation. Klicke auf **Account**, um das Account-Menü zu öffnen. Von dort aus hast du Zugriff auf: * den **Abwesenheitsmodus** * die Schaltfläche **Konto verwalten** (führt zu deinem Benutzerprofil) * die Option **Abmelden** *** ### Erklärung – Was sind die Account-Einstellungen? Das Account-Menü zeigt deinen Namen, deine E-Mail-Adresse sowie die wichtigsten Account-Optionen. Die Account-Einstellungen umfassen zwei Bereiche: * **Benutzerprofil:** Hier pflegst du deine öffentlich sichtbaren Profildaten wie Benutzername und Profilbild. * **Abwesenheitsmodus:** Hier steuerst du deinen Verfügbarkeitsstatus innerhalb der Plattform. *** ### Verwendung – Was kann ich damit machen? #### Abwesenheitsmodus aktivieren und deaktivieren Mit dem Abwesenheitsmodus signalisierst du, dass du vorübergehend nicht verfügbar bist. Wenn der Abwesenheitsmodus aktiviert ist: * Erhältst du **keine Benachrichtigungen**. * Wirst du in den [Statistiken als offline ](/epic-ai-platform/epic-ai-platform/ai-agent/statistiken#inbox-statistiken)angezeigt. **So aktivierst oder deaktivierst du den Abwesenheitsmodus:** 1. Klicke unten links auf **Account**. 2. Klicke auf den Schalter neben **Abwesenheitsmodus**. * Schalter deaktiviert: Du bist verfügbar. * Schalter aktiviert: Du bist abwesend. *** ### Verwaltung – Benutzerprofil bearbeiten Unter **Konto verwalten** kannst du dein persönliches Benutzerprofil anpassen. Einige Einstellungen in deinem Benutzerprofil sind **öffentlich sichtbar** und können von anderen Nutzern eingesehen werden. Achte daher auf die entsprechenden Hinweise bei jedem Eingabefeld. #### Benutzerprofil öffnen 1. Klicke unten links auf **Account**. 2. Klicke auf **Konto verwalten**. 3. Du befindest dich jetzt auf der Seite **Dein Benutzerprofil**. #### Profilbild ändern 1. Klicke auf das Profilbild-Symbol. 2. Lade ein Bild hoch. 3. Klicke auf **Änderungen speichern**. #### Benutzernamen ändern 1. Klicke in das Feld **Dein Benutzername**. 2. Passe deinen Namen an. 3. Klicke auf **Änderungen speichern**. {% hint style="info" %} Das Profilbild und der Benutzername sind öffentlich sichtbar. {% endhint %} *** ### Best Practices * **Abwesenheitsmodus konsequent nutzen:** Aktiviere den Abwesenheitsmodus, wenn du längere Zeit nicht erreichbar bist. So bleibt dein Verfügbarkeitsstatus in den Statistiken korrekt und nachvollziehbar. * **Aussagekräftigen Benutzernamen wählen:** Verwende deinen echten Namen oder einen klar erkennbaren Namen, damit Kollegen dich in der Plattform eindeutig identifizieren können. * **Profilbild hochladen:** Ein Profilbild erleichtert die Zusammenarbeit im Team, da Personen auf einen Blick erkennbar sind. # Changelog Alle Anpassungen an der Epic-AI-Plattform werden in den Unterseiten festgehalten. {% hint style="success" %} **Neuste Version:** [2.0.1](/updates-and-anderungen/changelog/2.0.1) {% endhint %} *** Die Änderungen werden in drei Kategorien unterteilt: * **Neue Features / Neu**: Diese Kategorie umfasst alle neuen Funktionen, die in der Plattform eingeführt wurden, um die Benutzererfahrung zu erweitern oder neue Möglichkeiten zu bieten. Beispielsweise neue Funktionen, erweiterte KI-Interaktionen oder zusätzliche Benutzerverwaltungsmöglichkeiten. * **Änderungen / Verbessert**: Hier werden bestehende Funktionen oder Komponenten der Plattform verbessert. Dies kann sich auf eine optimierte Benutzeroberfläche, schnellere Reaktionszeiten oder erweiterte Integrationen beziehen, die die Effizienz oder die Benutzerfreundlichkeit steigern. * **Bugfixes / Behoben**: In dieser Kategorie werden Fehler, die in der Plattform aufgetreten sind, behoben. Das umfasst Probleme wie Abstürze, Fehlfunktionen in der Benutzeroberfläche oder unerwartetes Verhalten der Bots, die jetzt korrigiert wurden, um die Stabilität und Benutzererfahrung zu verbessern. # 2.0.1 10.07.2026 ### Änderungen / Verbessert * Performanceupdates * Sicherheitsupdates **Microsoft Exchange** * Der Dateiversand über den Flow wurde implementiert. Es können bis zu 20 mb pro E-Mail verschickt werden. Nachrichten eines Teil-Flows werden zu einer gemeinsamen Nachricht zusammengefasst. #### Bugfixes / Behoben **Modelltraining** * Waren zwei Varianten derselben Sprache aktiv, konnte dies zu identischen Beispielen führen, die das Modelltraining verhindert haben. Dieses Verhalten wurde behoben. # 2.0 10.07.2026 ## Neues Frontend Unsere Plattform hat ein neues Gesicht bekommen – schlanker, klarer, aufgeräumter. Die wichtigsten Abläufe bleiben, wo sie waren, drumherum ist vieles leichter zu bedienen. Mit dem neuen Frontend verabschieden wir uns auch von drei Bezeichnungen: *ChatCaptain* lassen wir hinter uns; die Version 2.0 startet unter dem Namen *Epic AI Platform*. Die Bezeichnung *Bot* bildet unserer Meinung nach schon lange nicht mehr ab, was unsere Plattform inzwischen ausmacht: Den Wechsel vom bloßen Ausführen ins Handeln. So werden aus *Bots* unsere *AI Agents* und aus *Bot Builder* unser neuer *Flow Builder*. Wir wünschen viel Freude im neuen Look Eure Epic AI Team *** ## Die wichtigsten Änderungen auf einen Blick #### Neues Design * Alle Sektionen erhalten einen frischen Look * Navigation bleibt inhaltlich gleich oder sehr nah am gewohnten Design, doch entfällt die blaue Seitenleiste. * Apps sind final in die Einstellungen umgezogen – die bisherige Dopplung ist damit Geschichte * Flow Builder: Schritte sind schlanker, die Farben frischer, viele kleine Usability-Funktionalitäten erleichtern das Erstellen von Flows und den darin enthaltenen Schritten. #### Usability & Navigation * Einklappbare Seitenleiste, auch in der Inbox – mehr Platz fürs Wesentliche * Tastaturbedienung an sinnvollen Stellen optimiert – Ausfüllen ganz ohne Maus * Neue Suchleisten und Filter in vielen Sektionen * Aufgeräumtes Dashboard mit schnellerem Zugriff auf Workspace und Agent * Konversationsstartdatum wird direkt in der Konversation angezeigt * Hochgeladene Quellen werden übersichtlicher dargestellt, inkl. Überschriften-Navigation * Im Flow-Builder lassen sich Verbindungen jetzt überall auf einem Step platzieren * Legacy-Feature „WhatsApp Template (legacy)" wurde entfernt * **Einladungen & Rollen:** mehrere Personen lassen sich jetzt in einem Schritt einladen und mit Rollen versehen #### Größere Änderungen * **Wissensorganisation:** Wissensquellen und Wissensgruppen sind jetzt auf einer Seite zusammengeführt * **Kanalübersicht:** Die Kanäle haben einen gänzlich neuen Look erhalten – der Erstellungsprozess bleibt im Kern gleich *** ### Neue Features / Neu **Voice** * Der Voice-Kanal wurde um weitere Stimmen (xAI) ergänzt. **Export** * Die KI-Einstellung "Generative KI" wird nun geloggt und kann über die Rohdaten ausgewertet werden. Das [Datenmodell](/epic-ai-platform/epic-ai-platform/ai-agent/statistiken/export-and-datenmodell#datenmodell) wurde entsprechend ergänzt. ### Änderungen / Verbessert * Umfangreiche Performanceupdates * Sicherheitsupdates **Flow Builder** * Verzögerungsschritte haben eine zusätzliche Einstellung erhalten. Es kann nun entschieden werden, ob das Abschließen der Konversation zum Abbruch der Verzögerung führen soll. #### Bugfixes / Behoben * Es war möglich mit Verzögerungs-Schritten unendliche Loops zu bauen. Das Verhalten wurde unterbunden. * Das Verhalten von A/B-Splits war mit der Einstellung "Nutzer an dieselbe Variante weiterleiten" teilweise inkorrekt. # 1.0.29 Veröffentlicht am 01.07.2026 ### Neue Features / Neu **Kanäle** * **Neuer Kanal:** Wir bieten die Anbindung von Microsoft Exchange nun bequem über die Oberfläche an. Zur Anbindung wird das *Admin-Consent-*Verfahren von Microsoft genutzt. * Die Stimmauswahl unseres Voice-Kanals wurde um weitere Stimmen in allen Sprachen ergänzt. **Wissen – Website-Crawling** * Das Wissen unterstützt jetzt Website-Crawling. Ausgehend von einer Start-URL können Unterseiten automatisch erfasst und als Quelle verwendet werden. *** ### Änderungen / Verbessert * Performanceupdates * Sicherheitsupdates **Statistik** * Schrittnamen werden zum Zeitpunkt der Ausführung gespeichert. Wird ein Schritt später umbenannt, bleibt in älteren Statistik-Einträgen der vorherige Name erhalten. Wird ein Schritt gelöscht, bleibt der Name erhalten. Gelöschte Schritte werden mit einem Gelöscht-Badge gekennzeichnet. **Export** * Das Datenmodell wurde um zwei Spalten erweitert: `label` und `flow_label`. Diese enthalten den Namen eines ausgeführten Schrittes sowie des dazugehörigen Flows. **Apps** * Apps kann nun ein eigenes Erscheinungsbild gegeben werden: App-Module können so zur besseren Übersicht mit individuellen Farben sowie Logos versehen werden. Die Konfiguration wird auf Workspace-Ebene vorgenommen und gilt sofort für alle verwendeten Module. # 1.0.28 Veröffentlicht am 10.06.2026 ### Neue Features / Neu **Ende-Schritt** * Mit dem Ende-Schritt kannst du einen Flow im Bot-Builder explizit beenden und optional die Konversation schließen. Über ein konfigurierbares Textfeld (Payload) lässt sich zusätzlich ein Wert für statistische Auswertungen mitgeben. #### Änderungen / Verbessert **Inbox-Benachrichtigungen** * Die Performance der Benachrichtigungen wurde optimiert. Zusätzlich können Benachrichtigungen nun auch dann ausgelöst werden, wenn Unterhaltungen einem Team zugewiesen werden. **Allgemein** * Sicherheitsupdates * Performanceupdates #### Bugfixes / Behoben **Epic AI Copilot** * War eine andere Standardsprache als Deutsch eingestellt, kam es zu Problemen mit unserem Epic AI Copiloten. Das Verhalten wurde korrigiert und andere Standardsprachen werden korrekt unterstützt. ​ # 1.0.27 Veröffentlicht am 21.05.2026 ### Änderungen / Verbessert **Allgemein** * Sicherheitsupdates * Performanceupdates **API-Dokumentation** * Wir haben zwei neue Endpunkte für custom views bereitgestellt. Mit diesen lassen sich die Konversationen in einer View sowie deren Anzahl zurückgeben. **Modelltraining** * Der Trainingsablauf wurde optimiert. Zusätzlich unterbindet die Oberfläche aktiv das erneute Anstoßen eines Trainings, wenn bereits eines läuft. # 1.0.26 Veröffentlicht am 07.05.2026 ### Änderungen / Verbessert * API-Dokumentation der Variablen-Endpunkte um eine klare Beschreibung des Rückgabe-Scopes ergänzt. * LeadAI: Hinweis ergänzt, dass Tool-Namen keine Leerzeichen enthalten dürfen. ### Bugfixes / Behoben * Webapp-Seiten laden nach längerer Inaktivität wieder zuverlässig – ein manueller Refresh ist nicht mehr nötig. * Inbox: Die Auswahl der DataCards bleibt nach einem Chatwechsel oder Seitenreload erhalten. * LeadAI-Step mit „Benutzerdefiniert = 0" löst nun auch beim direkten Einstieg ohne vorherige Nutzereingabe korrekt aus (insbesondere im Voice-Kanal relevant). # 1.0.25 Veröffentlicht am 06.05.2026 ### Änderungen / Verbessert **Variablen** * Das Variablenmodell wurde grundlegend erweitert: Benutzerdefinierte Variablen lassen sich nun entweder der Kategorie **Konversation** oder **Kontakt** zuordnen. Der Geltungsbereich wird beim Anlegen der Variable festgelegt und kann im Nachhinein nicht mehr geändert werden. * **Konversation:** Die Variable gilt nur für die aktuelle Konversation. Nach dem Ende einer Unterhaltung wird der Wert nicht weiter gespeichert. * **Kontakt:** Die Variable ist dem Kontakt dauerhaft zugeordnet. Ihr Wert bleibt über mehrere Konversationen hinweg erhalten und steht beim nächsten Kontakt wieder zur Verfügung. * Die Kategorienbezeichnungen im Variablen-Picker wurden angepasst: „Unterhaltung" heißt jetzt **Konversation**, „Benutzer" heißt jetzt **Kontakt**. Die Suche im Variablen-Picker zeigt die Kategorie entsprechend an. # 1.0.24 Veröffentlicht am 24.04.2026 ### Neue Features / Neu **Benutzerrollen** * Es wurde eine neue Benutzerrolle auf Agent-Ebene hinzugefügt. Die Rolle "Statistik-Betrachter" gewährt Lesezugriff auf alle Statistiken des jeweiligen Bots. Alle anderen Bereiche der Plattform sind nicht zugänglich. * **Anwendungsfall:** Ideal für externe Dienstleister oder Supervisoren, die Auswertungen einsehen, aber keine Konfigurationen vornehmen oder Konversationen einsehen sollen. **(Inbox) Widgets** Mit Inbox Widgets lassen sich Variablen in Karten sammeln und direkt in der Inbox pflegen. Die Widgets erscheinen in der rechten Seitenleiste einer Konversation und können von Agents gelesen und befüllt werden. * **Konfiguration**: Widgets können von Admins und Inhabern eingerichtet werden. Die konfigurierten Karten stehen allen Inbox-Benutzern zur Verfügung und können individuell ein- oder ausgeblendet werden. Die Position kann dabei von jedem Benutzenden frei konfiguriert werden. * **Datenpflege:** Felder lassen sich direkt in der Konversation bearbeiten. Schreibgeschützte Felder (Systemvariablen sowie Adminkonfiguration) sind visuell entsprechend gekennzeichnet. ### Änderungen / Verbessert **Voice-Kanal** * Unser Voice-Kanal wurde durch weitere Stimmen ergänzt. # 1.0.23 Veröffentlicht am 16.04.2026 ### Änderungen / Verbessert **Gespräch führen & Prompt ausführen** * Der mitgegebene Gesprächskontext lässt sich jetzt granular steuern. Über das Dropdown `Weitere Einstellungen → Gesprächsverlauf als Kontext nutzen` legst du fest, wie viel Gesprächsverlauf an den Schritt übergeben wird. Je nach Schritttyp stehen unterschiedliche Optionen zur Verfügung: * **Gespräch führen:** Letzte Eingabe (Standard), Gesamter Gesprächsverlauf oder Benutzerdefiniert (0–N). * **Prompt ausführen:** Kein Gesprächsverlauf (Standard), Gesamter Gesprächsverlauf oder Benutzerdefiniert (0–N). * Hinweis: Die Einstellung betrifft nur den Kontext von außerhalb des Schritts. Der Kontext innerhalb des aktuellen Schritts bleibt immer erhalten. # 1.0.22 Veröffentlicht am 08.04.2026 ### Änderungen / Verbessert **Prompt ausführen** * Die Übergabe von Notizen an KI-Schritte lässt sich jetzt gezielt steuern. Im Schritt „Prompt ausführen" bestimmt die neue Einstellung „Notizen in Gesprächsverlauf berücksichtigen", ob Notizen aus Block-Schritten als Kontext an die KI übergeben werden. Die Option ist standardmäßig deaktiviert. * Hinweis: Bei bestehenden „Prompt ausführen"-Schritten wurde die Option automatisch aktiviert, um das bisherige Verhalten beizubehalten. Prüfe bei Bedarf, ob die Übergabe von Notizen in deinem Anwendungsfall gewünscht ist. **Statistik** * Für eine einwandfreie Zuordnung im Statistik-Export wurden einige Step-Typen um die Flow-ID erweitert. Einträge im Rohdatenexport lassen sich damit eindeutig einem Flow zuordnen. ### Bugfixes / Behoben **Debug-Chat** * In einem seltenen Szenario konnte der Debug-Chat nicht gestartet werden: Wenn ein Flow ohne Zwischeneingabe direkt in einem „Gespräch beenden"-Schritt endete, war der Start aus anderen Schritten heraus blockiert. Das Verhalten wurde korrigiert. # 1.0.21 Veröffentlicht am 31.03.2026 ### Änderungen / Verbessert [**API-Dokumentation**](/api-dokumentation) * Die Swagger/OpenAPI-Dokumentation wurde vollständig überarbeitet und strukturiert: * Alle Endpunkte mit korrekten Request-/Response-Types versehen * Fehlende DTOs und Type-Definitionen ergänzt * Benötigte Permissions pro Endpunkt dokumentiert * "Try it out"-Funktionalität aktiviert – Endpunkte direkt aus der Doku testbar * Redundante und veraltete Einträge wurden entfernt * Einheitliche Gruppierung und Benennung der API-Routen **Prompt ausführen** * Die Übergabe von Notizen an KI-Schritte lässt sich jetzt gezielt steuern. Im Schritt „Prompt ausführen" bestimmt die neue Einstellung „Notizen in Gesprächsverlauf berücksichtigen", ob Notizen aus Block-Schritten als Kontext an die KI übergeben werden. Die Option ist standardmäßig deaktiviert. * Hinweis: Bei bestehenden „Prompt ausführen"-Schritten wurde die Option automatisch aktiviert, um das bisherige Verhalten beizubehalten. Prüfe bei Bedarf, ob die Übergabe von Notizen in deinem Anwendungsfall gewünscht ist. **Statistik** * Für eine einwandfreie Zuordnung im Statistik-Export wurden einige Step-Typen um die Flow-ID erweitert. Einträge im Rohdatenexport lassen sich damit eindeutig einem Flow zuordnen. ### Bugfixes / Behoben **Debug-Chat** * In einem seltenen Szenario konnte der Debug-Chat nicht gestartet werden: Wenn ein Flow ohne Zwischeneingabe direkt in einem „Gespräch beenden"-Schritt endete, war der Start aus anderen Schritten heraus blockiert. Das Verhalten wurde korrigiert. # 1.0.20 Veröffentlicht am 27.03.2026 #### Neue Features / Neu **Voice-Kanal: Hintergrundgeräusche** * In den Kanaleinstellungen (`Kanal → Einstellungen`) können Hintergrundgeräusche konfiguriert werden. Über ein Drop-down-Menü lassen sich verschiedene Szenarien auswählen und deren Lautstärke präzise über einen Schieberegler anpassen. **Voice-Kanal: Automatische Spracherkennung (Beta)** * Multilinguale Unterstützung: Der Voice-Kanal erkennt automatisch die gesprochene Sprache des Nutzers. * Konfigurierbare Erkennung: In den Kanaleinstellungen können bis zu 10 zusätzliche Sprachen aktiviert sowie eine dauerhafte Spracherkennung festgelegt werden. **Standardsprache** * In den Bot-Einstellungen kann die Standardsprache geändert werden. *** #### Änderungen / Verbessert **Optimierung der Benutzeroberfläche und Usability** * Optimierung der Benutzeroberfläche und Usability-Anpassungen für eine verbesserte Handhabung * Informations-Update: Die Anzeige von Gebühreninformationen in den Übersetzungseinstellungen wurde entfernt. **Sicherheits- und Performance-Updates** * Systemstabilität & Datenintegrität: Umfangreiche Hintergrund-Updates optimieren die Verarbeitungslogik von Flows und Triggern. Dies schützt bestehende Konfigurationen vor unbeabsichtigten Änderungen und sorgt für eine saubere Datenstruktur bei der Kontakt- und Konversationserstellung. * Die mit KI-Schritten verbundenen Latenzen wurden optimiert. **Inbox** * Die Synchronisation von Gesprächszuständen (z. B. Telefonie-Status) und die Verwaltung von Schnellantworten wurden beschleunigt, um eine reibungslose Performance in der Inbox zu garantieren. * Die Erstellung und Verwaltung von Kontakten wurde optimiert. Kontakte werden automatisiert über die verschiedenen Kanäle hinweg gepflegt. [Previous1.0.21](https://app.gitbook.com/o/wXYrN1q5ohURJgNXVgUX/s/PuklMpEkV7SuzvbOxCsR/updates-and-anderungen/changelog/1.0.21)[Next1.0.19](https://app.gitbook.com/o/wXYrN1q5ohURJgNXVgUX/s/PuklMpEkV7SuzvbOxCsR/updates-and-anderungen/changelog/1.0.19)![Alexander Claas](https://images.gitbook.com/__img/dpr=2,width=32,onerror=redirect,format=auto,signature=-783442652/https%3A%2F%2Flh5.googleusercontent.com%2F-OFsJhyoli0c%2FAAAAAAAAAAI%2FAAAAAAAAACI%2FTFLHsdZp43U%2Fphoto.jpg)![Rebecca White](https://lh3.googleusercontent.com/a/ACg8ocJZugYxLMfCD8VBsL2LEh8rzlX86OHNrmdURZBOpDwWx4YyVA=s96-c)Last modified 3mo agoDraggable item page/MdsAr061yhVsU6HWndeY was dropped over droppable area :r1kv8:1Password-Menü ist verfügbar. Zur Auswahl Abwärtspfeiltaste drücken. # 1.0.19 Veröffentlicht am 04.03.2026 ### Änderungen / Verbessert **Allgemeine Verbesserungen** * Allgemeine Performance-Optimierung * Optimierung der Benutzeroberfläche und Usability-Anpassungen für eine verbesserte Handhabung * Sicherheitsupdates **Inbox** * **Kontaktzuordnung**\ Die Logik zur Identifizierung von Kontakten wurde optimiert, um eine kanalübergreifend konsistente Historie sicherzustellen. Ab sofort werden wiederkehrende Teilnehmer (z. B. anhand der Rufnummer) korrekt erkannt und bestehenden Profilen zugeordnet, was eine lückenlose Nachvollziehbarkeit aller Konversationen ermöglicht. **App-Store** * Der App-Store wurde grundlegend überarbeitet und für eine bessere Übersicht in Kategorien unterteilt. Zudem wurde eine neue Funktion integriert, über die die Anbindung weiterer Drittsysteme direkt angefragt werden kann. ### Bugfixes / Behoben **Inbox** * Ein Fehler wurde behoben, der bei Benutzern mit der Rolle „Inbox Benutzer (extern)“ temporär zu Einschränkungen innerhalb der Suchfunktion führte. # 1.0.18 Veröffentlicht am 11.02.2026 ### Änderungen / Verbessert **Allgemeine Verbesserungen** * Performance-Optimierung **Inbox** * Bei Anrufen werden in der Inbox die Events *Anruf gestartet* und *Anruf beendet* geloggt. # 1.0.17 ### Neue Features / Neu **SSML-Editor** * Experten-Modus: Ein integrierter XML-Editor ermöglicht die manuelle Konfiguration von SSML-Tags zur Feinsteuerung der Sprachausgabe (z. B. Pausen, Betonung). * **Einschränkungen:** Das Feature ist für unseren Voice-Kanal optimiert. Bei Drittanbietern wie Azure können Anbieterbeschränkungen vorliegen; ElevenLabs wird derzeit nicht unterstützt. * **Hinweise:** Da fehlerhaftes SSML zum Abbruch der Rufannahme führen kann, ist eine sorgfältige Prüfung der Syntax zwingend erforderlich. ### Änderungen / Verbessert **Allgemeine Verbesserungen** * Die Performance wurde optimiert. **Kopieren** * Die Funktionalität zum Kopieren von Flows zwischen Bots wurde grundlegend erweitert, um eine konsistente Datenübertragung sicherzustellen: Neben der vollständigen Beibehaltung aller Sprachvarianten bei unterschiedlichen Bot-Konfigurationen wurde ein intelligentes Variablen-Matching implementiert. Dieses verknüpft Logik-Schritte im Ziel-Bot automatisch über die Variablen-ID oder den Namen. **Wissen** * Der Upload für Wissensquellen wurde um eine Multi-Selektion erweitert, die das gleichzeitige Hochladen mehrerer Dokumente ermöglicht. Hierbei wird eine Dateigröße von bis zu 25 MB pro Einzeldokument sowie eine Gesamgröße von 200 MB pro Upload-Vorgang unterstützt. ### Bugfixes / Behoben **Inbox** * Das Kopieren von Nachrichteninhalten wurde optimiert. * Die Darstellung von Medien innerhalb der Chat-Historie wurde optimiert, um eine korrekte Anzeige beim Scrollen durch längere Konversationen sicherzustellen. # 1.0.16 Veröffentlicht am 14.01.2026 ### Änderungen / Verbessert * Kleine Anpassungen und Verbesserungen im Frontend # 1.0.15 Veröffentlicht am 12.01.2026 ### Neue Features / Neu **Neuer Kanaltyp: Voice** * **Automatisierte Bereitstellung:** Die Anbindung von Voicebots wurde vollständig automatisiert: Ab sofort wird bei der Erstellung eines Voice-Kanals automatisch eine Rufnummer zugewiesen. Es wird kein Account bei einem Drittanbieter für die Erstellung benötigt. * **Dynamische Stimmenwahl:** Sprachanbieter (wie Azure oder ElevenLabs) und deren Stimmen können flexibel in den Kanaleinstellungen gewählt werden. **Statistiken** * Es wurden neue Auswertung für die Nutzung der Inbox in den Statistiken hinzugefügt.
### Änderungen / Verbessert **KI-Antwortverhalten & RAG-Optimierung** * Die Sprachstabilität bei KI-generierten Antworten wurde signifikant verbessert. Durch optimierte Befehlsstrukturen antwortet die KI nun konsistenter in der Sprache des Nutzers. * Die KI berücksichtigt nun präziser die im Bot hinterlegten Sprachen. Dies verhindert, dass der Bot in Sprachen antwortet, die nicht für ihn konfiguriert wurden (es sei denn, die automatische Übersetzung ist aktiv). * In den Schritten „Gespräch führen“ und „Prompt ausführen“ kann nun die Anzahl der berücksichtigten Nutzerinteraktionen für die RAG-Suche individuell eingestellt werden. Dies ermöglicht eine präzisere Steuerung dessen, wie weit die KI in den Kontext der bisherigen Konversation zurückgreift. **Inbox** * Benutzende mit der Rolle „Inbox Benutzer (extern)“ erhalten nun ebenfalls eine Anzeige der Nachrichten-Zähler, um eine bessere Übersicht über ihnen zugewiesene Konversationen zu ermöglichen. * Die Anzeige der Konversations-Zähler (Counts) innerhalb der benutzerdefinierten Ansichten wurde optimiert. * Das Abschließen einer Konversation löst automatisch den Status "Gelesen" aus. **Bot-Builder** * SSML-Ausgaben werden nun auch in chatbasierten Kanälen angezeigt. Gesetzte SSML-Tags werden dabei entfernt. * Die Prompt-Ansicht von KI-Schritten wurde optimiert. * Die Zuverlässigkeit beim Laden und Öffnen von App-Modulen wurde verbessert, insbesondere nach einem Wechsel zwischen verschiedenen Bots oder Workspaces. * Die Erstellung von Variablen wurde durch eine verbesserte Validierung optimiert. Um eine fehlerfreie Verarbeitung im Bot sicherzustellen, müssen Variablennamen nun mit einem Buchstaben beginnen. **Kanal: AudioCodes** * Die Stimmen für AudioCodes-Kanäle können nun per Freitexteingabe der Stimm-ID geändert werden. Für eine Liste der verfügbaren Azure-Stimmen verweisen wir auf die [Microsoft-Dokumentation](https://learn.microsoft.com/en-us/azure/ai-services/speech-service/language-support?tabs=tts). **System-Stabilität & Statistik** * Die Statstiktikansicht wurde für eine bessere Performance optimiert. ### Bugfixes / Behoben **Bot-Builder** * Die Darstellung von Variablenwerten in der Detailansicht wurde optimiert und ein Anzeigefehler bei den Platzhalter-Labels behoben. * Ein Anzeigefehler in KI-Prompts wurde behoben. **Inbox** * Ein Fehler wurde behoben, der in bestimmten Fällen dazu führen konnte, dass Notizen beim Zuweisen von Tags nicht korrekt gespeichert wurden. # 1.0.14 ### Neue Features / Neu * Wir haben einen neuen Kanal hinzugefügt, der den Empfang von E-Mails erlaubt. Der Kanal erhält eine eigene E-Mailadresse. Achtung: Der Versand von E-Mails über den Bot ist (noch) nicht möglich. * Wissensgruppen können nun in KI-Schritten verwendet werden, um den Wissens-Zugriff aktiv zu steuern. Hinweis: Das Feature befindet sich in der Beta-Phase. ### Änderungen / Verbessert * Performanceupdate * Sicherheitsupdate ### Bugfixes / Behoben **Webwidget /** **Debug:** * Punkte am Ende von URLs führen nicht mehr dazu, dass Links nicht per Klick geöffnet werden können **KI-Schritte:** * Markdown-Zeichen werden korrekt escaped **Bot Builder:** * Der Schritt "Kontakt bearbeiten" kann nun problemlos kopiert werden **Statistiken:** * Rohdatenexport eines einzelnen Tages ist nun möglich --- [Next Page](/llms-full.txt/1)