📘 Diamond Benutzerhandbuch – Einführung


Willkommen im Teemant-Benutzerhandbuch.

Dieser Leitfaden soll Ihnen helfen, die Konfiguration und den Betrieb eines Teemant-Arbeitsbereichs zu verstehen – von der grundlegenden Einrichtung bis hin zur täglichen Nutzung. Er bietet einen strukturierten Überblick über jeden Bereich der Plattform und erklärt die Funktion jeder einzelnen Komponente, ohne dabei auf Implementierungsdetails einzugehen.


🎯 Zweck dieses Leitfadens


Ziel dieser Dokumentation ist es:


  • Ihnen ein klares mentales Modell davon zu vermitteln, wie Teemant funktioniert.
  • erläutern Sie die Rolle jeder Arbeitsbereichskomponente.
  • Administratoren, Managern und Entwicklern helfen, sich sicher auf der Plattform zurechtzufinden.


Dies ist keine Schritt-für-Schritt-Anleitung. Stattdessen konzentriert es sich auf Konzepte, Verantwortlichkeiten und bewährte Vorgehensweisen, damit die Dokumentation leicht zu pflegen bleibt und sich reibungslos mit dem Produkt weiterentwickelt.

  • Startseite (Dashboard)
  • KI-Kontexte
  • KI-Guides
  • Nachrichten
  • Veranstaltungen
  • Identifikatoren
  • Werkzeuge


  • Vision
  • Ausgaben
  • Unterlagen
  • Objektmodelle
  • Arbeitsbereichseinstellungen
  • Workspace-Mitglieder
  • Workspace Agent-Benutzer


  • Arbeitsbereichskanäle
  • Arbeitsbereichstransporte
  • Arbeitsbereichsaufgaben
  • Diamond Agents Builder
  • Teemant Agent Calls


👥 Für wen dieser Leitfaden gedacht ist


Dieser Leitfaden richtet sich an:


  • Workspace-Administratoren, die Konfiguration und Zugriff verwalten,
  • Manager, die Benutzer, Kanäle und Abläufe überwachen,
  • Bot-Entwickler entwerfen Agenten, Abläufe und Automatisierungen.


Je nach Ihrer Rolle sind manche Abschnitte möglicherweise relevanter als andere.


🧭 So lesen Sie diese Anleitung


Die Anleitung orientiert sich an der Struktur des Teemant-Arbeitsbereichs:


  • Jeder Abschnitt entspricht einem Menüeintrag in der Plattform.
  • Sie können den Text linear lesen oder mithilfe des unten stehenden Inhaltsverzeichnisses direkt zu einem bestimmten Thema springen.
  • Screenshots und Symbole helfen Ihnen, Funktionen in der Benutzeroberfläche schnell zu erkennen.



Für fortgeschrittene Anwendungsfälle (kundenspezifische Integrationen, APIs oder komplexe Arbeitsabläufe) kann zusätzliche Dokumentation oder Unterstützung erforderlich sein.

🏠 Startseite (Dashboard)

Die Registerkarte „Startseite“ ist das Dashboard des Arbeitsbereichs.


Es bietet einen Überblick über Aktivitäten und Nutzung, wie zum Beispiel:


  • Anzahl der Nutzer,
  • Anzahl aktiver Bots oder Agenten,
  • Konversions- oder Abschlussindikatoren,
  • Aktivitätstrends im Zeitverlauf.


Das Home-Dashboard wird verwendet für:


  • Nutzung der Überwachungsplattform
  • Verständnis der Akzeptanz und des Aktivitätsniveaus,
  • Einen schnellen Statusüberblick erhalten, ohne Konfigurationsbildschirme aufrufen zu müssen.

Es enthält keine Konfigurations- oder Datenverwaltungsfunktionen.

🗃️ Entitäten

Entitäten repräsentieren die eigentlichen Datenbanken externer synchronisierter Daten innerhalb von Teemant.


Sie werden typischerweise verwendet für:


  • Referenzdaten (z. B. Filialen, Standorte, Organisationseinheiten),
  • Geschäftsobjekte aus externen Systemen,
  • Datensätze, die zwischen Agenten und Prozessen geteilt werden.

Hauptmerkmale:


  • Entitäten sind strukturierte Datensätze, keine Dialogelemente.
  • Sie werden häufig über Importe oder Aufgaben mit externen Systemen synchronisiert.
  • Agenten und Guides können Daten aus Entitäten lesen, um Benutzereingaben zu validieren oder anzureichern.


Zusamenfassend:

👉 Entitäten sind der Ort, an dem strukturierte Geschäftsdaten innerhalb von Teemant gespeichert sind.

🛠️ Bauherr

Im Builder wird Prozessintelligenz entwickelt.


Es wird verwendet, um:


  • Leitfäden erstellen (Logik, Fragen, Validierungen, Abläufe),
  • Stell Agenten anhand dieser Anleitungen zusammen.
  • definieren, wie verschiedene Elemente zusammenwirken.


Im Builder definieren Sie:


  • wie sich ein Agent verhält,
  • welche Daten es erwartet,
  • welche Dokumente es verarbeiten kann (E-Mails, Dateien, JSON-Daten, Anhänge),
  • wie Informationen gesammelt, validiert und aufbereitet werden.


Der Builder ist der zentrale Designbereich von Teemant:


  • Leitfäden legen fest, was und wie gesammelt werden soll.
  • Agenten kombinieren Anleitungen mit Daten, Dokumenten und Logik, um reale Prozesse auszuführen.

⚙️ Arbeitsbereich

Der Bereich „Arbeitsbereich“ enthält globale und administrative Einstellungen.


Es dient der Verwaltung von:


  • allgemeine Arbeitsbereichskonfiguration
  • Administratoren und registrierte Agentenbenutzer,
  • Kommunikationskanäle (z. B. WhatsApp, E-Mail, andere Kanäle),
  • Umgebungseinstellungen (Entwicklung, Test, Produktion).

Die Workspace-Einstellungen steuern, wer über welche Kanäle und mit welchen Berechtigungen auf die Plattform zugreifen kann.


Hier wird keine Geschäftslogik definiert – es handelt sich ausschließlich um operative und administrative Angelegenheiten.

🔗 Transporte

Transporte definieren die technischen Mittel des Datenaustauschs zwischen Teemant und externen Systemen.


Beispiele hierfür sind:


  • SFTP Push oder Pull,
  • dateibasierte Austausche,
  • E-Mail-basierte Überweisungen.

Ein Transportmittel beantwortet die Frage:

👉 „Wie werden Daten physisch zwischen Systemen übertragen?“


Es definiert nicht:


  • Welche Daten werden ausgetauscht?
  • wenn es ausgetauscht wird,
  • oder wie es interpretiert wird.


🔄 Aufgaben

Aufgaben werden verwendet, um externe Datenquellen zu scannen, zu importieren oder zu synchronisieren.


Sie sind typischerweise:


  • Überwachung externer Datenbanken oder Dateispeicherorte,
  • Trigger-Importe
  • Entitäten mit neuen oder geänderten Daten aktualisieren.


Die Aufgaben konzentrieren sich auf die Datenerfassung und -synchronisierung, nicht auf die Benutzerinteraktion.

Zurück nach oben

🧠 KI-Kontexte

KI-Kontexte definieren die Verhaltens- und semantische Umgebung, in der die KI operiert.


Sie liefern der KI Hintergrundinformationen, Absichten und Kommunikationsregeln und gewährleisten so, dass die Interaktionen konsistent, relevant und auf die Geschäftserwartungen abgestimmt bleiben.


KI-Kontexte werden von beiden genutzt:


  • Konversationsagenten (Chatbots),
  • und E-Mail-Automatisierungsprozesse.

🌐 Globale Kontexte

Globale Kontexte beschreiben allgemeine, übergreifende Informationen, die für die gesamte Organisation oder den gesamten Arbeitsbereich gelten.


Sie umfassen typischerweise:


  • Firmen- oder Organisationsbeschreibung,
  • allgemeine Geschäftsregeln oder Terminologie,
  • allgemeiner Tonfall und Kommunikationsstil,
  • gemeinsame Einschränkungen oder Annahmen.


Globale Kontexte dienen als gemeinsame Grundlage, die von verschiedenen Akteuren und Prozessen wiederverwendet werden kann und so die Kohärenz auf Plattformebene gewährleistet.

🤖 Agentenkontexte

Agentenkontexte sind spezifisch für einen bestimmten Agenten oder Anwendungsfall.


Sie definieren:


  • was der Agent zu tun hat (z. B. Daten zur Vorfallsmeldung sammeln),
  • Wer die Nutzer sind (Mitarbeiter, Kunden, Partner, interne Teams),
  • wie der Agent kommunizieren sollte (Tonfall, Formalitätsgrad, Anforderungen an die Verständlichkeit),
  • jegliche rollenspezifische oder prozessspezifische Einschränkungen.


Agentenkontexte ermöglichen es der KI, ihr Verhalten je nach dem von ihr unterstützten Geschäftsprozess anzupassen.

🧩 Die Rolle von KI-Kontexten in Leitfäden

Beim Erstellen von KI-Guides muss der Entwickler den passenden Agentenkontext auswählen.


Der ausgewählte Kontext ist dann:


  • wird während jedes Gesprächs angewendet, oder
  • Wird während E-Mail-Verarbeitungsabläufen verwendet.


Der Kontext stellt sicher, dass

:

  • Die KI versteht ihre Rolle.
  • Die Interaktionen entsprechen weiterhin dem beabsichtigten Prozess.
  • Die Reaktionen sind über alle Kanäle hinweg einheitlich.


Zusamenfassend:

👉 KI-Kontexte definieren, wie die KI denkt und kommuniziert, während Leitfäden definieren, was die KI tut.

Zurück nach oben

🧩 KI-Leitfäden

KI-Leitfäden definieren die Anweisungen, die die KI während folgender Vorgänge verwendet:


  • Live-Konversationen (Chatbots),
  • und E-Mail-Verarbeitung (E-Mail-Automatisierung).


Ein Leitfaden beschreibt, welche Informationen gesammelt oder verarbeitet werden müssen, wie sich die KI verhalten soll und wie die Daten strukturiert sind, definiert aber nicht die Transport- oder Integrationslogik.


  • KI-Anleitungen werden von Agenten ausgeführt und operieren stets innerhalb eines definierten KI-Kontexts.

Leitfadentypen


Teemant bietet verschiedene Arten von KI-Guides an, die jeweils einem bestimmten Zweck innerhalb eines Prozesses dienen.

📥 Leitfäden zur Datenerfassung

Mithilfe von Datenerfassungsleitfäden werden strukturierte Informationen auf Basis eines vordefinierten Datenmodells gesammelt.


Sobald ein Datenmodell definiert ist (Felder, Formate, Einschränkungen), kann mithilfe von KI ein Leitfaden erstellt werden.

Jeder Schritt eines Datenerfassungsleitfadens definiert typischerweise:


  • ein (menschenlesbarer) Anzeigename,
  • ein technischer Feldname,
  • ein Feldtyp (Zeichenkette, Zahl, Adresse, Datum usw.),
  • Bot-Anweisungen, die erklären, wie die KI die Informationen sammeln oder validieren soll,
  • Optionale Benutzeranweisungen, wenn eine bestimmte Aktion erforderlich ist.


Die Bot-Anweisungen können Folgendes beinhalten:



  • Validierungen,
  • Abhängigkeiten von zuvor erfassten Werten
  • bedingtes Verhalten.
  • Datenerfassungsleitfäden werden sowohl in Dialogprozessen als auch in der E-Mail-Automatisierung verwendet.

✅ Checklisten-Leitfäden

Checklisten-Leitfäden ähneln Datenerfassungsleitfäden, sind aber für geschlossene Fragen konzipiert.


Sie definieren typischerweise:


  • die angezeigte Frage,
  • verfügbare Auswahlmöglichkeiten (Ja / Nein oder Ähnliches),
  • Bot-Anweisungen
  • optionale Benutzerhinweise
  • ob ein Kommentar erforderlich ist (wahr / falsch).


Checklisten werden häufig verwendet für:


  • Konformitätsprüfungen,
  • Validierungsschritte,
  • Verfahrensbestätigungen.

🧮 Leitfäden für berechnete Felder

Die Leitfäden für berechnete Felder definieren Felder, die automatisch auf Basis zuvor erfasster Werte berechnet werden.


Sie:


  • Folgen Sie ausschließlich den Anweisungen des Bots.
  • erfordert niemals Benutzereingaben
  • werden den Benutzern nicht angezeigt.


Berechnete Felder können in verschiedenen Phasen eines Prozesses verwendet werden, um:



  • aggregierte Werte,
  • Summen berechnen,
  • Zwischenergebnisse ableiten.
  • Diese Felder sind prozessintern, können aber später für Ausgaben oder Integrationen verwendet werden.

Leitfaden-Schnittstellenstruktur


Jeder KI-Leitfaden ist in drei Hauptregisterkarten unterteilt:

📄 Details

Die Registerkarte „Details“ enthält die allgemeinen Einstellungen des Guides, wie zum Beispiel:


  • Anzeigename,
  • Leitfadentyp,
  • zugehöriger KI-Kontext
  • verknüpfter Agent
  • Beschreibung.


Dieser Tab definiert, worum es in diesem Leitfaden geht.

🛠️ Bauen

Im Reiter „Erstellen“ wird die Logik der Anleitung definiert.


Es wird angezeigt:



  • die Liste der Felder oder Fragen auf der linken Seite,
  • Die KI-gestützte Aufforderung und die generierten Anweisungen befinden sich auf der rechten Seite.
  • Dieser Tab definiert das Verhalten des Guides.

✉️ Antwort (nur E-Mail-Automatisierung)

Der Antwort-Tab wird nur für die E-Mail-Automatisierung verwendet.


Es ermöglicht die Konfiguration von:



  • eine E-Mail-Antwortvorlage
  • beigefügte Vorlagendateien,
  • E-Mail-Signatur.
  • Dieser Tab legt fest, wie die KI per E-Mail reagiert, sobald die Verarbeitung abgeschlossen ist oder zusätzliche Informationen benötigt werden.

Zusammenfassung

Zusamenfassend:


  • KI-Kontexte definieren, wie die KI denkt und kommuniziert.
  • KI-Leitfäden definieren, was die KI erfassen, berechnen oder validieren muss.
  • Agenten führen Anweisungen innerhalb eines Prozesses aus.
  • Antwortvorlagen gelten nur für E-Mail-basierte Interaktionen.



Wenn Sie möchten, können wir als Nächstes Folgendes tun:


  • Kürzen Sie dies für eine „Kurzübersicht“-Version.
  • oder die Formulierungen exakt an die Menübezeichnungen anpassen, um eine einheitliche Darstellung auf allen Hilfeseiten zu gewährleisten.

Zurück nach oben

💬 Nachrichten

Nachrichten sind vordefinierte, nicht-KI-gesteuerte Nachrichten, die während einer Konversation versendet werden können.


Es handelt sich um fest codierte Nachrichten, was Folgendes bedeutet:


  • Sie werden nicht von der KI generiert.
  • Sie nutzen weder KI-gestützte Schlussfolgerungen noch Kontext.
  • Sie werden nicht automatisch übersetzt.


Nachrichten werden typischerweise für feste Kommunikationspunkte in einem Prozess verwendet.

Zweck der Nachrichten


Die Nachrichten sind so gestaltet, dass sie:


  • Bestätigungen senden (z. B. Bestätigung am Ende der Konversation),
  • standardisierte Informationen anzeigen,
  • Achten Sie auf eine exakte Formulierung, wo Abweichungen unerwünscht sind.


Sie bieten eine Möglichkeit, kontrollierte, deterministische Nachrichten zusammen mit KI-gesteuerten Interaktionen zu übermitteln.

Wie Nachrichten verwendet werden


Nachrichten können ausgelöst werden:


  • bei bestimmten Gesprächsphasen
  • am Ende eines Prozesses
  • als Systembenachrichtigungen während einer Interaktion.

Sie werden üblicherweise zusammen mit Folgendem verwendet:


  • KI-Leitfäden (die dynamische Logik verarbeiten),
  • Agenten (die den Ablauf steuern).



Hauptmerkmale


  • Die Nachrichten sind statisch.
  • Sie sind sprachspezifisch und müssen gegebenenfalls für jede Sprache separat erstellt werden.
  • Sie gewährleisten die volle Kontrolle über Wortwahl, Tonfall und rechtlich oder regulatorisch sensible Texte.


Zusamenfassend:

👉 Nachrichten ergänzen die KI-Interaktionen, indem sie feste, zuverlässige Kommunikationsblöcke bereitstellen, wo Variabilität nicht akzeptabel ist.

Zurück nach oben

⚡ Veranstaltungen

Ereignisse stellen interne Systemereignisse dar, die während der Ausführung von Prozessen generiert werden.


Sie dienen dazu, wichtige Momente im Lebenszyklus einer Konversation, einer Agentenausführung oder eines Datenverarbeitungsablaufs zu erfassen. Ereignisse können von der Plattform automatisch auf Basis vordefinierter Bedingungen oder Systemaktivitäten ausgelöst werden.


In diesem Abschnitt wird später beschrieben, wie Ereignisse in Teemant definiert, aufgezeichnet und genutzt werden, um Überwachungs-, Automatisierungs- oder Integrationsszenarien zu unterstützen.



In dieser Phase sollten Ereignisse als technische Indikatoren betrachtet werden, die widerspiegeln, was während der Prozessausführung innerhalb der Plattform geschieht.

Zurück nach oben

🔑 Kennungen

Bei den Identifikatoren handelt es sich um eindeutige chronologische Referenznummern, die von Teemant generiert werden, um jede verarbeitete Interaktion zu identifizieren.


Sie dienen der Verfolgung von:


  • Gespräche,
  • E-Mail-Verarbeitungsabläufe
  • und die daraus resultierenden Geschäftsdatensätze, die mit externen Systemen ausgetauscht werden.

Ein Identifikator dient als technische Referenz einer Prozessinstanz vom Anfang bis zum Ende.


Zweck von Kennungen


Kennungen werden verwendet, um:


  • eine Konversation oder E-Mail-Verarbeitungsinstanz eindeutig identifizieren,
  • die Rückverfolgbarkeit über den gesamten Prozesslebenszyklus hinweg gewährleisten
  • Beziehen Sie sich auf denselben Fall in externen Informationssystemen,
  • Erleichterung von Audits, Überwachung und Fehlerbehebung.


Sie stellen einen stabilen Referenzschlüssel bereit, der zwischen Teemant, Benutzern und externen Systemen geteilt wird.


Identifikatorstruktur


Ein Bezeichner wird mithilfe einer Maske definiert, die Folgendes enthalten kann:


  • ein inkrementeller Zähler,
  • Datums- oder Zeitstempelelemente,
  • ein festes Präfix zur Kennzeichnung des Prozesses oder der Umgebung.

Beispielstruktur:


  • Präfix (z. B. DEMO),
  • fortlaufende Nummer,
  • Jahr oder Zeitstempel.


Dies ermöglicht folgende Kennungen:


  • lesbar,
  • sortierbar,
  • und im Laufe der Zeit einzigartig.


Wenn Kennungen generiert werden


Kennungen werden am Ende eines Prozesses, kurz vor Folgendem, generiert:


  • E-Mail-Benachrichtigungen werden versendet,
  • Daten werden in externe Informationssysteme exportiert.
  • Die abschließenden Bestätigungsnachrichten werden zugestellt.


Dies gewährleistet Folgendes:


  • Alle gesammelten oder berechneten Daten sind abgeschlossen.
  • Die Kennung spiegelt einen abgeschlossenen Prozess wider.
  • Derselbe Bezeichner kann konsistent für Ausgaben, Benachrichtigungen und Integrationen wiederverwendet werden.


Rolle bei der Prozessverfolgung


Nach der Generierung kann die Kennung wie folgt lauten:


  • in E-Mails oder Benachrichtigungen enthalten,
  • eingebettet in exportierte Dateien oder Nutzdaten,
  • wird in externen Systemen als Referenzschlüssel gespeichert.


Zusamenfassend:

👉 Identifikatoren machen jede Interaktion nachvollziehbar, überprüfbar und systemübergreifend verknüpfbar.

Zurück nach oben

🧰 Werkzeuge

Tools sind externe Anwendungen, die während eines Prozesses aus Teemant heraus ausgelöst werden können.


Sie ermöglichen es Teemant, seine Fähigkeiten zu erweitern, indem bestimmte Aktionen an spezialisierte Drittanbieteranwendungen delegiert werden, während der Gesamtprozess weiterhin von Teemant gesteuert wird.


Zweck der Werkzeuge


Werkzeuge werden eingesetzt, wenn ein Prozess eine Aktion erfordert, die:


  • kann nicht direkt von der KI ausgeführt werden.
  • muss von einem zertifizierten oder spezialisierten externen System abgewickelt werden.
  • erfordert Benutzerinteraktion außerhalb der Dialogschnittstelle.


Typische Anwendungsfälle sind:


  • Aufnehmen zertifizierter und verschlüsselter Fotos,
  • Erfassung einer digitalen Signatur auf einem Smartphone,
  • Durchführung regulierter oder compliance-relevanter Maßnahmen.


Wie Werkzeuge in Prozessen eingesetzt werden


Ein Werkzeug kann sein:


  • ausgelöst bei einem bestimmten Gesprächsschritt,
  • aufgerufen im Rahmen eines E-Mail-gesteuerten Prozesses,
  • eingebettet in einen Agenten-Workflow.


Wird dies ausgelöst, wird der Benutzer zur externen Anwendung weitergeleitet oder dorthin geführt, und das Ergebnis wird dann an Teemant zurückgegeben, um den Prozess fortzusetzen.


Integration und Partner


Alle Werkzeuge benötigen:


  • eine technische Integration mit Teemant,
  • und werden von Teemant-zertifizierten Partnern bereitgestellt.


Dies gewährleistet:


  • Sicherheit und Datenintegrität
  • Einhaltung der regulatorischen Anforderungen
  • zuverlässiger Informationsaustausch zwischen Systemen.


Je nach Geschäftsanforderungen und verfügbaren Partnerlösungen können im Laufe der Zeit mehrere externe Anwendungen integriert werden.


Zusammenfassung


Zusamenfassend:



👉 Tools ermöglichen es Teemant, mit externen Anwendungen zu interagieren, um spezialisierte Aktionen durchzuführen, die über dialogbasierte KI hinausgehen, und gleichzeitig vollständig in den Gesamtprozessablauf integriert zu bleiben.

Zurück nach oben

👁️ Vision

Vision – Dokumenten- und Bildintelligenz


Das Vision-Modul verwaltet die Extraktion von Dokumenten- und Bildinformationen innerhalb von Teemant.

A Vision ist ein unabhängiger KI-Agent, der auf das Lesen, Analysieren und Interpretieren von Dokumenten oder Bildern spezialisiert ist, um strukturierte, nutzbare Daten zu erzeugen.

Vision geht über die einfache OCR hinaus: Es kombiniert visuelle Extraktion mit KI-gestütztem Verständnis und Validierung.


Vision als spezialisierter KI-Agent


Jede Vision ist als dedizierter KI-Agent mit folgenden Eigenschaften konfiguriert:


  • Zweck,
  • Dokumentkontext,
  • Extraktionsmodell
  • KI-Verarbeitungslogik.


Der Vision-Agent ist verantwortlich für:


  • Lesen von Dokumenten oder Bildern (PDFs, Scans, Fotos),
  • Extraktion von Rohinformationen mittels OCR oder Bildanalyse,
  • Die extrahierten Daten werden mithilfe der Teemant-KI-Logik interpretiert, normalisiert und strukturiert.


Diese zusätzliche KI-Verarbeitungsschicht ermöglicht es Vision, komplexe Layouts, handgeschriebene Inhalte und mehrdeutige Informationen zu verarbeiten.


Dokumentkontext


Jede Vision ist mit einem Dokumentkontext verknüpft.


Der Dokumentkontext definiert:


  • Die Art des bearbeiteten Dokuments (z. B. Unfallbericht, Bescheinigung, Rechnung, handschriftliches Formular),
  • Die semantische Bedeutung des Dokuments,
  • Die erwartete Struktur und Geschäftslogik.


Dieser Kontext gibt dem Vision-Agenten die nötigen Informationen:


  • Welche Informationen man suchen sollte,
  • Wie man die extrahierten Werte interpretiert,
  • Wie man domänenspezifische Regeln während der Verarbeitung anwendet.


Extraktions-, Verarbeitungs- und Validierungsablauf


Der Vision-Workflow folgt immer demselben Prinzip:


  1. Aus dem Dokument oder Bild werden mithilfe einer OCR- oder Bilderkennungssoftware Rohdaten und visuelle Informationen extrahiert.
  2. Der Teemant-KI-Prozess verarbeitet den extrahierten Inhalt Feld für Feld:
  • Ordnet Daten strukturierten Feldern zu,
  • Wendet Formatierung und Normalisierung an,
  • Interpretiert mehrdeutige oder unvollständige Werte.
  1. Bestätigen (optional) Während eines Gesprächs kann der Vision-Agent mit dem Benutzer interagieren, um:
  • Extrahierte Werte bestätigen,
  • Fehlende Informationen anfordern,
  • Daten korrigieren oder verfeinern.


Dieser Validierungsschritt ist besonders nützlich bei handgeschriebenen Dokumenten oder Scans mit geringer Qualität.


Anbieter von Sehhilfen


Teemant unterstützt je nach Anwendungsfall mehrere Vision-Backends:


  • Microsoft Document Intelligence wird typischerweise für komplexe, strukturierte oder handschriftliche Dokumente mit individuell trainierten Modellen verwendet.


  • Mistral OCR Direkte OCR über API, einfacher zu integrieren, aber im Allgemeinen weniger zuverlässig bei komplexen Dokumenten.


Zukünftig können weitere Vision-Plattformen integriert werden.


Unabhängig vom Anbieter bleibt die Vision-Logik dieselbe: extrahieren → mit KI verarbeiten → optional mit dem Benutzer validieren.


Vision in durchgängigen Prozessen


Vision-Agenten sind so konzipiert, dass sie in umfassendere Teemant-Workflows integriert werden können, darunter:


  • Leitfäden zur Datenerhebung
  • Vorfall- oder Schadensmeldungen,
  • E-Mail-Automatisierung
  • Strukturierte Exporte in Informationssysteme.


Durch die Umwandlung unstrukturierter Dokumente in validierte, strukturierte Daten spielt Vision eine Schlüsselrolle bei der Automatisierung dokumentenintensiver Prozesse innerhalb von Teemant.

Zurück nach oben

📤 Ausgänge

Das Modul „Ausgaben“ verwaltet alle ausgehenden Datenflüsse von Teemant. Es definiert, wie Daten, Dokumente und Benachrichtigungen, die von KI-Agenten erzeugt werden, an externe Systeme, Anwendungen und Benutzer übermittelt werden.


Die Ergebnisse können Folgendes umfassen:


  • E-Mail-Benachrichtigungen mit strukturiertem oder unstrukturiertem Inhalt
  • Dateiexporte (JSON, Mediendateien, ZIP-Archive, generierte Dokumente)
  • SFTP-Übertragungen
  • APIs, Webhooks und andere ausgehende Konnektoren werden verwendet, um Teemant in Unternehmensinformationssysteme zu integrieren.


Jede Ausgabekonfiguration ermöglicht Ihnen Folgendes zu definieren:


  • Der Transportmechanismus (E-Mail-Server, SFTP, API-Endpunkt, Webhook usw.).
  • Die zu sendenden Dokumente und Datenformate
  • Inhalt und Struktur von Benachrichtigungen oder exportierten Nutzdaten
  • Ob der standardmäßige Teemant-Mailserver oder ein dedizierter Transport verwendet wird


Die Ausgabe erfolgt typischerweise am Ende eines Prozesses, sobald Datenerfassung, KI-Verarbeitung, Validierungen und die Generierung von Kennungen abgeschlossen sind. Sie gewährleistet, dass die Ergebnisse zuverlässig, nachvollziehbar und integrationsbereit bereitgestellt werden.



Dieses Modul stellt die letzte Bereitstellungsschicht von Teemant dar und ermöglicht eine nahtlose Kommunikation zwischen KI-gesteuerten Arbeitsabläufen und externen Systemen.

Zurück nach oben

📄 Dokumente

Der Bereich „Dokumente“ bündelt alle Inhalte, die von Teemant im Laufe eines Prozesses erstellt, gesendet oder verarbeitet werden. Er umfasst E-Mails, technische Dokumente (wie z. B. JSON) und Mediendateien (Fotos, Anhänge, generierte Dokumente).


Dokumente werden typischerweise von Ausgaben (E-Mail-Benachrichtigungen, SFTP-Exporte, APIs, Webhooks, ausgehende Konnektoren) verwendet und können dynamische Variablen aus Konversationen, KI-Verarbeitung und Geschäftslogik enthalten.


✉️ E-Mails


E-Mails sind die am häufigsten vorkommende Dokumentart in Teemant.

Sie sind daran gewöhnt:


  • Endbenutzer benachrichtigen,
  • eine Erklärung oder Handlung bestätigen,
  • mit internen Teams kommunizieren,
  • oder Informationen an Partner weiterleiten.


Jedes E-Mail-Dokument definiert:


  • Empfänger (An / Cc / Bcc),
  • ein dynamisches Subjekt (z. B. unter Verwendung von {app.identifier} ),
  • ein anpassbarer Inhaltskörper,
  • und eine Template-Engine.


Verfügbare Template-Engines


  • Freemarker – Eine standardmäßige und leistungsstarke Template-Engine, die sich hervorragend für komplexe E-Mails mit Bedingungen, Schleifen und erweiterter HTML-Formatierung eignet.
  • Teemant Template Engine Eine einfachere, intern entwickelte Engine, mit der sich schnell klare und wartungsfreundliche E-Mails mit unkomplizierter Variableneinfügung erstellen lassen.


Variablen (z. B. {app.accidentDate} , {user.email} …) werden beim Senden automatisch aufgelöst, basierend auf Daten, die von Teemant erfasst und verarbeitet werden.


🧾 JSON & technische Inhalte


Dokumente beschränken sich nicht auf E-Mails.

Teemant verwaltet auch JSON-Dokumente, die für Folgendes verwendet werden:


  • Dateneinspeisung in Informationssysteme,
  • strukturierte Exporte,
  • Integrationen über APIs, Webhooks und ausgehende Konnektoren.


Diese strukturierten Dokumente gewährleisten einen zuverlässigen, konsistenten und standardisierten Datenaustausch mit externen Systemen.


📎 Medien & Dateien


Die Kategorie „Medien“ fasst alle Dateien zusammen, die während eines Prozesses verarbeitet werden:


  • Fotos,
  • vom Benutzer hochgeladene Dokumente,
  • automatisch generierte Dateien,
  • Ergebnisse von Vision (OCR, Bildanalyse),
  • Anhänge, die per E-Mail gesendet oder exportiert wurden.


Mediendateien können sein:


  • gelagert,
  • analysiert,
  • Exportiert über Ausgaben (E-Mail, SFTP, API, Webhooks usw.),
  • oder mit einer Konversation, einer Kennung oder einem Geschäftsprozess verknüpft ist.


🎯 Zusammenfassung


Der Bereich „Dokumente“ bildet die Grundlage für alle ausgehenden und technischen Inhalte in Teemant.

Es ermöglicht Ihnen Folgendes:


  • E-Mails und Dokumente zentralisieren,
  • Formate standardisieren,
  • dynamisch KI-generierte und dialogbasierte Daten einbinden,
  • und die nahtlose Integration mit externen Systemen gewährleisten.


Zurück nach oben

🧱 Objektmodelle

Objektmodelle definieren die strukturierte Datenschicht von Teemant. Sie werden verwendet, um Referenzdaten, operative Daten und arbeitsbereichsspezifische Konfigurationsobjekte zu modellieren, die von Agenten, Prozessen und Integrationen gemeinsam genutzt werden.


Sie erfüllen zwei Hauptzwecke.


1️⃣ Referenz- und Geschäftsdatenmodelle (Datensynchronisation)


Objektmodelle werden verwendet, um strukturierte Datenbanken zu erstellen, die Referenz- oder Geschäftsdaten darstellen, die von Teemant-Prozessen benötigt werden, zum Beispiel:


  • Filialen, Agenturen, Tochtergesellschaften
  • Fahrzeuge, Produkte, Verträge, Richtlinien
  • Jeglicher externer Referenzdatensatz, der während Konversationen, Dokumentenverarbeitung oder Weiterleitung verwendet wird.


Diese Modelle können dann sein:


  • Synchronisiert mit externen Informationssystemen
  • Auf dem Laufenden gehalten durch:
  • Transportmethoden → Art und Weise des Datenaustauschs (SFTP, APIs, Konnektoren usw.).
  • Aufgaben → Wann und wie oft die Synchronisierung ausgeführt wird (bei Bedarf, geplant, inkrementell usw.)


Dadurch kann Teemant mit Echtzeit-Unternehmensdaten arbeiten, die als vertrauenswürdig gelten, und es wird sichergestellt, dass die KI-Agenten stets auf konsistente und aktuelle Informationen zurückgreifen können.


2️⃣ Arbeitsbereichskonfigurationsobjekte (Dynamische Arbeitsbereichseigenschaften)


Objektmodelle können auch benutzerdefinierte Eigenschaften auf Arbeitsbereichsebene definieren.


Hierbei handelt es sich nicht um Referenzdatensätze, sondern um Konfigurationsobjekte, die einem Arbeitsbereich zugeordnet sind, wie zum Beispiel:


  • Spezielle E-Mail-Empfänger (z. B. RC-E-Mail, Eskalations-E-Mail, Partner-E-Mail)
  • Kennungen, Codes oder Geschäftsparameter, die für einen Arbeitsbereich spezifisch sind
  • Alle benutzerdefinierten Eigenschaften, die in den Arbeitsbereichseinstellungen angezeigt werden sollen


Sobald definiert:


  • Diese Felder stehen automatisch in der Workspace-Konfiguration zur Verfügung.
  • Sie können vielseitig wiederverwendet werden:
  • Dokumente und Benachrichtigungen
  • Ausgaben
  • KI-Guides
  • Automatisierungs- und Routinglogik


Dadurch werden Objektmodelle zu einer leistungsstarken Möglichkeit, Teemant ohne benutzerdefinierten Code zu erweitern, indem einfach neue strukturierte Eigenschaften modelliert werden.


Unterstützte Feldtypen


Objektmodelle unterstützen einen kontrollierten Satz von Feldtypen, um Konsistenz und Interoperabilität zu gewährleisten, einschließlich:


  • Zeichenkette
  • ganze Zahl
  • Nummer
  • E-Mail
  • Datum
  • Standort
  • Inhalt


Diese Typen sind so konzipiert, dass sie vollständig mit KI-Verarbeitung, Dokumentenvorlagen, Exporten und Integrationen kompatibel sind.


Warum Objektmodelle wichtig sind


Objektmodelle bilden die Grundlage der Datenarchitektur von Teemant:


  • Sie strukturieren, wie Daten gespeichert, geteilt und synchronisiert werden.
  • Sie verbinden KI-Agenten mit Unternehmenssystemen
  • Sie ermöglichen eine übersichtliche und skalierbare Anpassung von Arbeitsbereichen.



Kurz gesagt, Objektmodelle verwandeln Teemant in eine datenbewusste KI-Plattform, nicht nur in eine dialogorientierte.

Zurück nach oben

🧱 Arbeitsbereichseinstellungen

Ein Workspace repräsentiert einen logischen Mandanten in Teemant. Er definiert die funktionalen, technischen und organisatorischen Grenzen, innerhalb derer Agenten, Daten, Integrationen und Benutzer agieren. In der Praxis ist ein Workspace üblicherweise einer Umgebung (Entwicklung, Test, Produktion) oder einer bestimmten Geschäftseinheit bzw. einem Kunden zugeordnet.


Umwelt & Regierungsführung (Hauptbereich)


Die Registerkarte „Haupt“ zentralisiert die Kernkonfiguration des Arbeitsbereichs:


  • Name, Ort und Zeitzone

Diese Einstellungen definieren, wie Inhalte lokalisiert werden (Sprache, Datumsformate) und wie zeitbasierte Logik (Ereignisse, Aufgaben, Benachrichtigungen) ausgewertet wird.


  • Bewährte Vorgehensweise: Mehrere Arbeitsbereiche

Es wird dringend empfohlen, separate Arbeitsbereiche einzurichten für:

  • Entwicklung (Experimente und Konfiguration),
  • Testen / Benutzerakzeptanztest (Validierung und Geschäftsfreigabe),
  • Produktion (Live-Betrieb, Endnutzer). Dies gewährleistet Isolation, Sicherheit und kontrollierte Bereitstellungen.


  • Öffentlicher Arbeitsbereich

Wenn ein Arbeitsbereich als öffentlich gekennzeichnet ist, ist er je nach Kanal für Endbenutzer zugänglich:

  • WhatsApp: Jeder Nutzer mit einem Meta-WhatsApp-Konto,
  • Microsoft Teams / Google Chat: Benutzer, die zur Installation der Teemant-App berechtigt sind. Dies ist besonders nützlich für Szenarien mit vielen oder vielen Benutzern.


  • Standard-Kontakt-E-Mails Die hier definierten Kontakt-E-Mail-Adressen dienen als globale Ausweichempfänger für Benachrichtigungen und Ausgaben (E-Mails, Warnungen, Exporte), wenn kein spezifischeres Ziel konfiguriert ist.


Anbieter & KI-Dienste


Über die Registerkarte „Anbieter“ wird der Arbeitsbereich mit seinem technologischen Ökosystem verbunden:


  • Hier werden die API-Schlüssel für LLMs, OCR-Engines, Vision-/Dokumenten-KI und andere KI-Dienste konfiguriert.
  • Kunden können entweder:
  • ihre eigenen API-Schlüssel mitbringen, oder
  • Sie verwenden je nach Konfiguration und Vereinbarung die von Teemant bereitgestellten Schlüssel.
  • Diese Konfiguration gilt für den gesamten Arbeitsbereich und wird von Agenten, Vision, Dokumentenverarbeitung und Automatisierungsfunktionen wiederverwendet.


Arbeitsbereichsspezifische Geschäftseinstellungen (Objektmodelle)


Der dritte Reiter (zum Beispiel „Auchan Gestionnaires“ in den Screenshots) veranschaulicht, wie Objektmodelle auf Workspace-Ebene verwendet werden:


  • Diese Objekte definieren benutzerdefinierte Eigenschaften des Arbeitsbereichs selbst, wie zum Beispiel:
  • spezielle Empfänger-E-Mail-Adressen (z. B. RC-E-Mail, DAB-E-Mail),
  • unternehmensspezifische Konfigurationsfelder,
  • Alle domänenspezifischen Metadaten, die von Arbeitsabläufen oder Ausgaben benötigt werden.


  • Sobald diese Felder definiert sind, erscheinen sie direkt in den Arbeitsbereichseinstellungen und können wie folgt referenziert werden:
  • Agenten
  • Dokumente und Vorlagen,
  • Ausgaben (E-Mails, APIs, Exporte),
  • Integrationen.



Kurz gesagt, der Workspace ist nicht nur ein Container: Er ist die zentrale Konfigurationsebene, die Umgebungen, Benutzer, KI-Anbieter, Geschäftsregeln und Integrationen miteinander verbindet und so Konsistenz und Kontrolle über die gesamte Teemant-Plattform hinweg gewährleistet.

Zurück nach oben

👥 Workspace-Mitglieder

Workspace-Mitglieder sind die Administratoren eines Workspace (Mandanten). Sie sind verantwortlich für die Konfiguration, Verwaltung und Steuerung der Nutzung von Teemant innerhalb einer bestimmten Umgebung.


Bei den Mitgliedern handelt es sich um interne Benutzer (Ihre Teams, Partner oder Integratoren), nicht um Endbenutzer, die mit Chatbots oder E-Mails interagieren.


Rollen und Berechtigungen


Jedes Workspace-Mitglied kann eine oder mehrere der folgenden Rollen innehaben:


  • Administrator
  • Vollständiger Zugriff auf die Arbeitsbereichskonfiguration
  • Kann Einstellungen, Anbieter, Benutzer, Kanäle, Ausgaben, Dokumente usw. verwalten.
  • KI-Agenten können nicht erstellt werden
  • Manager
  • Kann Benutzer, Kanäle, Konfigurationen und Betriebseinstellungen verwalten
  • KI-Agenten können nicht erstellt werden
  • Bot-Builder
  • Kann nur KI-Agenten (KI-Leitfäden, Kontexte, Abläufe) erstellen und konfigurieren.
  • Kein Zugriff auf die Administration auf Arbeitsbereichsebene


Diese Trennung der Rollen gewährleistet klare Governance, Sicherheit und kontrollierte Einsätze.


Bewährte Verfahren


  • Entwicklungsarbeitsbereich
  • Alle Rollen vergeben (Administrator, Manager, Bot-Entwickler)
  • Dies ist der einzige Ort, an dem KI-Agenten entworfen und konfiguriert werden.
  • Test- und Produktionsarbeitsbereiche
  • Nur Rollen als Grant Administrator und/oder Manager
  • Der Bau von Agentenbüros ist nicht gestattet.
  • Agenten werden hier eingesetzt, nicht erstellt.
  • Ein Arbeitsbereich pro Client-Anwendung
  • Es wird dringend empfohlen, die Konfigurationen isoliert zu halten.
  • Verbessert Sicherheit, Wartbarkeit und Transparenz bei der Bereitstellung


Warum das wichtig ist


Dieser Ansatz:


  • Verhindert unbeabsichtigte Produktionsänderungen
  • Erzwingt einen sauberen Build-, Test- und Bereitstellungszyklus.
  • Vereinfacht Audits, Support und Fehlerbehebung erheblich
  • Entspricht den IT- und DevOps-Praktiken auf Unternehmensebene.



Die Mitglieder des Arbeitsbereichs legen fest, wer was tun darf, während die KI-Agenten definieren, was das System tut.

Zurück nach oben

👥 Workspace-Agent-Benutzer (Endbenutzer)

Agentenbenutzer sind die Endbenutzer, die innerhalb eines Arbeitsbereichs auf Teemant-Agenten (Chatbots, E-Mail-Automatisierung usw.) zugreifen und mit ihnen interagieren können.

Sie sind keine Administratoren und konfigurieren die Plattform nicht. Ihre Aufgabe besteht ausschließlich darin, die Agenten über die aktivierten Interaktionskanäle zu nutzen.


🔐 Zugriffsregeln


Der Zugriff auf Agenten hängt von der Sichtbarkeit des Arbeitsbereichs ab:


  • Privater Arbeitsbereich (Standard) Nur Benutzer, die explizit als Agenten definiert sind, können die Agenten sehen und mit ihnen interagieren.


  • Öffentlicher Arbeitsbereich Alle Benutzer, die auf den Kanal zugreifen können, können mit den Agenten interagieren:
  • WhatsApp: Jeder Benutzer, der bei Meta WhatsApp authentifiziert ist
  • Microsoft Teams: Benutzer, die zur Installation/Nutzung der Teemant-App berechtigt sind
  • Google Chat: Benutzer, die im Google Workspace autorisiert sind


Jeder Agentenbenutzer kann sein:


  • Aktiviert oder deaktiviert
  • Einem oder mehreren Kanälen zugeordnet
  • Mit Gebietsschema und Kontaktdaten konfiguriert


📱 Kanalspezifische Best Practices


Die Zugriffskontrolle sollte der Logik jedes Kanals folgen:


  • Die Zugriffsverwaltung für Microsoft Teams / Google Chat / E-Mail erfolgt in der Regel vorgelagert durch die IT-Abteilung des Kunden oder den Identitätsanbieter (Azure AD, Google Workspace, E-Mail-Systeme usw.).


  • Da WhatsApp im Allgemeinen öffentlich zugänglich ist, muss die Authentifizierung innerhalb des Prozesses erfolgen, zum Beispiel:
  • Mitarbeiter- oder Agenten-ID
  • Fahrzeugkennzeichen
  • Versicherungs- oder Vertragsnummer
  • Dokumentenbasierte Verifizierung (Ausweis, Formular, Foto usw.)


Diese Authentifizierungslogik wird typischerweise innerhalb des KI-Leitfadens und des Gesprächsablaufs implementiert, nicht auf Kanalebene.


✅ Empfohlene Vorgehensweisen


  • Agentenbenutzer müssen strikt von Workspace-Mitgliedern (Administratoren, Managern, Entwicklern) getrennt werden.
  • Verwenden Sie private Arbeitsbereiche für kontrollierte Bereitstellungen.
  • Delegieren Sie Identitäts- und Zugriffskontrolle nach Möglichkeit an die Kundensysteme.
  • Entwerfen Sie explizite Authentifizierungsschritte in Gesprächsabläufen, insbesondere für öffentliche Kanäle wie WhatsApp.



Kurz gesagt: Agentenbenutzer definieren, wer mit der KI kommunizieren kann, während Workspace-Mitglieder definieren, wer sie konfigurieren kann.

Zurück nach oben

🔌 Arbeitsbereichskanäle

Kanäle definieren, wie Benutzer mit Teemant-Agenten interagieren und wo Nachrichten, E-Mails oder Konversationen empfangen und gesendet werden.

Jeder Kanal stellt eine konkrete Integration mit einer externen Kommunikationsplattform wie WhatsApp, Microsoft Teams, Google Chat, E-Mail-Systemen oder Live-Chat-Tools dar.


In einem Arbeitsbereich können mehrere Kanäle gleichzeitig aktiviert sein, sodass dieselben KI-Agenten über verschiedene Kontaktpunkte hinweg konsistent arbeiten können.


💬 Chat-Kanäle (Unterhaltungsmodus)


📱 WhatsApp


WhatsApp-Kanäle verbinden Teemant über eine dedizierte Telefonnummer mit Meta WhatsApp Business-Konten.


So funktioniert es:


  • Jeder bei WhatsApp authentifizierte Benutzer kann den Bot über die konfigurierte Nummer kontaktieren.
  • Die Sichtbarkeit des Arbeitsbereichs (öffentlich oder privat) bestimmt, ob zusätzliche Zugriffskontrollen erforderlich sind.
  • In den meisten realen Anwendungsfällen erfolgt die Authentifizierung innerhalb des KI-Ablaufs und nicht durch WhatsApp selbst (z. B. Mitarbeiter-ID, Ausweisnummer, Kfz-Kennzeichen, Dokumenten-ID usw.).
  • WhatsApp wird typischerweise für externe Nutzer oder ein großes Publikum verwendet.


Bewährte Vorgehensweise:

Verwenden Sie die dialogbasierte Authentifizierung innerhalb der Agentenlogik, wenn sensible Daten betroffen sind.


💼 Microsoft Teams


Microsoft Teams-Kanäle ermöglichen es Teemant-Agenten, innerhalb eines Microsoft-Tenants zu agieren.


So funktioniert es:


  • Der Zugriff ist auf Benutzer beschränkt, die im konfigurierten Teams-Mandanten authentifiziert sind.
  • Die Teams-Tenant-ID definiert den Umfang der autorisierten Benutzer.
  • Ideal für interne Anwendungsfälle (IT-Support, Personalwesen, Betrieb, interne Assistenten).


Bewährte Vorgehensweise:

Überlassen Sie Teams die Verwaltung von Identität und Zugriff; vermeiden Sie die Duplikation der Authentifizierungslogik im Bot, es sei denn, dies ist erforderlich.


💬 Google Chat


Google Chat-Kanäle verbinden Teemant mit einer Google Workspace-Domäne.


So funktioniert es:


  • Nur Benutzer, die innerhalb der konfigurierten Google-Domäne authentifiziert sind, können auf den Bot zugreifen.
  • Die Zugriffskontrolle erfolgt naturgemäß über die Berechtigungen von Google Workspace.
  • Gut geeignet für interne Unternehmensassistenten.


🧑‍💻 Live-Chat (Chatwoot)


LiveChat-Kanäle verbinden Teemant mit Chat-Plattformen von Drittanbietern, wie zum Beispiel Chatwoot.


So funktioniert es:


  • Teemant fungiert als KI-Schicht hinter dem Live-Chat-System.
  • Die KI kann Erstreaktionen, Datenerfassung und Triage automatisieren.
  • Menschliche Agenten können bei Bedarf Gespräche übernehmen.


Bewährte Vorgehensweise:

Nutzen Sie LiveChat-Integrationen für hybride KI- und menschliche Support-Workflows.


📧 E-Mail-Kanäle


📩 Google Mail


Google Mail-Kanäle ermöglichen es Teemant, E-Mails aus einem Zielpostfach zu lesen, zu klassifizieren und zu beantworten.


Schlüsselkonzepte:


  • OAuth-Zugangsdaten (Client-ID, Geheimnis, Aktualisierungstoken) sind erforderlich.
  • E-Mails werden von KI-Agenten zur Klassifizierung, Datenextraktion und zum Verfassen von Antworten verarbeitet.
  • Das Einwilligungsmanagement gewährleistet die Einhaltung der Benutzerautorisierung.


📬 Microsoft Mail


Microsoft Mail-Kanäle sind in Microsoft 365-Postfächer integriert.


So funktioniert es:

  • E-Mails werden erfasst, analysiert und an den entsprechenden KI-Agenten weitergeleitet.
  • Agenten können strukturierte Daten extrahieren, das Informationssystem aktualisieren und Antworten generieren.
  • Vor der Aktivierung der KI-Verarbeitung ist die ausdrückliche Zustimmung des Nutzers erforderlich.


Typische Anwendungsfälle:

  • E-Mail-Automatisierung
  • Vorfallmeldungen
  • Kunden- oder Partneranfragen
  • Automatisierung von Backoffice-Prozessen


⚙️ Prinzipien der Kanalkonfiguration


  • Jeder Kanal verfügt über:
  • Ein Status (aktiviert / deaktiviert)
  • Eine Beschreibung zur Dokumentation und Klarheit
  • Ein Entwurfsmodus zur sicheren Konfiguration vor der Live-Schaltung


  • Kanäle können unabhängig voneinander hinzugefügt und schrittweise aktiviert werden.
  • Dieselbe Agentenlogik kann über mehrere Kanäle hinweg wiederverwendet werden.


✅ Bewährte Verfahren



  • Separate Umgebungen (Entwicklung / Test / Produktion) sollten ihre eigenen Kanäle haben.
  • Bevorzugen Sie die native Plattformauthentifizierung (Teams, Google Chat, Mail).
  • Bei offenen Kanälen wie WhatsApp sollte die Authentifizierung innerhalb der KI-Konversation implementiert werden.
  • Die Kanalkonfiguration sollte so gering wie möglich gehalten werden; die Komplexität sollte in den KI-Leitfäden und der Agentenlogik liegen, nicht im Kanal selbst.


Zurück nach oben

🔁 Arbeitsplatztransporte

Transporte definieren, wie Daten und Dokumente von Teemant in externe Systeme exportiert werden.

Sie bilden die technische Brücke zwischen Teemant und Ihren Informationssystemen, Data Lakes, ERP-Systemen, CRM-Systemen oder operativen Tools.

Ein Transport wird typischerweise von Aufgaben verwendet, um festzulegen, wann, wie und wohin Daten gesendet werden.


📦 Wozu werden Transportmittel verwendet?


Transportmittel ermöglichen Ihnen Folgendes:


  • Export strukturierter Daten (JSON, Metadaten, Objektmodelle)
  • Dokumente exportieren (PDFs, Bilder, ZIP-Archive)
  • Synchronisierung von Referenzdatenbanken mit externen Systemen
  • Datenübertragung automatisch oder zeitgesteuert


Sie werden am häufigsten verwendet für:


  • Systemintegrationen
  • Datensynchronisierung
  • Berichterstattung und Archivierung
  • Betriebsautomatisierung


📁 Dateiübertragung (SFTP / FTP) 📤


Dateiübertragungsprotokolle werden verwendet, um Dateien an externe Server, typischerweise Unternehmens-Backends, zu senden.


Hauptmerkmale:


  • Unterstützt SFTP / FTP
  • Daten können exportiert werden als:
  • JSON
  • Unterlagen
  • ZIP-Archive (empfohlen für Stapelverarbeitung)
  • Sichere Authentifizierung über Benutzername und Passwort
  • Konfigurierbarer Zielpfad


Typische Anwendungsfälle:

  • Exportieren Sie tägliche oder stündliche Datensätze in ein ERP-System.
  • Referenzdatenbanken synchronisieren
  • Strukturierte Daten an Altsysteme senden
  • Batch-Verarbeitungspipelines


Beispiel:

Exportieren Sie alle verarbeiteten Dokumente und Metadaten jede Nacht als ZIP-Datei auf einen SFTP-Server.


✉️ E-Mail-Transport


E-Mail-Transporte ermöglichen es Teemant, Daten oder Dokumente per E-Mail zu versenden.


Hauptmerkmale:

  • SMTP-Konfiguration (Host, Port, Verschlüsselung)
  • Authentifizierung über E-Mail-Konto
  • Unterstützt Anbauteile
  • Kann für Benachrichtigungen oder Datenübermittlung verwendet werden.


Typische Anwendungsfälle:

  • Berichte oder Exporte an Geschäftsanwender senden
  • Benachrichtige die Teams, wenn Daten aktualisiert werden
  • Leichtgewichtige Integrationen ohne Backend-System


🌐 Webhooks 🔔


Webhooks ermöglichen Push-Benachrichtigungen in Echtzeit an externe Systeme.


Hauptmerkmale:


  • HTTP(S)-Endpunkte
  • Ereignisgesteuerte Auslieferung
  • Nutzdaten im JSON-Format gesendet
  • Sichere Authentifizierung (Header, Token)


Typische Anwendungsfälle:


  • Workflows auf externen Plattformen auslösen
  • Benachrichtige nachgelagerte Systeme sofort
  • Integration mit Automatisierungstools (Zapier, Make, benutzerdefinierte APIs)


Beispiel:

Wenn ein Dokument verarbeitet wird, benachrichtigen Sie umgehend ein externes System mit seinen Metadaten.


🔌 REST-APIs 🧩


REST-API-Transporte ermöglichen es externen Systemen, Daten programmatisch abzurufen oder zu empfangen.


Hauptmerkmale:


  • Standard-REST-Endpunkte
  • Sichere Authentifizierung (API-Schlüssel, OAuth, Tokens)
  • Unterstützt den Austausch strukturierter Daten
  • Konzipiert für skalierbare Integrationen


Typische Anwendungsfälle:


  • Echtzeit-System-zu-System-Integration
  • Externe Anwendungen, die Teemant-Daten abfragen
  • Erweiterte Orchestrierung und Automatisierung


🧠 Wie Transporte mit Objektmodellen und Aufgaben funktionieren


Transportmittel werden nicht allein eingesetzt:


  • Objektmodelle definieren, welche Daten existieren
  • Transportprotokolle definieren, wie und wohin Daten gesendet werden.
  • Aufgaben definieren, wann und wie oft Daten synchronisiert werden.

Zusammen bilden sie eine vollständige Datensynchronisationspipeline.


✅ Bewährte Verfahren


✔ SFTP ZIP für große oder Batch-Datenexporte verwenden ✔ Webhooks für Echtzeitintegrationen nutzen ✔ REST-APIs für fortgeschrittene oder interaktive Systeme nutzen ✔ Separate Transporte pro Umgebung (Entwicklung/Test/Produktion) ✔ Transporte vor der Veröffentlichung in der Produktion immer testen


🧭 Zusammenfassung


Transporte sind das Rückgrat der Teemant-Integrationen.


Sie gewährleisten, dass die in Teemant erzeugten Daten zuverlässig, sicher und automatisch in Ihr Unternehmensökosystem fließen.


Sie sind so konzipiert, dass sie:


  • Flexibel
  • Skalierbar
  • für Unternehmen geeignet


Zurück nach oben

⏱️ Aufgaben im Arbeitsbereich

Workspace-Aufgaben dienen der Konfiguration automatisierter oder bedarfsgesteuerter Vorgänge auf Workspace-Ebene. Typischerweise werden sie zum Importieren oder Exportieren von Daten, zum Synchronisieren von Referenzdaten oder zum Ausführen wiederkehrender technischer Prozesse im Zusammenhang mit dem Informationssystem verwendet.


🔁 Was ist eine Aufgabe?


Eine Aufgabe stellt eine wiederholbare Aktion dar, die von Teemant ausgeführt wird und in der Regel auf Folgendem basiert:


  • ein Datenbereich (Entität, Objektmodell, Dokumente usw.)
  • ein Transport (SFTP, E-Mail, API, Webhook, …)
  • ein Zeitplan oder Auslöser


Beispiel siehe Screenshot:

  • Import Store
  • Entität: Speicher
  • Transport: SFTP-Import
  • Zeitplaner: AKTIVIERT


Das bedeutet, dass Teemant regelmäßig Shop- (Filial-)Daten aus einem externen System mittels SFTP importiert.


🧩 Typische Anwendungsfälle


Aufgaben werden üblicherweise verwendet für:


  • 📥 Datenimporte
  • Referenzdaten (Shops, Produkte, Nutzer, Verträge usw.)
  • Konfigurations- oder Stammdaten aus externen Systemen
  • 📤 Datenexporte
  • Strukturierte Ausgaben (JSON, ZIP, Dokumente)
  • Zurücksenden von KI-erfassten oder verarbeiteten Daten an den SI
  • 🔄 Synchronisierungsaufträge
  • Halten Sie die Teemant-Objektmodelle an die externen Datenbanken angepasst.
  • Regelmäßige Aktualisierung der gemeinsam genutzten Daten
  • ⚙️ Sonstige planmäßige Betriebsabläufe
  • Stapelverarbeitung
  • Bereinigung, Konsolidierung oder zukünftige automatisierte Aufgaben


Das System ist so konzipiert, dass es erweiterbar ist, sodass im Laufe der Zeit zusätzliche Arten von wiederkehrenden oder ausgelösten Aufgaben hinzugefügt werden können.


🧠 Wie Aufgaben mit Transporten funktionieren


Aufgaben bewegen Daten nicht von selbst – sie sind auf Transportprozesse angewiesen:


  • Ein Transportprotokoll definiert, wie Daten ausgetauscht werden (SFTP, E-Mail, API, Webhook usw.).
  • Eine Aufgabe definiert, wann und was ausgetauscht wird.


Diese Trennung ermöglicht Folgendes:


  • Wiederverwendung desselben Transports für mehrere Aufgaben
  • Zeitpläne ändern, ohne die Verbindungseinstellungen zu berühren


▶️ Manuelle vs. geplante Ausführung


  • Aufgaben können sein:


  • Geplant (regelmäßige Ausführung, abhängig von der Konfiguration)
  • Manuell ausgelöst (mittels der Aktion „Ausführen“)


Dies ist besonders nützlich für:


  • Testen von Importen/Exporten
  • Einmalige Synchronisierungen
  • Fehlerbehebung in der Produktion


Bewährte Verfahren


  • 🔧 Aufgaben hauptsächlich in Entwicklungsarbeitsbereichen konfigurieren
  • 🧪 Verhalten in Test-Workspaces validieren
  • 🚀 Produktionsaufgaben begrenzt, stabil und überwacht halten
  • 📦 Verwenden Sie einen Arbeitsbereich pro Clientanwendung, um Aufgaben und Datenflüsse zu isolieren.


Zurück nach oben

🧠 Teemant Agents Builder – Übersicht

Der Teemant Agents Builder ist die zentrale Designumgebung der Plattform. Hier werden KI-Agenten erstellt, strukturiert, orchestriert und veröffentlicht.


Ein Teemant-Agent ist nicht nur ein Chatbot.

👉 Es handelt sich um einen KI-Prozess auf Geschäftsniveau, der in der Lage ist, Benutzer anzuleiten, Geschäftslogik anzuwenden, mit Systemen zu interagieren und strukturierte Ergebnisse zu erzeugen.


🧩 Agententypen: Prozesse vs. Navigatoren


⚙️ Prozesse (Geschäftsprozesse)


Prozesse sind vollständige, autonome Agenten, die für Folgendes entwickelt wurden:


  • Strukturierte Informationen sammeln
  • Anleitung für Benutzer Schritt für Schritt
  • Geschäftsregeln und Berechnungen anwenden
  • Ausgaben generieren (JSON, Dokumente, Exporte, E-Mails usw.)


Typische Anwendungsfälle


  • Vorfall- oder Schadensmeldung
  • Schadensmeldung
  • Haftungs- oder Verantwortungserklärung


Prozesse stellen durchgängige Geschäftsabläufe dar.


🧭 Navigatoren (Sonstige)


Navigatoren sind Orchestrierungsagenten.


Sie dienen nicht dem Abschluss eines Geschäftsprozesses, sondern werden dazu verwendet:


  • Die Situation des Nutzers qualifizieren
  • Benutzer authentifizieren oder identifizieren
  • Leiten Sie die Benutzer zum richtigen Teilprozess weiter.
  • Aufteilung der Abläufe basierend auf Bedingungen oder Auswahlmöglichkeiten


Typische Anwendungsfälle


  • Überprüfung der Versicherungspolice
  • Auswahl der Art des Vorfalls
  • Routing zwischen Szenarien „mit/ohne Drittanbieter“


💡 In einer vollständigen Anwendung fungieren Navigatoren als Bausteine, die mehrere Prozesse miteinander verbinden und organisieren.


🧱 Hauptregisterkarte — Agentenkonfiguration


Die Registerkarte „Haupt“ definiert die Identität und das Verhalten eines Agenten.


📛 Identifizierung


  • Name: technische Kennung (eindeutig, stabil)
  • Anzeigename: Für Menschen lesbarer Name, der in Kanälen und der Benutzeroberfläche angezeigt wird.


✅ Bewährte Vorgehensweise:


Halten Sie sich strikt an die Namenskonventionen, einschließlich Geltungsbereich, Version und Zweck.


🌍 KI-Kontexte


  • Der globale Kontext definiert das allgemeine Umfeld:
  • Unternehmen oder Organisation
  • Vokabular und Terminologie
  • globale Regeln
  • Gesamtton


  • Der Agentenkontext definiert die spezifische Mission des Agenten:
  • was der Agent erreichen muss
  • wer die Nutzer sind
  • Kommunikationston
  • zu erfassende Daten


👉 Diese Kontexte beeinflussen direkt das Verhalten der KI während Konversationen und der E-Mail-Verarbeitung.


🚀 Startmodus


  • FLOW_ONLY Der Agent wird nur innerhalb eines anderen Prozesses verwendet → für Endbenutzer nicht direkt sichtbar


  • DIREKT Der Agent kann direkt über einen Kanal aufgerufen werden → sichtbar als Einstiegspunkt für Benutzer


💡 Diese Einstellung bestimmt, ob der Agent folgender Typ ist:


  • eine interne Komponente
  • oder ein benutzerorientierter Einstiegspunkt


🧬 Ablauf-Registerkarte — Prozessorchestrierung


Die Registerkarte „Ablauf“ bietet eine visuelle Darstellung der Logik des Agenten.


Jeder Block repräsentiert:

  • ein anderer Agent
  • ein Navigator
  • ein Berechnungsschritt
  • eine Kennung
  • eine Nachricht endet
  • eine Export- oder E-Mail-Aktion


🔗 Ablauflogik


  • Abfolgende Schritte
  • Bedingte Zweige
  • Komplexe Entscheidungsbäume


👉 Hier werden Business Intelligence und Orchestrierung tatsächlich umgesetzt.


📡 Veröffentlichung und Verfügbarkeit

📤 Veröffentlichen / Veröffentlichung aufheben


  • Veröffentlichen: Aktiviert den Agenten
  • Veröffentlichung aufheben: Deaktiviert es sofort.


Nach der Veröffentlichung ist der Agent zugänglich:


  • über die konfigurierten Kanäle
  • gemäß seinem Startmodus
  • Einhaltung der Zugriffsregeln für Arbeitsbereiche


📦 Export / Import ( .tee-Dateien)


Agenten können sein:

  • als .tee-Dateien exportiert
  • in andere Arbeitsbereiche importiert


Dies ermöglicht Folgendes:

  • Vorlagen und Wiederverwendung
  • Versionskontrolle
  • projektübergreifende Standardisierung
  • schnellere Bereitstellungen


💡 .tee-Dateien sind ein zentraler Bestandteil des Teemant-Ökosystems.


🧠 Bewährte Verfahren

🏷️ Strenge Namenskonventionen


Immer miteinbeziehen:


  • Funktionsumfang
  • Version
  • Agentenrolle


Dies ist von entscheidender Bedeutung für:


  • Wartung
  • Skalierbarkeit
  • Lesbarkeit komplexer Abläufe


🧩 Modulare Architektur


  • Halten Sie die Agenten klein und spezialisiert.
  • Navigatoren wiederverwenden
  • Zentralisierung gemeinsamer Logik


👉 Je einfacher die einzelnen Agenten sind, desto robuster wird das Gesamtsystem.


🧩 Zusammenfassung


Mit dem Teemant Agents Builder können Sie:


  • Gestaltung komplexer KI-gestützter Geschäftsprozesse
  • Intelligente Nutzerreisen orchestrieren
  • KI mit Unternehmenssystemen verbinden
  • Bereitstellung über mehrere Kanäle
  • KI-Anwendungsfälle industrialisieren und replizieren



👉 Es handelt sich um eine KI-gestützte Plattform zur Gestaltung von Geschäftsprozessen, nicht nur um einen Chatbot-Builder.

Zurück nach oben

📞 Teemant-Agentenanrufe (Wiederverwendbare Prozesse)

🔍 Übersicht


Teemant Agent Calls sind aufrufbare Prozesse, die für die Wiederverwendung durch einen oder mehrere Agenten konzipiert sind. Sie stellen eigenständige Prozessblöcke dar, die aus verschiedenen Abläufen aufgerufen werden können, anstatt dupliziert zu werden.

Betrachten Sie sie als gemeinsam genutzte Geschäftslogik, die bei Bedarf aufgerufen werden kann.


🧩 Warum Agentenanrufe wichtig sind


Agentenanrufe sind besonders nützlich, wenn:


  • 🔁 Derselbe Prozess muss mehrmals ausgeführt werden
  • 🧠 Die Logik ist komplex und sollte an einem einzigen Ort zusammengefasst sein.
  • 🧱 Sie wünschen sich saubere, wartungsfreundliche Agentenarchitekturen
  • 🔄 Mehrere Agenten oder Abläufe basieren auf derselben Geschäftsregel


Typische Beispiele:


  • Authentifizierungs- oder Identifizierungsschritte
  • Überprüfung der Versicherungspolice
  • Schadensqualifizierungslogik
  • Berechtigungsprüfungen
  • Umstände (einvernehmlich vs. verantwortungsvoll usw.)


🏗️ So funktionieren Agentenanrufe


Ein Agentenanruf ist:


  • Ein Prozess, kein vollständiger Dialogagent
  • Nicht direkt den Nutzern zugänglich.
  • Ausgelöst durch einen anderen Agenten oder Datenfluss
  • Ausgeführt im aktuellen Kontext


📌 Es verhält sich wie ein Funktionsaufruf innerhalb eines größeren Dialogablaufs.


🧠 Ausführungsmodell


  1. Ein Hauptagent erreicht einen Punkt, an dem eine gemeinsame Logik erforderlich ist.
  2. Es handelt sich um einen Agentenanruf.
  3. Der Agentenanruf:
  4. Nutzt den aktuellen Kontext
  5. Führt seinen internen Prozess aus
  6. Die Kontrolle wird an den anrufenden Agenten zurückgegeben.


➡️ Keine Benutzerbeeinträchtigung, keine doppelte Logik.


🧭 Typische Anwendungsfälle


Anwendungsfall: Warum einen Agentenanruf nutzen? 🔐 Authentifizierung: Dieselbe Verifizierung wird in vielen Abläufen verwendet. 🧾 Richtlinienabfrage: Wird für mehrere Anspruchstypen gemeinsam genutzt. 🚗 Kontextualisierung: Eigene vs. Drittanbieterlogik. 📄 Dokumentenvalidierung: Wiederverwendbare Validierungsregeln. 🔁 Mehrstufige Prüfungen: Zentralisierte Entscheidungslogik.


🧱 Architektur-Best-Practice


✅ Ein Anruf eines Agenten = Eine Verantwortung


  • Agentenanrufe fokussiert halten
  • Vermeiden Sie die Vermischung von UI-Navigation und Kernlogik.
  • Benennen Sie sie ganz eindeutig.

📌 Beispiel für eine Namenskonvention:


  • FLOT6x-AMIABLE-CALL
  • FLOT6x-CIRCUMSTANCE-CALL
  • FLOT1.0-POLICY-IDENTIFIER


Eine eindeutige Benennung ist bei großen Durchflussmengen unerlässlich.


🔄 Beziehung zu Teemant-Agenten


Komponentenrolle 🤖 Teemant-Agent Benutzerorientierter oder orchestrierender Agent 🧭 Navigator Führt Benutzer zu Unterprozessen 📞 Agentenaufruf Wiederverwendbarer aufrufbarer Prozess


➡️ Navigatoren entscheiden, wohin sie fahren ➡️ Agentenanrufe führen gemeinsame Logik aus


🚀 Bereitstellung & Verfügbarkeit


  • Agentenanrufe sind:
  • 📦 Veröffentlicht wie reguläre Agenten
  • 🔌 Verfügbar für alle Agenten im Arbeitsbereich
  • Nach der Veröffentlichung können sie sofort wiederverwendet werden.
  • Aktualisierungen werden automatisch überall dort angewendet, wo sie verwendet werden.



🧠 Wichtigste Erkenntnisse


  • 📞 Agentenanrufe = Wiederverwendbare Prozessblöcke
  • 🔁 Doppelarbeit vermeiden, Konsistenz verbessern
  • 🧩 Unverzichtbar für komplexe, groß angelegte Agentensysteme
  • 🏗️ Ein Eckpfeiler der klaren Teemant-Architektur


Zurück nach oben