KI
Generelle Informationen
Was ist die KI?
DocBee bietet Ihnen die Möglichkeit, sogenannte KI-Agents zu verwenden, um Ihre Arbeit zu unterstützen. Diese KI-Agents sind in der Lage, verschiedene Aufgaben automatisch zu übernehmen, wie z.B. das Verfassen von E-Mails, das Zusammenfassen von E-Mails oder das Befüllen von Protokollen.
Wann sollten Sie KI verwenden?
Falls Sie noch mehr in DocBee Automatisieren möchten.
KI
Um die KI zu aktiveren müssen Sie unter Administration > KI die Einstellungen bzw. Verknüpfungen vornehmen.
Einstellungen
Die Einstellungen definieren, ob die generelle KI-Funktionalität aktiviert ist.
Hinweis: Die
veralteten Einstellungendienen nur der Abwärtskompatibilität und sollten nicht mehr verwendet werden und durch KI-Agents ersetzt werden. Diese Einstellungen werden mit2025.2entfernt.
Funktion-Konfiguration
Einige Funktions-Aufrufe, die ein KI-Agent aufrufen kann, benötigen weitere Einstellungen.
Google Web Suche
| Name | Beschreibung |
|---|---|
| API Key | Definiert, einen Google API Key für die Web Suche |
| CSE Key | Programmable Search Engine Key für die Web Suche |
Die API Keys sind nicht von DocBee, sondern von Google. Sie müssen sich bei Google registrieren und die API Keys dort anlegen. Weitere Informationen finden Sie hier
KI-Embeddings
DocBee unterstützt KI-Embeddings, mit denen in der DocBee Datenbank gespeicherte Daten durchsucht werden können. Die Embeddings für Vorgangs-Daten werden zurzeit genutzt, um ähnliche Vorgänge zu finden.
| Name | Beschreibung |
|---|---|
| Aktiviert | Aktiviert die KI-Embeddings in DocBee |
| URL | URL zum Embeddings Endpoint (Dieser muss OpenAI Kompatibel sein) |
| API Key | API Key für den Embeddings Endpoint |
| Modell | Modell für die KI-Embeddings (Muss eine Dimension von 768 unterstützen) |
| Tage in der Vergangenheit | Anzahl der Tage in der Vergangenheit die verarbeitet werden sollen um Embeddings zu erstellen. Diese werden dann in der Datenbank gespeichert und können für die KI-Embeddings verwendet werden. Leer bedeutet keine Limitierung |
| Maximale Ähnlichkeits-Distanz | Die Maximale Kosinus-Distanz die für die Ähnlichkeits-Suche verwendet werden soll. Je kleiner der Wert, desto ähnlicher sind die Ergebnisse. 0 bedeutet identisch und 2 bedeutet vollständig unterschiedlich. Der Standardwert ist 0,02 |
| Vorgangs-Beschreibung | Definiert, ob Embeddings für die Vorgangs-Beschreibung erstellt werden |
| Vorgangs-Interne-Beschreibung | Definiert, ob Embeddings für die Vorgangs-Interne-Beschreibung erstellt werden |
| Nachrichten | Definiert, ob Embeddings für Nachrichten erstellt werden |
| Tätigkeits-Beschreibung | Definiert, ob Embeddings für die Tätigkeits-Beschreibung erstellt werden |
| Tätigkeits-Interne-Beschreibung | Definiert, ob Embeddings für die Tätigkeits-Interne-Beschreibung erstellt werden |
KI-Agenten
Die KI-Agenten sind die einzelnen Aktionen, die Sie in DocBee verwenden können. Diese Aktionen sind in der Regel auf eine bestimmte Aufgabe spezialisiert, wie z.B. das Verfassen von E-Mails oder das Zusammenfassen von E-Mails. Einige Beispiele finden Sie weiter unten.
Einstellungen
| Name | Beschreibung |
|---|---|
| Name | Name des KI-Agent |
| Aktiviert | Gibt an, ob der KI-Agent aktiviert ist. Wenn nicht aktiviert, wird der KI-Agent nicht ausgeführt. |
| Typ | Der Typ des KI-Agents (kann nachträglich nicht mehr geändert werden) |
| Modell | Das Modell was für diesen KI-Agent verwendet werden soll z.B. gpt-4o-mini. Das Modell muss vom KI-Provider unterstützt werden |
| KI-Provider | Der KI-Provider der für diesen KI-Agent verwendet werden soll (Siehe KI-Provider) |
| Temperature | Definiert wie sehr die KI "Kreativ" seien darf. (1.0 bedeutet sehr kreativ und 0.1 wenig kreativ) |
| Funktionen | Eine Liste von Funktionen die dieser KI-Agent ausführen darf. Es sollten immer nur Funktionen verwendet werden die auch wirklich benötigt werden um falsche Ausführung zu vermeiden. |
| Instruktionen | Die allgemeinen Instruktionen für den KI-Agent |
| Nachrichten/Aktionen | Die eigentliche Beschreibung, was der KI-Agent machen soll, sowie die Daten inkl. Platzhalter-Unterstützung und Nachrichten-Logik, die zur Verfügung stehen sollen. |
Typen
Mail-Parser
KI-Agenten mit diesem Typ können in der Mailparser-Konfiguration oder beim Outlook Add-In verwendet werden, um E-Mails zu verarbeiten.
Nachrichten
KI-Agenten mit diesem Typen stehen als Schaltfläche beim Versenden von E-Mails zur Verfügung.
Hinweis: Alle aktivierten KI-Agenten werden automatisch als Schaltfläche angezeigt
Tätigkeits-Beschreibung
KI-Agenten mit diesem Typen stehen als Schaltfläche beim Schreiben von Tätigkeitsbeschreibungen zur Verfügung.
Hinweis: Alle aktivierten KI-Agenten werden automatisch als Schaltfläche angezeigt
Automatisierung
Diese KI-Agenten können in der Automatisierung ausgewählt werden, um unter bestimmten Bedingungen ausgeführt zu werden.
Vorgangs-Bearbeiter / Leistungs-Bearbeiter
Diese KI-Agenten können in einem Vorgang bzw. einer Leistung als Verantwortlicher ausgewählt werden. Der KI-Agent wird dann ausgeführt und kann mithilfe der definierten Funktionen den Vorgang bzw. die Leistung bearbeiten. Jedes mal, wenn der Vorgang / die Leistung aktualisiert wird, oder eine neue Nachricht hinzugefügt wird, kann der KI-Agent erneut reagieren. Dabei merkt sich der KI-Agent alle vorherigen Aktionen, die er durchgeführt hat.
Beispiel
Du bist verantwortlich für die Kundenkommunikation und Gruppierung dieses Vorgangs. Wenn das Problem des Kunden nicht
genau beschrieben ist, frage höflich nach weiteren Informationen. Fasse alle eingehenden Nachrichten zusammen und
aktualisiere die Vorgangs-Beschreibung entsprechend. Gruppiere den Vorgang in die passende Kategorie basierend auf dem
Inhalt der Nachrichten. Sobald die Beschreibung ausreichend ist und der Vorgang kategorisiert wurde, setze den
Verantwortlichen auf den vorherigen Verantwortlichen zurück.
Funktionen
DocBee ermöglicht es, verschiedene Funktionen zu verwenden, um zu definieren, was der KI-Agent machen kann, falls nötig.
Aktuelle Zeit
Name: db_system_time
Liefert die aktuelle Zeit, Zeitzone und Datum zurück.
Mögliche Anwendungsfälle
- Das Aktualisieren von Fälligkeiten
Erstelle eine Vorgangs-/Leistungsnachricht
Name: db_ticket_message_create
| Parameter | Pflicht | Typ | Hinweis |
|---|---|---|---|
| message | Ja | String | Nachrichtentext (HTML erlaubt) |
| internal | Nein | Boolean | Standard true (interne Nachricht) |
| subject | Nein | String | Betreff, optional |
Erstelle eine neue Vorgangs- bzw. Leistungsnachricht. Der KI-Agent wird als Absender der Nachricht angezeigt.
Hinweis: Es kann auch definiert werden ob, diese Nachricht als
internoderexternmarkiert werden soll.
Beispiel
Füge eine neue Nachricht mit dem Inhalt "Hallo DocBee" hinzu
Google Websuche
Name: db_google_web_search
| Parameter | Pflicht | Typ | Hinweis |
|---|---|---|---|
| query | Ja | String | Suchbegriff, max. ~2048 Zeichen |
Fragt die Google Websuche ab und gibt die Ergebnisse zurück, damit diese weiterverarbeitet werden können.
Hinweis: Diese Funktion ist nur verfügbar, wenn Sie unter
Einstellungen > Funktion-Konfiguration > Google Web Sucheeinen Google API Key und CSE Key hinterlegt haben, wo durch zusätzlich Kosten entstehen können.
Beispiel
Suche nach "DocBee"
Mögliche Anwendungsfälle
- Finde Informationen zu einem bestimmten Thema zur weiteren Verarbeitung
Link öffnen
Name: db_open_link
| Parameter | Pflicht | Typ | Hinweis |
|---|---|---|---|
| link | Ja | String | Vollständige URL, bevorzugt https:// |
Öffnet einen absoluten Link.
Hinweis: Diese Funktion sollte nur bei KI-Agenten vom Typ Automatisierung verwendet werden, die auf eine Schaltfläche ausgeführt werden. Da sonst der Link nicht geöffnet wird.
Beispiel
Öffne den Link https://www.docbee.com
Mögliche Anwendungsfälle
- Aufrufen einer Suchmaschine mit einem vorher definierten Suchbegriff
Protokoll-Datenfelder abfragen
Name: db_protocol_get_data_field_struct
Erstellt eine Protokoll-Datenstruktur, die Sie dann in der Funktion Protokoll-Datenfelder setzen verwenden können.
Im Protokoll müssen die Felder einen Feldnamen haben, damit diese berücksichtigt werden können.
Beispiel
Frage die Protokoll-Daten ab oder Erstelle eine Datenstruktur der Protokoll-Daten
Mögliche Anwendungsfälle
- Automatisches befüllen von Protokollen-Feldern aus E-Mail Daten
- Automatisches befüllen von Protokollen-Feldern aus Fließtext
Protokoll-Datenfelder setzen
Name: db_protocol_set_data_field_struct
| Parameter | Pflicht | Typ | Hinweis |
|---|---|---|---|
| data | Ja | JSON-Array/String | Struktur mit id, type, value |
Aktualisiert ein Protokoll mit Daten, die vorher von der Funktion Protokoll-Datenfelder abfragen bereitgestellt wurde.
Beispiel
Aktualisieren das Protokoll über die Protokoll-Datenstruktur.
Mögliche Anwendungsfälle
- Automatisches befüllen von Protokollen-Feldern aus E-Mail Daten
- Automatisches befüllen von Protokollen-Feldern aus Fließtext
Sende E-Mail
Name: db_send_mail
| Parameter | Pflicht | Typ | Hinweis |
|---|---|---|---|
| recipients | Ja | List/String | Empfänger (Komma oder JSON-Array) |
| ccRecipients | Nein | List/String | CC-Empfänger |
| subject | Nein | String | Betreff |
| textContent | Ja | String | Text-Inhalt |
| htmlContent | Ja | String | HTML-Inhalt (bei Plain: gleichsetzen) |
Versendet eine E-Mail.
Beispiel
Sende eine E-Mail an info@docbee.com mit dem Betreff "KI Rocks" und dem Inhalt "Hallo DocBee"
Sende E-Mail aus Vorlage
Name: db_send_mail_from_message_template
| Parameter | Pflicht | Typ | Hinweis |
|---|---|---|---|
| templateName | Ja | String | Name der Vorlage |
| recipients | Ja | List/String | Empfänger |
| ccRecipients | Nein | List/String | CC-Empfänger |
Versendet eine E-Mail und verwendet dafür eine Nachrichten-Vorlage.
Beispiel
Sende eine E-Mail an info@docbee.com mit der Vorlage "KI-Vorlage"
Sende E-Mail-Antwort auf Vorgangs-/Leistungs-Nachricht
Name: db_ticket_message_reply
| Parameter | Pflicht | Typ | Hinweis |
|---|---|---|---|
| ticketMessageId | Ja | Long | ID der Ursprung-Nachricht |
| subject | Ja | String | Betreff der Antwort |
| textContent | Ja | String | Text-Teil der E-Mail |
| htmlContent | Ja | String | HTML-Teil der E-Mail |
Versendet eine E-Mail als Antwort auf eine Vorgangs- oder Leistungsnachricht.
Beispiel
Antworte mit einer E-Mail auf die letzte Vorgangs-Nachricht mit dem Inhalt "Vielen Dank für Ihre Nachricht"
Vorgang Tags hinzufügen
Name: db_ticket_add_tags
| Parameter | Pflicht | Typ | Hinweis |
|---|---|---|---|
| names | Ja | List/String | Komma-Liste oder JSON-Array |
Fügt neue Tags zu einem Vorgang hinzu.
Beispiel
Füge den Tag "Notfall" hinzu
Mögliche Anwendungsfälle
- Weitere Kategorisierung von Vorgängen bei Eingang von E-Mails
Vorgang ändern
Name: db_ticket_change
| Parameter | Pflicht | Typ | Hinweis |
|---|---|---|---|
| status | Nein | String | Statusname |
| priority | Nein | String | Priorität |
| category | Nein | String | Kategorie |
| description | Nein | String | Beschreibung |
| internalDescription | Nein | String | Interne Beschreibung |
| owner | Nein | String | Verantwortlicher "Name" |
| dueDate | Nein | String | ISO-Zeit in UTC (...Z) |
| department | Nein | String | Abteilung |
Ändert einen Vorgang in DocBee und ermöglicht, dass ändern des Status, der Priorität, der Kategorie, der Beschreibungen, der internen Beschreibung des Verantwortlichen, der Abteilung und der Fälligkeit.
Beispiel
Ändere den Status des Vorgangs auf Geschlossen
Mögliche Anwendungsfälle
- Zusammenfassen von E-Mails für die Vorgangs-Beschreibung
- Setzen der Kategorie aus E-Mail Daten
- Bestimmen der Priorität aus E-Mail Daten
Vorgang zuweisen an vorherigen Verantwortlichen
Name: db_ticket_assign_previous_owner
Weist den Vorgang an den letzten vorherigen Verantwortlichen, der keine Queue oder KI-Agent ist, zurück.
Beispiel
Setze den Verantwortlichen auf den vorherigen Verantwortlichen zurück.
Mögliche Anwendungsfälle
- Rückgabe des Verantwortlichen an einen menschlichen Mitarbeiter, wenn der KI-Agent seine Arbeit erledigt hat.
Leistung anlegen
Name: db_docbee_document_create
| Parameter | Pflicht | Typ | Hinweis |
|---|---|---|---|
| personInCharge | Nein | String | Name verantwortliche Person (Fallback Vorgang-Owner) |
| customer | Nein | String | Kundenname oder ID (Fallback Vorgang-Kunde) |
Legt eine neue Leistung in DocBee an (ohne Tätigkeit, dazu wird die Funktion Tätigkeit anlegen verwendet).
Beispiel
Lege eine neue Leistung für den Kunden "Test" mit Verantwortlichen "Max Mustermann" an.
Tätigkeit anlegen
Name: db_task_create
| Parameter | Pflicht | Typ | Hinweis |
|---|---|---|---|
| serviceType | Ja | String | Name oder Nummer der Leistungsart |
| name | Bedingt | String | Pflicht, falls Option "Name aus Leistungsart" aus |
| description | Nein | String | Optionale Beschreibung |
| internalDescription | Nein | String | Optionale interne Beschreibung |
| estimate | Nein | Number | Minuten |
| dueDate | Nein | String | ISO-Zeit in UTC (...Z) |
Legt eine neue Tätigkeit unter einer Leistung an.
Beispiel
Lege eine neue Leistung für den Kunden "Test" mit Verantwortlichen "Max Mustermann" an.
Lege unter dieser Leistung eine neue Tätigkeit mit dem Titel "Beratung", der Leistungsart "Beratung", der geschätzten
Dauer von 60 Minuten und der Fälligkeit in 3 Tagen an.
Ergebnis erstellen
Name: db_return_result
| Parameter | Pflicht | Typ | Hinweis |
|---|---|---|---|
| result | Ja | String | Text für das finale Ergebnis |
Diese Funktion kann z.B. in der Leistungsabschlussprüfung verwendet werden, um ein Ergebnis zu erstellen. Anstatt die Antwort des KI-Agenten als Text zurückzugeben, wird ein Ergebnis erstellt, das dann in der Leistungsabschlussprüfung verwendet werden kann.
Beispiel
Gebe das Ergebnis "false" zurück
MCP-Tools
Zusätzlich zu den Standard-Funktionen kann der KI-Agent auch MCP-Tools verwenden, die in DocBee hinterlegt sind. Die MCP-Tools können in der MCP-Server Liste verwaltet werden.
KI-Provider
DocBee betreibt keine eigenen KI-Modelle, sondern ermöglicht eine Anbindung von KI-Providern, die dann die KI-Modelle bereitstellen. Damit Sie je nach Datenschutzklassifizierung oder Kostenstruktur den richtigen KI-Provider auswählen können, ist es möglich, mehrere KI-Provider in DocBee zu hinterlegen.
Hinweis: DocBee unterstützt aktuell nur OpenAI kompatible KI-Provider. Damit die KI-Agenten Funktionen aufrufen können müssen die Anbieter
Function Callingbzw.Tool Callingunterstützen.
Info: Falls Sie einen lokalen KI-Provider verwenden möchten, können Sie dies z.B. über ollama erreichen.
ollamaunterstützt sowohlTool Callingund stellt eine OpenAI kompatible API bereit.
Einstellungen
| Name | Beschreibung |
|---|---|
| Name | Name des Anbieters |
| URL | Die URL zur OpenAI Kompatible API z.B. https://api.openai.com/v1/chat/completions |
| API Key | API Key zum Anbieter |
| Typ | Typ des KI-Provider (Aktuell nur OpenAI kompatible) |
| Aktiviert | Aktiviert bzw. Deaktiviert den KI-Provider |
MCP-Server
Sie können in DocBee MCP-Server hinterlegen, die dann Tools für die KI-Agenten bereitstellen können. Zurzeit werden vom MCP-Server nur Tools abgefragt.
| Name | Beschreibung |
|---|---|
| Name | Name des MCP-Servers |
| URL | URL zum MCP-Server |
| Token | API Key zum MCP-Server (momentan werden nur Bearer Token unterstützt) |
MCP-Tools
Wenn Sie einen MCP-Server hinterlegen, können Sie MCP-Tools importieren, die dann in den KI-Agenten verwendet werden können.
Öffnen Sie dazu den Dialog MCP-Tool hinzufügen und wählen Sie ein Tool aus dem MCP-Server aus. Danach ist das Tool in den KI-Agenten verfügbar.
Falls der MCP-Server aktualisiert wird, können Sie die Tools in DocBee ebenfalls aktualisieren, indem Sie in der Ansicht
des MCP-Servers auf MCP-Tool aktualisieren klicken.
Hinweis: Als Ergebnis des MCP-Tools wird zurzeit nur Text unterstützt.
Beispiel KI-Agents
E-Mail Zusammenfassung & Kategorisierung
Der folgende KI-Agent kann dazu verwendet werden, um E-Mails zusammenzufassen und die Kategorie des Vorgangs zu setzen beim Erstellen eines neuen Vorgangs über einen Mailparser.
Hinweis: Dieser KI-Agent muss damit er funktioniert, unter
Administration > Vorgang > Mail Parser Konfigurationausgewählt werden.
Parameter
| Name | Wert |
|---|---|
| Name | Mail-Parser Agent |
| Aktiviert | Ja |
| Typ | Mail-Parser |
| Modell | gpt-4o-mini |
| KI-Provider | Eine OpenAI Provider z.B. direkt OpenAI oder Langdock |
| Temperature | 0.1 |
| Funktionen | Vorgang ändern |
Instruktionen
You are a helpful assistant.
All Answers should be written in german.
If a tool call return an error skip the tool call and procced without it without retrying.
Hinweis: Eine allgemeine Instruktion in Englisch, da die KI-Modelle auf Englisch trainiert sind. Die Antworten werden aber in der Sprache des Benutzers zurückgegeben.
Nachrichten/Aktionen
Ändere den Vorgang und setzte die Beschreibung des Vorgangs auf eine Zusammenfassung von maximal 2 Sätzen des mit <inhalt> gekennzeichenten Textes.
Zusätzlich ändere die Kategorie des Vorgangs auf die möglichst passende Kategorie anhand des <inhalt>.
Ändere keine anderen Werte auf dem Vorgang in dem du eine leere Zeichenkette übergibst.
<inhalt>
%VORGANGSNACHRICHT_BETREFF%
%VORGANGSNACHRICHT_INHALT%
</inhalt>
Mögliche Erweiterungen: Hier könnten noch weitere Anweisungen verwendet werden um z.B. die Fälligkeit oder die Priorität zu setzen.
Übergebene Daten
In diesem Beispiel wird der Betreff und der vollständige Text-Inhalt der E-Mail übergeben. Zusätzlich werden durch die Funktion, die in DocBee hinterlegten Vorgangs-Kategorien, -Status und -Prioritäten übergeben, damit der KI-Agenten diese bestimmen kann.