COSMO Bot (versión preliminar)
COSMO Bot aumenta el éxito empresarial a través de una mayor eficiencia en la vida cotidiana. Si respondes a una pregunta estándar hoy, estás perdiendo tiempo. En contacto con sus clientes, esto suele ser una buena oportunidad para conocerse entre sí y establecer una relación. Pero internamente, de empleado a empleado, o cuando hay demasiado que hacer, es un lujo que no todos pueden permitirse. Este conector permite ampliar la funcionalidad del bot e integrar otros sistemas.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Compatibilidad con COSMO CONSULT |
| URL | https://de.cosmoconsult.com/service/support/ |
| Correo Electrónico | support.west@cosmoconsult.com |
| Metadatos del conector | |
|---|---|
| Publicador | COSMO CONSULT GmbH |
| Sitio web | https://cosma.link/cc-bot |
| Directiva de privacidad | https://www.cosmoconsult.com/data-protection/ |
| Categorías | IA; Comunicación |
Prerrequisitos
Para usar este conector, debe tener acceso administrativo a una instancia de BOT COSMO. ¿Qué es COSMO Bot?¿Cómo obtengo una instancia de COSMO Bot?
¿Cómo obtener credenciales?
Una vez que tenga acceso administrativo a una instancia de BOT DE COSMO, vaya a la interfaz de chat (es decir, https://cosma.cosmoconsult.com/) y cambie a la pestaña "Administración" haciendo clic en "Administración" en la esquina superior derecha. Vaya a "Claves de API" y cree uno o copie uno existente.
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Predeterminado | Parámetros para crear una conexión. | Todas las regiones | No se puede compartir |
Predeterminado
Aplicable: Todas las regiones
Parámetros para crear una conexión.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
| Nombre | Tipo | Description | Obligatorio |
|---|---|---|---|
| Dirección URL de la instancia de bot | cuerda / cadena | Dirección URL a la que se puede acceder a la instancia del bot | Cierto |
| Clave de API | securestring | Clave de API para acceder a esta instancia de bot | Cierto |
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Abrir un vale (comentarios) |
Abra un nuevo vale de comentarios de tipo en la instancia conectada. |
| Abrir un vale (pregunta) |
Abra un nuevo vale en la instancia conectada. |
| Adición de un nuevo conjunto de preguntas y respuestas |
Agrega un nuevo conjunto de preguntas y respuestas a la instancia conectada. |
| Agregar un experto a un tema |
El bot agregará el experto al tema proporcionado. |
| Agregar un nuevo tema |
Agrega un nuevo tema a la instancia conectada. |
| Cambiar el nombre de un tema existente |
Cambie el nombre de un tema existente de la instancia conectada. |
| Cerrar un vale |
Cierra un vale abierto en la instancia conectada. |
| Conversión de script de bot DE COSMO |
Ejecute el texto especificado a través del analizador de script de bot de COSMO. |
| Crear una instantánea de un conjunto de preguntas y respuestas |
Agrega una nueva instantánea para el conjunto de preguntas y respuestas especificado por la descripción breve. ¡Cuidadoso! Estas instantáneas se eliminan cuando se actualiza la respuesta. Por lo tanto, se recomienda llamar automáticamente a esta acción mediante el desencadenador "cuando se actualiza un conjunto de preguntas y respuestas". |
| Edición de un conjunto de preguntas y respuestas existentes |
Edite un conjunto de preguntas y respuestas existentes desde la instancia conectada. |
| Eliminación de un conjunto de preguntas y respuestas |
Elimine un conjunto de preguntas y respuestas existentes de la instancia conectada. |
| Eliminación de un experto de un tema |
El bot quitará a un experto del tema proporcionado. Si no se proporciona ningún tema, el experto se quitará de todos los temas. |
| Obtención de expertos para un tema |
Obtiene todos los expoerts de la instancia conectada. |
| Obtención de la configuración global |
Obtiene la configuración global de la instancia conectada. |
| Obtener entradas abiertas |
Obtiene todos los vales abiertos de la instancia conectada. |
| Obtener tema |
Obtiene un tema específico de la instancia conectada. |
| Obtener todos los conjuntos de preguntas y respuestas |
Obtiene todas las respuestas de la instancia conectada. |
| Obtener todos los temas |
Obtiene todos los temas de la instancia del bot conectado. |
| Preguntar a COSMO Bot una pregunta |
El bot buscará en la base de conocimiento y devolverá la respuesta con la mejor coincidencia. También devuelve la puntuación. |
| Traducción (fácil de markdown) |
Traduzca el texto especificado respetando la sintaxis markdown del dialecto COSMO Bot. |
Abrir un vale (comentarios)
Abra un nuevo vale de comentarios de tipo en la instancia conectada.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Email de usuario
|
userEmail | True | string | |
|
Pregunta que ha hecho el usuario
|
queryText | True | string | |
|
Descripción breve de la respuesta
|
answerShortDescription | True | string | |
|
Comentarios sobre la respuesta
|
feedbackText | True | string |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Boleto
|
ticket | Ticket |
Abrir un vale (pregunta)
Abra un nuevo vale en la instancia conectada.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Email de usuario
|
userEmail | True | string | |
|
Pregunta que ha hecho el usuario
|
queryText | True | string | |
|
Tema al que probablemente pertenece esta pregunta
|
topic | string |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Boleto
|
ticket | Ticket |
Adición de un nuevo conjunto de preguntas y respuestas
Agrega un nuevo conjunto de preguntas y respuestas a la instancia conectada.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Tema
|
topic | True | string | |
|
Descripción corta
|
shortDescription | True | string | |
|
Preguntas
|
questions | True | array of string | |
|
Texto de respuesta
|
answerText | True | string | |
|
Email de usuario
|
userEmail | string |
Agregar un experto a un tema
El bot agregará el experto al tema proporcionado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Tema
|
topic | True | string | |
|
Correo electrónico experto
|
expertEmail | True | string |
Agregar un nuevo tema
Agrega un nuevo tema a la instancia conectada.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre del tema
|
name | True | string | |
|
Description
|
description | True | string | |
|
Correos electrónicos expertos
|
expertEmails | True | array of string |
Cambiar el nombre de un tema existente
Cambie el nombre de un tema existente de la instancia conectada.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre del tema
|
name | True | string |
Nombre del tema existente al que se va a cambiar el nombre. |
|
Nuevo nombre de tema
|
newName | True | string |
Nombre al que se cambiará el nombre del tema. |
Cerrar un vale
Cierra un vale abierto en la instancia conectada.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de vale único
|
ticketId | True | string | |
|
Correo electrónico del usuario que procesó el vale
|
editorEmail | True | string | |
|
Comentario que se enviará al usuario
|
editorComment | True | string |
Conversión de script de bot DE COSMO
Ejecute el texto especificado a través del analizador de script de bot de COSMO.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Texto de entrada
|
inputText | True | string | |
|
Formato de salida
|
outputFormat | True | string |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Texto de salida
|
outputText | string |
Texto analizado devuelto por el analizador de script de BOT DE COSMO. |
Crear una instantánea de un conjunto de preguntas y respuestas
Agrega una nueva instantánea para el conjunto de preguntas y respuestas especificado por la descripción breve. ¡Cuidadoso! Estas instantáneas se eliminan cuando se actualiza la respuesta. Por lo tanto, se recomienda llamar automáticamente a esta acción mediante el desencadenador "cuando se actualiza un conjunto de preguntas y respuestas".
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Descripción breve de la respuesta original
|
shortDescription | True | string | |
|
Descripción breve de Shadow Copy
|
subShortDescription | True | string | |
|
Preguntas
|
subQuestions | True | array of string | |
|
Texto de respuesta
|
subAnswerText | True | string |
Edición de un conjunto de preguntas y respuestas existentes
Edite un conjunto de preguntas y respuestas existentes desde la instancia conectada.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Descripción breve del conjunto existente
|
shortDescription | True | string | |
|
Tema actualizado
|
newTopic | string | ||
|
Descripción breve actualizada
|
newShortDescription | string | ||
|
Preguntas actualizadas
|
newQuestions | array of string | ||
|
Texto de respuesta actualizado
|
newAnswerText | string | ||
|
Email de usuario
|
userEmail | string |
Eliminación de un conjunto de preguntas y respuestas
Elimine un conjunto de preguntas y respuestas existentes de la instancia conectada.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Descripción corta
|
shortDescription | True | string |
Eliminación de un experto de un tema
El bot quitará a un experto del tema proporcionado. Si no se proporciona ningún tema, el experto se quitará de todos los temas.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Correo electrónico experto
|
expertEmail | True | string | |
|
Tema
|
topic | string |
Obtención de expertos para un tema
Obtiene todos los expoerts de la instancia conectada.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Tema
|
topic | True | string |
Tema |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Expertos
|
expertEmails | array of string |
Obtención de la configuración global
Obtiene la configuración global de la instancia conectada.
Devoluciones
Obtener entradas abiertas
Obtiene todos los vales abiertos de la instancia conectada.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Filtrar por duración abierta (mínimo)
|
filterByHoursSinceOpened | integer |
Obtenga solo entradas abiertas durante más de x horas. |
|
|
Filtrar por duración abierta (máximo)
|
filterByHoursSinceOpenedMax | integer |
Obtenga solo entradas abiertas durante menos de x horas. |
|
|
Filtrar por tema
|
filterByTopic | string |
Filtrar por tema |
|
|
Filtrar por experto
|
filterByExpertEmail | string |
Filtrar por experto |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Entradas
|
tickets | array of Ticket |
Obtener tema
Obtiene un tema específico de la instancia conectada.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre del tema
|
topicName | True | string |
Nombre del tema |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Nombre
|
topic.name | string | |
|
Description
|
topic.description | string |
Obtener todos los conjuntos de preguntas y respuestas
Obtiene todas las respuestas de la instancia conectada.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Filtrar por tema (contiene)
|
filterByTopic | string |
Filtrar por tema (contiene) |
|
|
Filtrar por descripción corta (contiene)
|
filterByShortDescription | string |
Filtrar por descripción corta (contiene) |
|
|
Filtrar por texto de pregunta (contiene)
|
filterByQuestionText | string |
Filtrar por texto de pregunta (contiene) |
|
|
Filtrar por texto de respuesta (contiene)
|
filterByAnswerText | string |
Filtrar por texto de respuesta (contiene) |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Respuestas
|
answers | array of Answer |
Obtener todos los temas
Obtiene todos los temas de la instancia del bot conectado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Filtrar por experto
|
filterByExpert | string |
Filtrar por experto |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Temas
|
topics | array of string |
Preguntar a COSMO Bot una pregunta
El bot buscará en la base de conocimiento y devolverá la respuesta con la mejor coincidencia. También devuelve la puntuación.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Pregunta
|
question | True | string | |
|
Umbral de puntuación
|
scoreThreshold | integer |
Puntuación mínima de una respuesta para que se devuelva. |
|
|
Email de usuario
|
userEmail | string |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Respuesta encontrada
|
foundAnswer | boolean |
Si COSMO Bot encontró una respuesta que coincida con la pregunta. |
|
Es Shadow-Answer
|
isSubAnswer | boolean |
Si la respuesta devuelta es una respuesta secundaria. |
|
Se ha traducido la pregunta
|
isTranslated | boolean |
Si se ha traducido la pregunta y la respuesta devuelta. |
|
Respuesta
|
answer | Answer | |
|
Puntuación
|
score | integer |
La confianza del bot es que la respuesta devuelta es correcta. |
Traducción (fácil de markdown)
Traduzca el texto especificado respetando la sintaxis markdown del dialecto COSMO Bot.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Idioma de destino
|
targetLanguageCode | True | string |
Código de idioma de destino (ejemplo: fr). |
|
Mensaje de texto
|
inputText | True | string |
Texto que se va a traducir. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Texto traducido
|
outputText | string |
Desencadenadores
| Cuando se actualiza el tema de un vale |
Cuando se actualiza un tema de un vale existente. |
| Cuando se crea o modifica un conjunto de preguntas-respuestas |
Cuando se crea o modifica un conjunto de preguntas-respuestas. |
| Cuando se crea un nuevo conjunto de preguntas y respuestas |
Cuando se crea un nuevo conjunto de preguntas y respuestas. |
| Cuando se crea un nuevo vale |
Cuando se crea un nuevo vale. |
| Cuando se resuelve un vale |
Cuando se resuelve un vale existente. |
| Cuando un usuario realiza una pregunta |
Cuando un usuario realiza una pregunta. |
Cuando se actualiza el tema de un vale
Cuando se actualiza un tema de un vale existente.
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Boleto
|
ticket | Ticket |
Cuando se crea o modifica un conjunto de preguntas-respuestas
Cuando se crea o modifica un conjunto de preguntas-respuestas.
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Respuesta
|
answer | Answer |
Cuando se crea un nuevo conjunto de preguntas y respuestas
Cuando se crea un nuevo conjunto de preguntas y respuestas.
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Respuesta
|
answer | Answer |
Cuando se crea un nuevo vale
Cuando se crea un nuevo vale.
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Boleto
|
ticket | Ticket |
Cuando se resuelve un vale
Cuando se resuelve un vale existente.
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Boleto
|
ticket | Ticket | |
|
Correo electrónico del editor
|
editorEmail | string | |
|
Comentario del editor
|
editorComment | string | |
|
Vínculo profundo a la consulta original
|
queryUrl | string |
Cuando un usuario realiza una pregunta
Cuando un usuario realiza una pregunta.
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Email de usuario
|
userEmail | string | |
|
Pregunta que ha hecho el usuario
|
queryText | string | |
|
Respuesta encontrada
|
foundAnswer | boolean |
Si COSMO Bot encontró una respuesta que coincida con la pregunta del usuario. |
|
Respuesta
|
answer | Answer |
Definiciones
Respuesta
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Tema
|
topic | string | |
|
Descripción corta
|
shortDescription | string | |
|
Preguntas
|
questions | array of string | |
|
Texto de respuesta
|
answerText | string | |
|
Fecha y hora en que se modificó por última vez esta respuesta
|
modifiedAt | date-time | |
|
Modificado por
|
modifiedBy | string |
Boleto
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Identificador de vale único
|
ticketId | string | |
|
Tema
|
topic | string | |
|
Vínculo profundo para procesar el vale
|
ticketUrl | string | |
|
Correo electrónico del solicitante
|
requesterEmail | string | |
|
Correos electrónicos expertos
|
expertEmails | array of string | |
|
Pregunta que ha hecho el usuario
|
queryText | string | |
|
Comentarios enviados por el usuario
|
feedbackText | string |
Esto está vacío si este vale no es comentarios. |
|
Descripción breve de la respuesta que el usuario recibió después de formular su pregunta
|
answerShortDescription | string |
Esto está vacío si este vale no es comentarios. |
|
Respuesta que el usuario recibió después de formular su pregunta
|
answerText | string |
Esto está vacío si este vale no es comentarios. |
|
Fecha y hora en que se creó el vale
|
createdAt | date-time |