COSMO Bot (Vorschau)
COSMO Bot erhöht Ihren Geschäftserfolg durch mehr Effizienz im Alltag. Wenn Sie heute eine Standardfrage beantworten, verschwenden Sie Zeit. Im Kontakt mit Ihren Kunden ist dies oft eine gute Gelegenheit, sich gegenseitig kennenzulernen und eine Beziehung aufzubauen. Aber intern, von Mitarbeitern zu Mitarbeiter oder wenn es einfach zu viel zu tun gibt, ist es ein Luxus, den nicht jeder zulassen kann. Mit diesem Connector können Sie die Funktionalität des Bots erweitern und andere Systeme integrieren.
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Dienstleistung | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Logik-Apps | Norm | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: – Azure Government-Regionen - Azure China-Regionen - US Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | COSMO CONSULT Support |
| URL | https://de.cosmoconsult.com/service/support/ |
| support.west@cosmoconsult.com |
| Connectormetadaten | |
|---|---|
| Herausgeber | COSMO CONSULT GmbH |
| Webseite | https://cosma.link/cc-bot |
| Datenschutzrichtlinie | https://www.cosmoconsult.com/data-protection/ |
| Kategorien | Künstliche Intelligenz; Kommunikation |
Voraussetzungen
Um diesen Connector zu verwenden, benötigen Sie administrativen Zugriff auf eine COSMO Bot-Instanz. Was ist COSMO Bot?Wie erhalte ich eine COSMO Bot-Instanz?
Wie erhalten Sie Anmeldeinformationen?
Sobald Sie über administrativen Zugriff auf eine COSMO Bot-Instanz verfügen, wechseln Sie zur Chatschnittstelle (d. h. https://cosma.cosmoconsult.com/) und wechseln Sie zur Registerkarte "Verwaltung", indem Sie in der oberen rechten Ecke auf "Verwaltung" klicken. Navigieren Sie zu "API-Schlüssel", und erstellen Sie eine neue, oder kopieren Sie eine vorhandene.
Erstellen einer Verbindung
Der Connector unterstützt die folgenden Authentifizierungstypen:
| Vorgabe | Parameter zum Erstellen einer Verbindung. | Alle Regionen | Nicht teilbar |
Vorgabe
Anwendbar: Alle Regionen
Parameter zum Erstellen einer Verbindung.
Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.
| Name | Typ | Description | Erforderlich |
|---|---|---|---|
| Bot-Instanz-URL | Schnur | Die URL, unter der Ihre Bot-Instanz erreicht werden kann | Richtig |
| API-Schlüssel | securestring | Der API-Schlüssel für den Zugriff auf diese Bot-Instanz | Richtig |
Drosselungsgrenzwerte
| Name | Aufrufe | Verlängerungszeitraum |
|---|---|---|
| API-Aufrufe pro Verbindung | 100 | 60 Sekunden |
Aktionen
| Abrufen aller Fragebeantwortersätze |
Ruft alle Antworten aus der verbundenen Instanz ab. |
| Abrufen aller Themen |
Ruft alle Themen aus der verbundenen Bot-Instanz ab. |
| Abrufen globaler Einstellungen |
Ruft die globalen Einstellungen aus der verbundenen Instanz ab. |
| Bearbeiten eines vorhandenen Fragebeantwortungssatzes |
Bearbeiten Sie einen vorhandenen Frageantwortsatz aus der verbundenen Instanz. |
| COSMO-Bot-Skript konvertieren |
Führen Sie den angegebenen Text über den COSMO Bot Script Parser aus. |
| Entfernen eines Experten aus einem Thema |
Der Bot entfernt einen Experten aus dem bereitgestellten Thema. Wenn kein Thema angegeben wird, wird der Experte aus allen Themen entfernt. |
| Erstellen einer Schattenkopie eines Frageantwortsatzes |
Fügt eine neue Schattenkopie für den durch die kurz beschriebenen Kurzbeschreibung angegebenen Fragebeantwortungssatz hinzu. Vorsichtig! Diese Schattenkopien werden gelöscht, wenn die Antwort aktualisiert wird. Daher wird empfohlen, diese Aktion automatisch mithilfe des Triggers "When a question-answer set is updated" aufzurufen. |
| Experten für ein Thema abrufen |
Ruft alle Expoerts aus der verbundenen Instanz ab. |
| Hinzufügen eines Experten zu einem Thema |
Der Bot fügt den Experten zum bereitgestellten Thema hinzu. |
| Hinzufügen eines neuen Fragebeantwortungssatzes |
Fügt der verbundenen Instanz einen neuen Fragebeantwortungssatz hinzu. |
| Hinzufügen eines neuen Themas |
Fügt der verbundenen Instanz ein neues Thema hinzu. |
| Löschen eines Fragebeantwortungssatzes |
Löschen Sie einen vorhandenen Frageantwortsatz aus der verbundenen Instanz. |
| Offene Tickets erhalten |
Ruft alle geöffneten Tickets aus der verbundenen Instanz ab. |
| Schließen eines Tickets |
Schließt ein offenes Ticket für die verbundene Instanz. |
| Stellen Sie COSMO Bot eine Frage |
Der Bot durchsucht die Wissensdatenbank und gibt die Antwort mit der besten Übereinstimmung zurück. Gibt auch die Bewertung zurück. |
| Thema abrufen |
Ruft ein bestimmtes Thema aus der verbundenen Instanz ab. |
| Umbenennen eines vorhandenen Themas |
Benennen Sie ein vorhandenes Thema aus der verbundenen Instanz um. |
| Öffnen eines Tickets (Feedback) |
Öffnen Sie ein neues Ticket für Feedback vom Typ "Feedback" für die verbundene Instanz. |
| Öffnen eines Tickets (Frage) |
Öffnen Sie ein neues Ticket auf der verbundenen Instanz. |
| Übersetzen (Markdown freundlich) |
Übersetzen Sie den angegebenen Text, während Sie die Syntax des COSMO Bot-Dialekts Markdown beachten. |
Abrufen aller Fragebeantwortersätze
Ruft alle Antworten aus der verbundenen Instanz ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Nach Thema filtern (enthält)
|
filterByTopic | string |
Nach Thema filtern (enthält) |
|
|
Nach Kurzbeschreibung filtern (enthält)
|
filterByShortDescription | string |
Nach Kurzbeschreibung filtern (enthält) |
|
|
Nach Fragetext filtern (enthält)
|
filterByQuestionText | string |
Nach Fragetext filtern (enthält) |
|
|
Nach Antworttext filtern (enthält)
|
filterByAnswerText | string |
Nach Antworttext filtern (enthält) |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Antworten
|
answers | array of Answer |
Abrufen aller Themen
Ruft alle Themen aus der verbundenen Bot-Instanz ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Nach Experten filtern
|
filterByExpert | string |
Nach Experten filtern |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Themen
|
topics | array of string |
Abrufen globaler Einstellungen
Ruft die globalen Einstellungen aus der verbundenen Instanz ab.
Gibt zurück
Bearbeiten eines vorhandenen Fragebeantwortungssatzes
Bearbeiten Sie einen vorhandenen Frageantwortsatz aus der verbundenen Instanz.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Kurze Beschreibung des vorhandenen Satzes
|
shortDescription | True | string | |
|
Aktualisiertes Thema
|
newTopic | string | ||
|
Aktualisierte Kurzbeschreibung
|
newShortDescription | string | ||
|
Aktualisierte Fragen
|
newQuestions | array of string | ||
|
Aktualisierter Antworttext
|
newAnswerText | string | ||
|
Benutzer-E-Mail
|
userEmail | string |
COSMO-Bot-Skript konvertieren
Führen Sie den angegebenen Text über den COSMO Bot Script Parser aus.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Eingabetext
|
inputText | True | string | |
|
Ausgabeformat
|
outputFormat | True | string |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Ausgabetext
|
outputText | string |
Der analysierte Text, der vom COSMO Bot Script Parser zurückgegeben wird. |
Entfernen eines Experten aus einem Thema
Der Bot entfernt einen Experten aus dem bereitgestellten Thema. Wenn kein Thema angegeben wird, wird der Experte aus allen Themen entfernt.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Experten-E-Mail
|
expertEmail | True | string | |
|
Thema
|
topic | string |
Erstellen einer Schattenkopie eines Frageantwortsatzes
Fügt eine neue Schattenkopie für den durch die kurz beschriebenen Kurzbeschreibung angegebenen Fragebeantwortungssatz hinzu. Vorsichtig! Diese Schattenkopien werden gelöscht, wenn die Antwort aktualisiert wird. Daher wird empfohlen, diese Aktion automatisch mithilfe des Triggers "When a question-answer set is updated" aufzurufen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Kurzbeschreibung der ursprünglichen Antwort
|
shortDescription | True | string | |
|
Kurzbeschreibung der Schattenkopie
|
subShortDescription | True | string | |
|
Fragen
|
subQuestions | True | array of string | |
|
Antworttext
|
subAnswerText | True | string |
Experten für ein Thema abrufen
Ruft alle Expoerts aus der verbundenen Instanz ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Thema
|
topic | True | string |
Thema |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Experten
|
expertEmails | array of string |
Hinzufügen eines Experten zu einem Thema
Der Bot fügt den Experten zum bereitgestellten Thema hinzu.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Thema
|
topic | True | string | |
|
Experten-E-Mail
|
expertEmail | True | string |
Hinzufügen eines neuen Fragebeantwortungssatzes
Fügt der verbundenen Instanz einen neuen Fragebeantwortungssatz hinzu.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Thema
|
topic | True | string | |
|
Kurze Beschreibung:
|
shortDescription | True | string | |
|
Fragen
|
questions | True | array of string | |
|
Antworttext
|
answerText | True | string | |
|
Benutzer-E-Mail
|
userEmail | string |
Hinzufügen eines neuen Themas
Fügt der verbundenen Instanz ein neues Thema hinzu.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Themaname
|
name | True | string | |
|
Description
|
description | True | string | |
|
Experten-E-Mails
|
expertEmails | True | array of string |
Löschen eines Fragebeantwortungssatzes
Löschen Sie einen vorhandenen Frageantwortsatz aus der verbundenen Instanz.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Kurze Beschreibung:
|
shortDescription | True | string |
Offene Tickets erhalten
Ruft alle geöffneten Tickets aus der verbundenen Instanz ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Filtern nach Open Duration (Minimum)
|
filterByHoursSinceOpened | integer |
Erhalten Sie nur Tickets, die länger als x Stunden geöffnet sind. |
|
|
Filtern nach Geöffneter Dauer (maximal)
|
filterByHoursSinceOpenedMax | integer |
Erhalten Sie nur Tickets, die für weniger als x Stunden geöffnet wurden. |
|
|
Nach Thema filtern
|
filterByTopic | string |
Nach Thema filtern |
|
|
Nach Experten filtern
|
filterByExpertEmail | string |
Nach Experten filtern |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Billette
|
tickets | array of Ticket |
Schließen eines Tickets
Schließt ein offenes Ticket für die verbundene Instanz.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Eindeutige Ticket-ID
|
ticketId | True | string | |
|
E-Mail des Benutzers, der das Ticket verarbeitet hat
|
editorEmail | True | string | |
|
Kommentar, der an den Benutzer gesendet wird
|
editorComment | True | string |
Stellen Sie COSMO Bot eine Frage
Der Bot durchsucht die Wissensdatenbank und gibt die Antwort mit der besten Übereinstimmung zurück. Gibt auch die Bewertung zurück.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Frage
|
question | True | string | |
|
Schwellenwert für Bewertungen
|
scoreThreshold | integer |
Die Mindestbewertung einer Antwort, die zurückgegeben werden soll. |
|
|
Benutzer-E-Mail
|
userEmail | string |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Antwort gefunden
|
foundAnswer | boolean |
Ob COSMO Bot eine Antwort gefunden hat, die mit der Frage übereinstimmte. |
|
Ist Shadow-Answer
|
isSubAnswer | boolean |
Gibt an, ob es sich bei der zurückgegebenen Antwort um eine Unterantwort handelt. |
|
Wurde Frage übersetzt
|
isTranslated | boolean |
Gibt an, ob die Frage und die zurückgegebene Antwort übersetzt wurde. |
|
Antwort
|
answer | Answer | |
|
Score
|
score | integer |
Wie sicher der Bot ist, dass die zurückgegebene Antwort korrekt ist. |
Thema abrufen
Ruft ein bestimmtes Thema aus der verbundenen Instanz ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Themaname
|
topicName | True | string |
Themaname |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Name
|
topic.name | string | |
|
Description
|
topic.description | string |
Umbenennen eines vorhandenen Themas
Benennen Sie ein vorhandenes Thema aus der verbundenen Instanz um.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Themaname
|
name | True | string |
Der Name des vorhandenen Themas, das umbenannt werden soll. |
|
Neuer Themenname
|
newName | True | string |
Der Name, in den das Thema umbenannt wird. |
Öffnen eines Tickets (Feedback)
Öffnen Sie ein neues Ticket für Feedback vom Typ "Feedback" für die verbundene Instanz.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzer-E-Mail
|
userEmail | True | string | |
|
Frage, die vom Benutzer gestellt wurde
|
queryText | True | string | |
|
Kurze Beschreibung der Antwort
|
answerShortDescription | True | string | |
|
Feedback zur Antwort
|
feedbackText | True | string |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Fahrkarte
|
ticket | Ticket |
Öffnen eines Tickets (Frage)
Öffnen Sie ein neues Ticket auf der verbundenen Instanz.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Benutzer-E-Mail
|
userEmail | True | string | |
|
Frage, die vom Benutzer gestellt wurde
|
queryText | True | string | |
|
Thema, zu dem diese Frage wahrscheinlich gehört
|
topic | string |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Fahrkarte
|
ticket | Ticket |
Übersetzen (Markdown freundlich)
Übersetzen Sie den angegebenen Text, während Sie die Syntax des COSMO Bot-Dialekts Markdown beachten.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Zielsprache
|
targetLanguageCode | True | string |
Der Zielsprachencode (Beispiel: fr). |
|
Text
|
inputText | True | string |
Der zu übersetzende Text. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Übersetzter Text
|
outputText | string |
Auslöser
| Beim Erstellen eines neuen Tickets |
Wenn ein neues Ticket erstellt wird. |
| Wenn das Thema eines Tickets aktualisiert wird |
Wenn ein Thema eines vorhandenen Tickets aktualisiert wird. |
| Wenn ein Benutzer eine Frage stellt |
Wenn ein Benutzer eine Frage stellt. |
| Wenn ein Fragebeantwortungssatz erstellt oder geändert wird |
Wenn ein Fragebeantwortungssatz erstellt oder geändert wird. |
| Wenn ein neuer Fragebeantwortungssatz erstellt wird |
Wenn ein neuer Fragebeantwortungssatz erstellt wird. |
| Wenn ein Ticket aufgelöst wird |
Wenn ein vorhandenes Ticket aufgelöst wird. |
Beim Erstellen eines neuen Tickets
Wenn ein neues Ticket erstellt wird.
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Fahrkarte
|
ticket | Ticket |
Wenn das Thema eines Tickets aktualisiert wird
Wenn ein Thema eines vorhandenen Tickets aktualisiert wird.
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Fahrkarte
|
ticket | Ticket |
Wenn ein Benutzer eine Frage stellt
Wenn ein Benutzer eine Frage stellt.
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Benutzer-E-Mail
|
userEmail | string | |
|
Frage, die vom Benutzer gestellt wurde
|
queryText | string | |
|
Antwort gefunden
|
foundAnswer | boolean |
Gibt an, ob COSMO Bot eine Antwort gefunden hat, die mit der Frage des Benutzers übereinstimmte. |
|
Antwort
|
answer | Answer |
Wenn ein Fragebeantwortungssatz erstellt oder geändert wird
Wenn ein Fragebeantwortungssatz erstellt oder geändert wird.
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Antwort
|
answer | Answer |
Wenn ein neuer Fragebeantwortungssatz erstellt wird
Wenn ein neuer Fragebeantwortungssatz erstellt wird.
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Antwort
|
answer | Answer |
Wenn ein Ticket aufgelöst wird
Wenn ein vorhandenes Ticket aufgelöst wird.
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Fahrkarte
|
ticket | Ticket | |
|
Editor-E-Mail
|
editorEmail | string | |
|
Editorkommentar
|
editorComment | string | |
|
Deep-Link zur ursprünglichen Abfrage
|
queryUrl | string |
Definitionen
Antwort
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Thema
|
topic | string | |
|
Kurze Beschreibung:
|
shortDescription | string | |
|
Fragen
|
questions | array of string | |
|
Antworttext
|
answerText | string | |
|
Datum und Uhrzeit, zu der diese Antwort zuletzt geändert wurde
|
modifiedAt | date-time | |
|
Geändert von
|
modifiedBy | string |
Fahrkarte
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Eindeutige Ticket-ID
|
ticketId | string | |
|
Thema
|
topic | string | |
|
Deep-Link zum Verarbeiten des Tickets
|
ticketUrl | string | |
|
E-Mail-Adresse des Antragstellers
|
requesterEmail | string | |
|
Experten-E-Mails
|
expertEmails | array of string | |
|
Frage, die vom Benutzer gestellt wurde
|
queryText | string | |
|
Feedback, das vom Benutzer übermittelt wurde
|
feedbackText | string |
Dies ist leer, wenn dieses Ticket kein Feedback ist. |
|
Kurze Beschreibung der Antwort, die der Benutzer erhalten hat, nachdem er seine Frage gestellt hat
|
answerShortDescription | string |
Dies ist leer, wenn dieses Ticket kein Feedback ist. |
|
Antwort, die der Benutzer nach der Frage erhalten hat
|
answerText | string |
Dies ist leer, wenn dieses Ticket kein Feedback ist. |
|
Datum und Uhrzeit der Erstellung des Tickets unter
|
createdAt | date-time |