COSMO Bot (préversion)
COSMO Bot augmente le succès de votre entreprise grâce à une plus grande efficacité dans la vie quotidienne. Si vous répondez à une question standard aujourd’hui, vous perdez du temps. En contact avec vos clients, il s’agit souvent d’une bonne occasion de se connaître mutuellement et d’établir une relation. Mais en interne, de l’employé à l’employé, ou quand il y a tout simplement trop de choses à faire, c’est un luxe que tout le monde ne peut pas se permettre. Ce connecteur vous permet d’étendre les fonctionnalités du bot et d’intégrer d’autres systèmes.
Ce connecteur est disponible dans les produits et régions suivants :
| Service | classe | Régions |
|---|---|---|
| Copilot Studio | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Applications logiques | Norme | Toutes les régions Logic Apps , à l’exception des suivantes : - Régions Azure Government - Régions Azure Chine - Us Department of Defense (DoD) |
| Power Apps | Premium | Toutes les régions Power Apps , à l’exception des suivantes : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Contact | |
|---|---|
| Nom | COSMO CONSULT Support |
| URL | https://de.cosmoconsult.com/service/support/ |
| Messagerie électronique | support.west@cosmoconsult.com |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | COSMO CONSULT GmbH |
| Site internet | https://cosma.link/cc-bot |
| Politique de confidentialité | https://www.cosmoconsult.com/data-protection/ |
| Catégories | IA; Communication |
Prerequisites
Pour utiliser ce connecteur, vous devez disposer d’un accès administratif à une instance cosmo Bot. Qu’est-ce que COSMO Bot ?Comment obtenir une instance COSMO Bot ?
Comment obtenir des informations d’identification ?
Une fois que vous avez accès administratif à une instance COSMO Bot, accédez à l’interface de conversation (par exemple https://cosma.cosmoconsult.com/) et basculez vers l’onglet « Administration » en cliquant sur « Administration » dans le coin supérieur droit. Accédez à « Clés API » et créez-en un ou copiez-en un existant.
Création d’une connexion
Le connecteur prend en charge les types d’authentification suivants :
| Par défaut | Paramètres de création de connexion. | Toutes les régions | Non partageable |
Faire défaut
Applicable : Toutes les régions
Paramètres de création de connexion.
Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.
| Nom | Type | Descriptif | Obligatoire |
|---|---|---|---|
| URL de l’instance de bot | ficelle | URL où votre instance de bot peut être atteinte | Vrai |
| Clé d’API | securestring | Clé API pour accéder à cette instance de bot | Vrai |
Limitations
| Nom | Appels | Période de renouvellement |
|---|---|---|
| Appels d’API par connexion | 100 | 60 secondes |
Actions
| Ajouter un expert à une rubrique |
Le bot ajoute l’expert à la rubrique fournie. |
| Ajouter un nouveau jeu de questions-réponses |
Ajoute un nouveau jeu de questions-réponses à l’instance connectée. |
| Ajouter une nouvelle rubrique |
Ajoute une nouvelle rubrique à l’instance connectée. |
| Convertir un script COSMO Bot |
Exécutez le texte donné via l’analyseur COSMO Bot Script. |
| Créer une cliché instantané d’un jeu de réponses aux questions |
Ajoute une nouvelle cliché instantané pour le jeu de réponses aux questions spécifié par la brève description. Prudent! Ces clichés instantanés sont supprimés lorsque la réponse est mise à jour. Il est donc recommandé d’appeler automatiquement cette action à l’aide du déclencheur « lorsqu’un jeu de réponses aux questions est mis à jour ». |
| Fermer un ticket |
Ferme un ticket ouvert sur l’instance connectée. |
| Modifier un jeu de questions-réponses existant |
Modifiez un jeu de réponses aux questions existant à partir de l’instance connectée. |
| Obtenir des experts pour une rubrique |
Obtient tous les expoerts de l’instance connectée. |
| Obtenir des tickets ouverts |
Obtient tous les tickets ouverts de l’instance connectée. |
| Obtenir les paramètres globaux |
Obtient les paramètres globaux de l’instance connectée. |
| Obtenir tous les ensembles de questions-réponses |
Obtient toutes les réponses de l’instance connectée. |
| Obtenir toutes les rubriques |
Obtient toutes les rubriques de l’instance de bot connectée. |
| Obtenir une rubrique |
Obtient une rubrique spécifique de l’instance connectée. |
| Ouvrir un ticket (commentaires) |
Ouvrez un nouveau ticket de commentaires de type sur l’instance connectée. |
| Ouvrir un ticket (question) |
Ouvrez un nouveau ticket sur l’instance connectée. |
| Poser une question à COSMO Bot |
Le bot effectue une recherche dans la base de connaissances et retourne la réponse avec la meilleure correspondance. Retourne également le score. |
| Renommer une rubrique existante |
Renommez une rubrique existante à partir de l’instance connectée. |
| Supprimer un expert d’une rubrique |
Le bot supprime un expert de la rubrique fournie. Si aucune rubrique n’est donnée, l’expert sera supprimé de toutes les rubriques. |
| Supprimer un jeu de questions-réponses |
Supprimez un jeu de réponses aux questions existant de l’instance connectée. |
| Traduire (markdown convivial) |
Traduisez le texte donné tout en respectant la syntaxe Markdown du dialecte COSMO Bot. |
Ajouter un expert à une rubrique
Le bot ajoute l’expert à la rubrique fournie.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Sujet
|
topic | True | string | |
|
E-mail d’expert
|
expertEmail | True | string |
Ajouter un nouveau jeu de questions-réponses
Ajoute un nouveau jeu de questions-réponses à l’instance connectée.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Sujet
|
topic | True | string | |
|
Brève description
|
shortDescription | True | string | |
|
Questions
|
questions | True | array of string | |
|
Texte de la réponse
|
answerText | True | string | |
|
E-mail utilisateur
|
userEmail | string |
Ajouter une nouvelle rubrique
Ajoute une nouvelle rubrique à l’instance connectée.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Nom de la rubrique
|
name | True | string | |
|
Descriptif
|
description | True | string | |
|
E-mails d’experts
|
expertEmails | True | array of string |
Convertir un script COSMO Bot
Exécutez le texte donné via l’analyseur COSMO Bot Script.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Texte d’entrée
|
inputText | True | string | |
|
Format de sortie
|
outputFormat | True | string |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Texte de sortie
|
outputText | string |
Texte analysé retourné par l’analyseur cosmo Bot Script. |
Créer une cliché instantané d’un jeu de réponses aux questions
Ajoute une nouvelle cliché instantané pour le jeu de réponses aux questions spécifié par la brève description. Prudent! Ces clichés instantanés sont supprimés lorsque la réponse est mise à jour. Il est donc recommandé d’appeler automatiquement cette action à l’aide du déclencheur « lorsqu’un jeu de réponses aux questions est mis à jour ».
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Description courte de la réponse d’origine
|
shortDescription | True | string | |
|
Description courte de Cliché instantané
|
subShortDescription | True | string | |
|
Questions
|
subQuestions | True | array of string | |
|
Texte de la réponse
|
subAnswerText | True | string |
Fermer un ticket
Ferme un ticket ouvert sur l’instance connectée.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Unique Ticket ID
|
ticketId | True | string | |
|
E-mail de l’utilisateur qui a traité le ticket
|
editorEmail | True | string | |
|
Commentaire qui sera envoyé à l’utilisateur
|
editorComment | True | string |
Modifier un jeu de questions-réponses existant
Modifiez un jeu de réponses aux questions existant à partir de l’instance connectée.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Brève description de l’ensemble existant
|
shortDescription | True | string | |
|
Rubrique mise à jour
|
newTopic | string | ||
|
Brève description mise à jour
|
newShortDescription | string | ||
|
Questions mises à jour
|
newQuestions | array of string | ||
|
Texte de réponse mis à jour
|
newAnswerText | string | ||
|
E-mail utilisateur
|
userEmail | string |
Obtenir des experts pour une rubrique
Obtient tous les expoerts de l’instance connectée.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Sujet
|
topic | True | string |
Sujet |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Experts
|
expertEmails | array of string |
Obtenir des tickets ouverts
Obtient tous les tickets ouverts de l’instance connectée.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Filtrer par durée d’ouverture (minimum)
|
filterByHoursSinceOpened | integer |
Obtenez uniquement des billets ouverts depuis plus de x heures. |
|
|
Filtrer par durée d’ouverture (maximum)
|
filterByHoursSinceOpenedMax | integer |
N’obtenez que des billets ouverts depuis moins de x heures. |
|
|
Filtrer par rubrique
|
filterByTopic | string |
Filtrer par rubrique |
|
|
Filtrer par expert
|
filterByExpertEmail | string |
Filtrer par expert |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Billets
|
tickets | array of Ticket |
Obtenir les paramètres globaux
Obtient les paramètres globaux de l’instance connectée.
Retours
Obtenir tous les ensembles de questions-réponses
Obtient toutes les réponses de l’instance connectée.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Filtrer par rubrique (contient)
|
filterByTopic | string |
Filtrer par rubrique (contient) |
|
|
Filtrer par description courte (contient)
|
filterByShortDescription | string |
Filtrer par description courte (contient) |
|
|
Filtrer par texte de question (contient)
|
filterByQuestionText | string |
Filtrer par texte de question (contient) |
|
|
Filtrer par texte de réponse (contient)
|
filterByAnswerText | string |
Filtrer par texte de réponse (contient) |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Answers
|
answers | array of Answer |
Obtenir toutes les rubriques
Obtient toutes les rubriques de l’instance de bot connectée.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Filtrer par expert
|
filterByExpert | string |
Filtrer par expert |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Sujets
|
topics | array of string |
Obtenir une rubrique
Obtient une rubrique spécifique de l’instance connectée.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Nom de la rubrique
|
topicName | True | string |
Nom de la rubrique |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Nom
|
topic.name | string | |
|
Descriptif
|
topic.description | string |
Ouvrir un ticket (commentaires)
Ouvrez un nouveau ticket de commentaires de type sur l’instance connectée.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
E-mail utilisateur
|
userEmail | True | string | |
|
Question posée par l’utilisateur
|
queryText | True | string | |
|
Brève description de la réponse
|
answerShortDescription | True | string | |
|
Commentaires concernant la réponse
|
feedbackText | True | string |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Billet
|
ticket | Ticket |
Ouvrir un ticket (question)
Ouvrez un nouveau ticket sur l’instance connectée.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
E-mail utilisateur
|
userEmail | True | string | |
|
Question posée par l’utilisateur
|
queryText | True | string | |
|
Rubrique à laquelle cette question appartient probablement
|
topic | string |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Billet
|
ticket | Ticket |
Poser une question à COSMO Bot
Le bot effectue une recherche dans la base de connaissances et retourne la réponse avec la meilleure correspondance. Retourne également le score.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Question
|
question | True | string | |
|
Seuil de score
|
scoreThreshold | integer |
Score minimal d’une réponse à renvoyer. |
|
|
E-mail utilisateur
|
userEmail | string |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Réponse trouvée
|
foundAnswer | boolean |
Indique si COSMO Bot a trouvé une réponse correspondant à la question. |
|
Est Shadow-Answer
|
isSubAnswer | boolean |
Indique si la réponse retournée est une sous-réponse. |
|
Question traduite
|
isTranslated | boolean |
Indique si la question et la réponse retournée ont été traduites. |
|
Réponse
|
answer | Answer | |
|
Score
|
score | integer |
La confiance du bot est que la réponse retournée est correcte. |
Renommer une rubrique existante
Renommez une rubrique existante à partir de l’instance connectée.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Nom de la rubrique
|
name | True | string |
Nom de la rubrique existante à renommer. |
|
Nouveau nom de rubrique
|
newName | True | string |
Nom auquel la rubrique sera renommée. |
Supprimer un expert d’une rubrique
Le bot supprime un expert de la rubrique fournie. Si aucune rubrique n’est donnée, l’expert sera supprimé de toutes les rubriques.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
E-mail d’expert
|
expertEmail | True | string | |
|
Sujet
|
topic | string |
Supprimer un jeu de questions-réponses
Supprimez un jeu de réponses aux questions existant de l’instance connectée.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Brève description
|
shortDescription | True | string |
Traduire (markdown convivial)
Traduisez le texte donné tout en respectant la syntaxe Markdown du dialecte COSMO Bot.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Langue cible
|
targetLanguageCode | True | string |
Code de langue cible (exemple : fr). |
|
Texto
|
inputText | True | string |
Texte à traduire. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Texte traduit
|
outputText | string |
Déclencheurs
| Lorsqu’un jeu de réponses aux questions est créé ou modifié |
Lorsqu’un jeu de réponses aux questions est créé ou modifié. |
| Lorsqu’un nouveau jeu de réponses aux questions est créé |
Lorsqu’un nouveau jeu de réponses aux questions est créé. |
| Lorsqu’un nouveau ticket est créé |
Lorsqu’un ticket est créé. |
| Lorsqu’un ticket est résolu |
Lorsqu’un ticket existant est résolu. |
| Lorsqu’un utilisateur pose une question |
Lorsqu’un utilisateur pose une question. |
| Quand la rubrique d’un ticket est mise à jour |
Lorsqu’une rubrique d’un ticket existant est mise à jour. |
Lorsqu’un jeu de réponses aux questions est créé ou modifié
Lorsqu’un jeu de réponses aux questions est créé ou modifié.
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Réponse
|
answer | Answer |
Lorsqu’un nouveau jeu de réponses aux questions est créé
Lorsqu’un nouveau jeu de réponses aux questions est créé.
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Réponse
|
answer | Answer |
Lorsqu’un nouveau ticket est créé
Lorsqu’un ticket est créé.
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Billet
|
ticket | Ticket |
Lorsqu’un ticket est résolu
Lorsqu’un ticket existant est résolu.
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Billet
|
ticket | Ticket | |
|
E-mail de l’éditeur
|
editorEmail | string | |
|
Commentaire de l’éditeur
|
editorComment | string | |
|
Lien profond vers la requête d’origine
|
queryUrl | string |
Lorsqu’un utilisateur pose une question
Lorsqu’un utilisateur pose une question.
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
E-mail utilisateur
|
userEmail | string | |
|
Question posée par l’utilisateur
|
queryText | string | |
|
Réponse trouvée
|
foundAnswer | boolean |
Indique si COSMO Bot a trouvé une réponse correspondant à la question de l’utilisateur. |
|
Réponse
|
answer | Answer |
Quand la rubrique d’un ticket est mise à jour
Lorsqu’une rubrique d’un ticket existant est mise à jour.
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Billet
|
ticket | Ticket |
Définitions
Réponse
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Sujet
|
topic | string | |
|
Brève description
|
shortDescription | string | |
|
Questions
|
questions | array of string | |
|
Texte de la réponse
|
answerText | string | |
|
Date et heure de la dernière modification de cette réponse
|
modifiedAt | date-time | |
|
Modifié par
|
modifiedBy | string |
Billet
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Unique Ticket ID
|
ticketId | string | |
|
Sujet
|
topic | string | |
|
Lien profond pour traiter le ticket
|
ticketUrl | string | |
|
E-mail du demandeur
|
requesterEmail | string | |
|
E-mails d’experts
|
expertEmails | array of string | |
|
Question posée par l’utilisateur
|
queryText | string | |
|
Commentaires envoyés par l’utilisateur
|
feedbackText | string |
Cela est vide si ce ticket n’est pas de commentaires. |
|
Brève description de la réponse reçue par l’utilisateur après avoir posé sa question
|
answerShortDescription | string |
Cela est vide si ce ticket n’est pas de commentaires. |
|
Réponse que l’utilisateur a reçu après avoir posé sa question
|
answerText | string |
Cela est vide si ce ticket n’est pas de commentaires. |
|
Date et heure à laquelle le ticket a été créé
|
createdAt | date-time |