COSMO-bot (preview)
Cosmo Bot verhoogt uw bedrijfsucces door meer efficiëntie in het dagelijks leven. Als u vandaag een standaardvraag beantwoordt, krijgt u tijd te verspillen. In contact met uw klanten is dit vaak een goede gelegenheid om elkaar te leren kennen en een relatie tot stand te brengen. Maar intern, van werknemer tot werknemer, of wanneer er simpelweg te veel te doen is, is het een luxe die niet iedereen zichzelf kan toestaan. Met deze connector kunt u de functionaliteit van de bot uitbreiden en andere systemen integreren.
Deze connector is beschikbaar in de volgende producten en regio's:
| Dienst | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Logic-apps | Standaard | Alle Logic Apps-regio's , met uitzondering van het volgende: - Azure Government-regio's - Azure China-regio's - Us Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Contactpersoon | |
|---|---|
| Naam | COSMO CONSULT-ondersteuning |
| URL | https://de.cosmoconsult.com/service/support/ |
| E-mailen | support.west@cosmoconsult.com |
| Connectormetagegevens | |
|---|---|
| Uitgever | COSMO CONSULT GmbH |
| Webpagina | https://cosma.link/cc-bot |
| Privacybeleid | https://www.cosmoconsult.com/data-protection/ |
| Categorieën | AI; Communicatie |
Vereiste voorwaarden
Als u deze connector wilt gebruiken, moet u beheerderstoegang hebben tot een COSMO Bot Instance. Wat is COSMO Bot?Hoe krijg ik een COSMO Bot-exemplaar?
Hoe kan ik referenties ophalen?
Zodra u beheerderstoegang hebt tot een COSMO Bot Instance, gaat u naar de chatinterface (dat wil https://cosma.cosmoconsult.com/bijvoorbeeld) en gaat u naar het tabblad Beheer door in de rechterbovenhoek op Beheer te klikken. Navigeer naar API-sleutels en maak een nieuwe of kopieer een bestaande sleutel.
Een verbinding maken
De connector ondersteunt de volgende verificatietypen:
| standaard | Parameters voor het maken van verbinding. | Alle regio's | Niet deelbaar |
Verstek
Van toepassing: Alle regio's
Parameters voor het maken van verbinding.
Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.
| Naam | Typologie | Description | Verplicht |
|---|---|---|---|
| URL van botexemplaren | touw | De URL waar uw bot-exemplaar kan worden bereikt | Klopt |
| API-sleutel | beveiligde string | De API-sleutel voor toegang tot dit botexemplaren | Klopt |
Beperkingslimieten
| Name | Aanroepen | Verlengingsperiode |
|---|---|---|
| API-aanroepen per verbinding | 100 | 60 seconden |
Acties
| Algemene instellingen ophalen |
Hiermee haalt u de algemene instellingen van het verbonden exemplaar op. |
| Alle onderwerpen ophalen |
Hiermee haalt u alle onderwerpen van het verbonden botexemplaren op. |
| Alle vragen-antwoordsets ophalen |
Haalt alle antwoorden op van het verbonden exemplaar. |
| Cosmo Bot een vraag stellen |
De bot doorzoekt de knowledgebase en retourneert het antwoord met de beste overeenkomst. Retourneert ook de score. |
| COSMO-botscript converteren |
Voer de opgegeven tekst uit via de COSMO Bot Script-parser. |
| De naam van een bestaand onderwerp wijzigen |
Wijzig de naam van een bestaand onderwerp van het verbonden exemplaar. |
| Een bestaande vraag-antwoordset bewerken |
Een bestaande vraag-antwoordset bewerken vanuit het verbonden exemplaar. |
| Een expert toevoegen aan een onderwerp |
De bot voegt de expert toe aan het opgegeven onderwerp. |
| Een expert uit een onderwerp verwijderen |
De bot verwijdert een expert uit het opgegeven onderwerp. Als er geen onderwerp wordt gegeven, wordt de expert uit alle onderwerpen verwijderd. |
| Een nieuw onderwerp toevoegen |
Hiermee voegt u een nieuw onderwerp toe aan het verbonden exemplaar. |
| Een nieuwe vraag-antwoordset toevoegen |
Hiermee voegt u een nieuwe vraag-antwoordset toe aan het verbonden exemplaar. |
| Een schaduwkopie van een vraag-antwoordset maken |
Voegt een nieuwe schaduwkopie toe voor de vraag-antwoordset die is opgegeven door de korte beschrijving. Voorzichtig! Deze schaduwkopieën worden verwijderd wanneer het antwoord wordt bijgewerkt. Het wordt daarom aanbevolen deze actie automatisch aan te roepen met behulp van de trigger 'wanneer een vraag-antwoordset wordt bijgewerkt'. |
| Een ticket openen (feedback) |
Open een nieuw ticket van het type feedback over het verbonden exemplaar. |
| Een ticket openen (vraag) |
Open een nieuw ticket op het verbonden exemplaar. |
| Een ticket sluiten |
Hiermee sluit u een geopend ticket op het verbonden exemplaar. |
| Een vraag-antwoordset verwijderen |
Verwijder een bestaande vraag-antwoordset uit het verbonden exemplaar. |
| Experts voor een onderwerp ophalen |
Hiermee haalt u alle expoertsies van het verbonden exemplaar op. |
| Onderwerp ophalen |
Hiermee haalt u een specifiek onderwerp op van het verbonden exemplaar. |
| Open tickets krijgen |
Hiermee worden alle geopende tickets opgehaald van het verbonden exemplaar. |
| Vertalen (markdown vriendelijk) |
Vertaal de opgegeven tekst terwijl u de Markdown-syntaxis van het COSMO Bot-dialect respecteert. |
Algemene instellingen ophalen
Hiermee haalt u de algemene instellingen van het verbonden exemplaar op.
Retouren
Alle onderwerpen ophalen
Hiermee haalt u alle onderwerpen van het verbonden botexemplaren op.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Filteren op expert
|
filterByExpert | string |
Filteren op expert |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Onderwerpen
|
topics | array of string |
Alle vragen-antwoordsets ophalen
Haalt alle antwoorden op van het verbonden exemplaar.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Filteren op onderwerp (bevat)
|
filterByTopic | string |
Filteren op onderwerp (bevat) |
|
|
Filteren op korte beschrijving (bevat)
|
filterByShortDescription | string |
Filteren op korte beschrijving (bevat) |
|
|
Filteren op vraagtekst (bevat)
|
filterByQuestionText | string |
Filteren op vraagtekst (bevat) |
|
|
Filteren op antwoordtekst (bevat)
|
filterByAnswerText | string |
Filteren op antwoordtekst (bevat) |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Answers
|
answers | array of Answer |
Cosmo Bot een vraag stellen
De bot doorzoekt de knowledgebase en retourneert het antwoord met de beste overeenkomst. Retourneert ook de score.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Question
|
question | True | string | |
|
Drempelwaarde voor score
|
scoreThreshold | integer |
Minimale score van een antwoord dat moet worden geretourneerd. |
|
|
E-mailadres van gebruiker
|
userEmail | string |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Antwoord gevonden
|
foundAnswer | boolean |
Of COSMO Bot een antwoord heeft gevonden dat overeenkomt met de vraag. |
|
Is Shadow-Answer
|
isSubAnswer | boolean |
Of het geretourneerde antwoord een subantwoord is. |
|
Is de vraag vertaald
|
isTranslated | boolean |
Of de vraag en het geretourneerde antwoord vertaald zijn. |
|
Antwoord
|
answer | Answer | |
|
Score
|
score | integer |
Hoe zeker de bot is dat het geretourneerde antwoord juist is. |
COSMO-botscript converteren
Voer de opgegeven tekst uit via de COSMO Bot Script-parser.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Invoertekst
|
inputText | True | string | |
|
Uitvoerindeling
|
outputFormat | True | string |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Uitvoertekst
|
outputText | string |
De geparseerde tekst die wordt geretourneerd door de COSMO Bot Script Parser. |
De naam van een bestaand onderwerp wijzigen
Wijzig de naam van een bestaand onderwerp van het verbonden exemplaar.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Onderwerpnaam
|
name | True | string |
De naam van het bestaande onderwerp waarvan de naam moet worden gewijzigd. |
|
Nieuwe onderwerpnaam
|
newName | True | string |
De naam waarnaar het onderwerp wordt gewijzigd. |
Een bestaande vraag-antwoordset bewerken
Een bestaande vraag-antwoordset bewerken vanuit het verbonden exemplaar.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Korte beschrijving van de bestaande set
|
shortDescription | True | string | |
|
Bijgewerkt onderwerp
|
newTopic | string | ||
|
Bijgewerkte korte beschrijving
|
newShortDescription | string | ||
|
Bijgewerkte vragen
|
newQuestions | array of string | ||
|
Bijgewerkte antwoordtekst
|
newAnswerText | string | ||
|
E-mailadres van gebruiker
|
userEmail | string |
Een expert toevoegen aan een onderwerp
De bot voegt de expert toe aan het opgegeven onderwerp.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Onderwerp
|
topic | True | string | |
|
E-mail van expert
|
expertEmail | True | string |
Een expert uit een onderwerp verwijderen
De bot verwijdert een expert uit het opgegeven onderwerp. Als er geen onderwerp wordt gegeven, wordt de expert uit alle onderwerpen verwijderd.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
E-mail van expert
|
expertEmail | True | string | |
|
Onderwerp
|
topic | string |
Een nieuw onderwerp toevoegen
Hiermee voegt u een nieuw onderwerp toe aan het verbonden exemplaar.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Onderwerpnaam
|
name | True | string | |
|
Description
|
description | True | string | |
|
E-mails van experts
|
expertEmails | True | array of string |
Een nieuwe vraag-antwoordset toevoegen
Hiermee voegt u een nieuwe vraag-antwoordset toe aan het verbonden exemplaar.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Onderwerp
|
topic | True | string | |
|
Korte beschrijving
|
shortDescription | True | string | |
|
Vragen
|
questions | True | array of string | |
|
Antwoordtekst
|
answerText | True | string | |
|
E-mailadres van gebruiker
|
userEmail | string |
Een schaduwkopie van een vraag-antwoordset maken
Voegt een nieuwe schaduwkopie toe voor de vraag-antwoordset die is opgegeven door de korte beschrijving. Voorzichtig! Deze schaduwkopieën worden verwijderd wanneer het antwoord wordt bijgewerkt. Het wordt daarom aanbevolen deze actie automatisch aan te roepen met behulp van de trigger 'wanneer een vraag-antwoordset wordt bijgewerkt'.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Korte beschrijving van oorspronkelijk antwoord
|
shortDescription | True | string | |
|
Korte beschrijving van Shadow Copy
|
subShortDescription | True | string | |
|
Vragen
|
subQuestions | True | array of string | |
|
Antwoordtekst
|
subAnswerText | True | string |
Een ticket openen (feedback)
Open een nieuw ticket van het type feedback over het verbonden exemplaar.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
E-mailadres van gebruiker
|
userEmail | True | string | |
|
Vraag die door de gebruiker is gesteld
|
queryText | True | string | |
|
Korte beschrijving van het antwoord
|
answerShortDescription | True | string | |
|
Feedback met betrekking tot het antwoord
|
feedbackText | True | string |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Kaartje
|
ticket | Ticket |
Een ticket openen (vraag)
Open een nieuw ticket op het verbonden exemplaar.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
E-mailadres van gebruiker
|
userEmail | True | string | |
|
Vraag die door de gebruiker is gesteld
|
queryText | True | string | |
|
Onderwerp waartoe deze vraag waarschijnlijk behoort
|
topic | string |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Kaartje
|
ticket | Ticket |
Een ticket sluiten
Hiermee sluit u een geopend ticket op het verbonden exemplaar.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Unieke ticket-id
|
ticketId | True | string | |
|
E-mail van de gebruiker die het ticket heeft verwerkt
|
editorEmail | True | string | |
|
Opmerking die naar de gebruiker wordt verzonden
|
editorComment | True | string |
Een vraag-antwoordset verwijderen
Verwijder een bestaande vraag-antwoordset uit het verbonden exemplaar.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Korte beschrijving
|
shortDescription | True | string |
Experts voor een onderwerp ophalen
Hiermee haalt u alle expoertsies van het verbonden exemplaar op.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Onderwerp
|
topic | True | string |
Onderwerp |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Experts
|
expertEmails | array of string |
Onderwerp ophalen
Hiermee haalt u een specifiek onderwerp op van het verbonden exemplaar.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Onderwerpnaam
|
topicName | True | string |
Onderwerpnaam |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Naam
|
topic.name | string | |
|
Description
|
topic.description | string |
Open tickets krijgen
Hiermee worden alle geopende tickets opgehaald van het verbonden exemplaar.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Filteren op open duur (minimaal)
|
filterByHoursSinceOpened | integer |
Ontvang alleen tickets die langer dan x uur geopend zijn. |
|
|
Filteren op open duur (maximum)
|
filterByHoursSinceOpenedMax | integer |
Ontvang alleen tickets die al minder dan x uur geopend zijn. |
|
|
Filteren op onderwerp
|
filterByTopic | string |
Filteren op onderwerp |
|
|
Filteren op expert
|
filterByExpertEmail | string |
Filteren op expert |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Kaartjes
|
tickets | array of Ticket |
Vertalen (markdown vriendelijk)
Vertaal de opgegeven tekst terwijl u de Markdown-syntaxis van het COSMO Bot-dialect respecteert.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Doeltaal
|
targetLanguageCode | True | string |
De doeltaalcode (bijvoorbeeld: fr). |
|
Tekst
|
inputText | True | string |
De te vertalen tekst. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Vertaalde tekst
|
outputText | string |
Triggers
| Wanneer een gebruiker een vraag stelt |
Wanneer een gebruiker een vraag stelt. |
| Wanneer een ticket is opgelost |
Wanneer een bestaand ticket is opgelost. |
| Wanneer een vraag-antwoordset wordt gemaakt of gewijzigd |
Wanneer een vraag-antwoordset wordt gemaakt of gewijzigd. |
| Wanneer er een nieuw ticket wordt gemaakt |
Wanneer er een nieuw ticket wordt gemaakt. |
| Wanneer er een nieuwe vraag-antwoordset wordt gemaakt |
Wanneer er een nieuwe vraag-antwoordset wordt gemaakt. |
| Wanneer het onderwerp van een ticket wordt bijgewerkt |
Wanneer een onderwerp van een bestaand ticket wordt bijgewerkt. |
Wanneer een gebruiker een vraag stelt
Wanneer een gebruiker een vraag stelt.
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
E-mailadres van gebruiker
|
userEmail | string | |
|
Vraag die door de gebruiker is gesteld
|
queryText | string | |
|
Antwoord gevonden
|
foundAnswer | boolean |
Of COSMO Bot een antwoord heeft gevonden dat overeenkomt met de vraag van de gebruiker. |
|
Antwoord
|
answer | Answer |
Wanneer een ticket is opgelost
Wanneer een bestaand ticket is opgelost.
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Kaartje
|
ticket | Ticket | |
|
E-mail van editor
|
editorEmail | string | |
|
Opmerking van editor
|
editorComment | string | |
|
Dieptekoppeling naar oorspronkelijke query
|
queryUrl | string |
Wanneer een vraag-antwoordset wordt gemaakt of gewijzigd
Wanneer een vraag-antwoordset wordt gemaakt of gewijzigd.
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Antwoord
|
answer | Answer |
Wanneer er een nieuw ticket wordt gemaakt
Wanneer er een nieuw ticket wordt gemaakt.
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Kaartje
|
ticket | Ticket |
Wanneer er een nieuwe vraag-antwoordset wordt gemaakt
Wanneer er een nieuwe vraag-antwoordset wordt gemaakt.
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Antwoord
|
answer | Answer |
Wanneer het onderwerp van een ticket wordt bijgewerkt
Wanneer een onderwerp van een bestaand ticket wordt bijgewerkt.
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Kaartje
|
ticket | Ticket |
Definities
Antwoord
| Name | Pad | Type | Description |
|---|---|---|---|
|
Onderwerp
|
topic | string | |
|
Korte beschrijving
|
shortDescription | string | |
|
Vragen
|
questions | array of string | |
|
Antwoordtekst
|
answerText | string | |
|
Datum en tijd waarop dit antwoord voor het laatst is gewijzigd op
|
modifiedAt | date-time | |
|
Gewijzigd door
|
modifiedBy | string |
Kaartje
| Name | Pad | Type | Description |
|---|---|---|---|
|
Unieke ticket-id
|
ticketId | string | |
|
Onderwerp
|
topic | string | |
|
Dieptekoppeling voor het verwerken van het ticket
|
ticketUrl | string | |
|
E-mail aanvrager
|
requesterEmail | string | |
|
E-mails van experts
|
expertEmails | array of string | |
|
Vraag die door de gebruiker is gesteld
|
queryText | string | |
|
Feedback die door de gebruiker is ingediend
|
feedbackText | string |
Dit is leeg als dit ticket geen feedback heeft. |
|
Korte beschrijving van het antwoord dat de gebruiker heeft ontvangen na het stellen van de vraag
|
answerShortDescription | string |
Dit is leeg als dit ticket geen feedback heeft. |
|
Antwoord dat de gebruiker heeft ontvangen na het stellen van de vraag
|
answerText | string |
Dit is leeg als dit ticket geen feedback heeft. |
|
Datum en tijd waarop het ticket is gemaakt op
|
createdAt | date-time |