Bot cosmo (versão prévia)
O COSMO Bot aumenta o sucesso de seus negócios por meio de mais eficiência na vida cotidiana. Se você responder a uma pergunta padrão hoje, você está perdendo tempo. Em contato com seus clientes, essa geralmente é uma boa oportunidade para se conhecerem e estabelecerem um relacionamento. Mas internamente, de funcionário para funcionário, ou quando há simplesmente muito o que fazer, é um luxo que nem todos podem se permitir. Esse conector permite que você estenda a funcionalidade do bot e integre outros sistemas.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Suporte ao COSMO CONSULT |
| URL | https://de.cosmoconsult.com/service/support/ |
| support.west@cosmoconsult.com |
| Metadados do conector | |
|---|---|
| Publicador | COSMO CONSULT GmbH |
| Site | https://cosma.link/cc-bot |
| Política de privacidade | https://www.cosmoconsult.com/data-protection/ |
| Categorias | IA; Comunicação |
Pré-requisitos
Para usar esse conector, você precisa ter acesso administrativo a uma Instância de Bot do COSMO. O que é o Cosmo Bot?Como fazer para obter uma instância de Bot do COSMO?
Como obter credenciais?
Depois de ter acesso administrativo a uma Instância de Bot do COSMO, vá para a interface de chat (ou seja https://cosma.cosmoconsult.com/) e alterne para a guia "Administração" clicando em "Administração" no canto superior direito. Navegue até "Chaves de API" e crie uma nova ou copie uma existente.
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| URL da Instância do Bot | cadeia | A URL em que a instância do bot pode ser acessada | Verdade |
| Chave de API | secureString | A chave de API para acessar essa instância de bot | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Abrir um tíquete (comentários) |
Abra um novo tíquete de comentários de tipo na instância conectada. |
| Abrir um tíquete (pergunta) |
Abra um novo tíquete na instância conectada. |
| Adicionar um especialista a um tópico |
O bot adicionará o especialista ao tópico fornecido. |
| Adicionar um novo conjunto de perguntas e respostas |
Adiciona um novo conjunto de perguntas e respostas à instância conectada. |
| Adicionar um novo tópico |
Adiciona um novo tópico à instância conectada. |
| Converter script de bot do COSMO |
Execute o texto especificado por meio do analisador cosmo bot script. |
| Criar uma cópia de sombra de um conjunto de perguntas e respostas |
Adiciona uma nova cópia de sombra para o conjunto de perguntas e respostas especificado pela breve descrição. Cuidadoso! Essas cópias de sombra são excluídas quando a resposta é atualizada. Portanto, é recomendável chamar essa ação automaticamente usando o gatilho "quando um conjunto de perguntas e respostas é atualizado". |
| Editar um conjunto de perguntas e respostas existente |
Edite um conjunto de perguntas e respostas existente da instância conectada. |
| Excluir um conjunto de perguntas e respostas |
Exclua um conjunto de perguntas e respostas existente da instância conectada. |
| Faça uma pergunta ao Cosmo Bot |
O bot pesquisará a base de dados de conhecimento e retornará a resposta com a melhor correspondência. Também retorna a pontuação. |
| Fechar um tíquete |
Fecha um tíquete aberto na instância conectada. |
| Obter configurações globais |
Obtém as configurações globais da instância conectada. |
| Obter especialistas para um tópico |
Obtém todos os expoertes da instância conectada. |
| Obter ingressos abertos |
Obtém todos os tíquetes abertos da instância conectada. |
| Obter todos os conjuntos de perguntas e respostas |
Obtém todas as respostas da instância conectada. |
| Obter todos os tópicos |
Obtém todos os tópicos da instância do bot conectado. |
| Obter tópico |
Obtém um tópico específico da instância conectada. |
| Remover um especialista de um tópico |
O bot removerá um especialista do tópico fornecido. Se nenhum tópico for dado, o especialista será removido de todos os tópicos. |
| Renomear um tópico existente |
Renomeie um tópico existente da instância conectada. |
| Traduzir (markdown amigável) |
Traduza o texto especificado respeitando a sintaxe markdown do dialeto do COSMO Bot. |
Abrir um tíquete (comentários)
Abra um novo tíquete de comentários de tipo na instância conectada.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Email do Usuário
|
userEmail | True | string | |
|
Pergunta que foi feita pelo usuário
|
queryText | True | string | |
|
Breve descrição da resposta
|
answerShortDescription | True | string | |
|
Comentários sobre a resposta
|
feedbackText | True | string |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Bilhete
|
ticket | Ticket |
Abrir um tíquete (pergunta)
Abra um novo tíquete na instância conectada.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Email do Usuário
|
userEmail | True | string | |
|
Pergunta que foi feita pelo usuário
|
queryText | True | string | |
|
Tópico ao qual essa pergunta provavelmente pertence
|
topic | string |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Bilhete
|
ticket | Ticket |
Adicionar um especialista a um tópico
O bot adicionará o especialista ao tópico fornecido.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Tópico
|
topic | True | string | |
|
Email de especialista
|
expertEmail | True | string |
Adicionar um novo conjunto de perguntas e respostas
Adiciona um novo conjunto de perguntas e respostas à instância conectada.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Tópico
|
topic | True | string | |
|
Descrição breve
|
shortDescription | True | string | |
|
Perguntas
|
questions | True | array of string | |
|
Texto da Resposta
|
answerText | True | string | |
|
Email do Usuário
|
userEmail | string |
Adicionar um novo tópico
Adiciona um novo tópico à instância conectada.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome do Tópico
|
name | True | string | |
|
Description
|
description | True | string | |
|
Emails de especialistas
|
expertEmails | True | array of string |
Converter script de bot do COSMO
Execute o texto especificado por meio do analisador cosmo bot script.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Texto de entrada
|
inputText | True | string | |
|
Formato de saída
|
outputFormat | True | string |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Texto de saída
|
outputText | string |
O texto analisado retornado pelo Analisador de Scripts do Cosmo Bot. |
Criar uma cópia de sombra de um conjunto de perguntas e respostas
Adiciona uma nova cópia de sombra para o conjunto de perguntas e respostas especificado pela breve descrição. Cuidadoso! Essas cópias de sombra são excluídas quando a resposta é atualizada. Portanto, é recomendável chamar essa ação automaticamente usando o gatilho "quando um conjunto de perguntas e respostas é atualizado".
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Descrição curta da resposta original
|
shortDescription | True | string | |
|
Descrição Curta da Cópia de Sombra
|
subShortDescription | True | string | |
|
Perguntas
|
subQuestions | True | array of string | |
|
Texto da Resposta
|
subAnswerText | True | string |
Editar um conjunto de perguntas e respostas existente
Edite um conjunto de perguntas e respostas existente da instância conectada.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Descrição curta do conjunto existente
|
shortDescription | True | string | |
|
Tópico atualizado
|
newTopic | string | ||
|
Descrição curta atualizada
|
newShortDescription | string | ||
|
Perguntas atualizadas
|
newQuestions | array of string | ||
|
Texto de resposta atualizado
|
newAnswerText | string | ||
|
Email do Usuário
|
userEmail | string |
Excluir um conjunto de perguntas e respostas
Exclua um conjunto de perguntas e respostas existente da instância conectada.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Descrição breve
|
shortDescription | True | string |
Faça uma pergunta ao Cosmo Bot
O bot pesquisará a base de dados de conhecimento e retornará a resposta com a melhor correspondência. Também retorna a pontuação.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Pergunta
|
question | True | string | |
|
Limite de pontuação
|
scoreThreshold | integer |
Pontuação mínima de uma resposta para que ela seja retornada. |
|
|
Email do Usuário
|
userEmail | string |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Resposta encontrada
|
foundAnswer | boolean |
Se o COSMO Bot encontrou uma resposta que correspondeu à pergunta. |
|
É Shadow-Answer
|
isSubAnswer | boolean |
Se a resposta retornada é uma sub-resposta. |
|
Foi a pergunta traduzida
|
isTranslated | boolean |
Se a pergunta e a resposta retornada foram traduzidas. |
|
Resposta
|
answer | Answer | |
|
Score
|
score | integer |
Quão confiante é o bot de que a resposta retornada está correta. |
Fechar um tíquete
Fecha um tíquete aberto na instância conectada.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID exclusiva do tíquete
|
ticketId | True | string | |
|
Email do usuário que processou o tíquete
|
editorEmail | True | string | |
|
Comentário que será enviado ao usuário
|
editorComment | True | string |
Obter configurações globais
Obtém as configurações globais da instância conectada.
Retornos
Obter especialistas para um tópico
Obtém todos os expoertes da instância conectada.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Tópico
|
topic | True | string |
Tópico |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Especialistas
|
expertEmails | array of string |
Obter ingressos abertos
Obtém todos os tíquetes abertos da instância conectada.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Filtrar por Duração Aberta (mínimo)
|
filterByHoursSinceOpened | integer |
Só obtenha ingressos que estão abertos há mais de x horas. |
|
|
Filtrar por Duração Aberta (máximo)
|
filterByHoursSinceOpenedMax | integer |
Só obtenha ingressos abertos por menos de x horas. |
|
|
Filtrar por Tópico
|
filterByTopic | string |
Filtrar por Tópico |
|
|
Filtrar por especialista
|
filterByExpertEmail | string |
Filtrar por especialista |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Tíquetes
|
tickets | array of Ticket |
Obter todos os conjuntos de perguntas e respostas
Obtém todas as respostas da instância conectada.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Filtrar por Tópico (contém)
|
filterByTopic | string |
Filtrar por Tópico (contém) |
|
|
Filtrar por descrição curta (contém)
|
filterByShortDescription | string |
Filtrar por descrição curta (contém) |
|
|
Filtrar por Texto de Pergunta (contém)
|
filterByQuestionText | string |
Filtrar por Texto de Pergunta (contém) |
|
|
Filtrar por Texto de Resposta (contém)
|
filterByAnswerText | string |
Filtrar por Texto de Resposta (contém) |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Respostas
|
answers | array of Answer |
Obter todos os tópicos
Obtém todos os tópicos da instância do bot conectado.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Filtrar por especialista
|
filterByExpert | string |
Filtrar por especialista |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Tópicos
|
topics | array of string |
Obter tópico
Obtém um tópico específico da instância conectada.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome do Tópico
|
topicName | True | string |
Nome do Tópico |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Nome
|
topic.name | string | |
|
Description
|
topic.description | string |
Remover um especialista de um tópico
O bot removerá um especialista do tópico fornecido. Se nenhum tópico for dado, o especialista será removido de todos os tópicos.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Email de especialista
|
expertEmail | True | string | |
|
Tópico
|
topic | string |
Renomear um tópico existente
Renomeie um tópico existente da instância conectada.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome do Tópico
|
name | True | string |
O nome do tópico existente a ser renomeado. |
|
Novo Nome do Tópico
|
newName | True | string |
O nome para o qual o tópico será renomeado. |
Traduzir (markdown amigável)
Traduza o texto especificado respeitando a sintaxe markdown do dialeto do COSMO Bot.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Idioma de destino
|
targetLanguageCode | True | string |
O código da linguagem de destino (exemplo: fr). |
|
Texto
|
inputText | True | string |
O texto a ser traduzido. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Texto traduzido
|
outputText | string |
Gatilhos
| Quando o tópico de um tíquete é atualizado |
Quando um tópico de um Tíquete existente é atualizado. |
| Quando um conjunto de perguntas e respostas é criado ou modificado |
Quando um conjunto de perguntas e respostas é criado ou modificado. |
| Quando um novo conjunto de perguntas e respostas é criado |
Quando um novo conjunto de perguntas e respostas é criado. |
| Quando um novo tíquete é criado |
Quando um novo Tíquete é criado. |
| Quando um tíquete é resolvido |
Quando um Tíquete existente é resolvido. |
| Quando um usuário faz uma pergunta |
Quando um usuário faz uma pergunta. |
Quando o tópico de um tíquete é atualizado
Quando um tópico de um Tíquete existente é atualizado.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Bilhete
|
ticket | Ticket |
Quando um conjunto de perguntas e respostas é criado ou modificado
Quando um conjunto de perguntas e respostas é criado ou modificado.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Resposta
|
answer | Answer |
Quando um novo conjunto de perguntas e respostas é criado
Quando um novo conjunto de perguntas e respostas é criado.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Resposta
|
answer | Answer |
Quando um novo tíquete é criado
Quando um novo Tíquete é criado.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Bilhete
|
ticket | Ticket |
Quando um tíquete é resolvido
Quando um Tíquete existente é resolvido.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Bilhete
|
ticket | Ticket | |
|
Editor Email
|
editorEmail | string | |
|
Comentário do Editor
|
editorComment | string | |
|
Link profundo para a consulta original
|
queryUrl | string |
Quando um usuário faz uma pergunta
Quando um usuário faz uma pergunta.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Email do Usuário
|
userEmail | string | |
|
Pergunta que foi feita pelo usuário
|
queryText | string | |
|
Resposta encontrada
|
foundAnswer | boolean |
Se o COSMO Bot encontrou uma resposta que correspondeu à pergunta do usuário. |
|
Resposta
|
answer | Answer |
Definições
Resposta
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Tópico
|
topic | string | |
|
Descrição breve
|
shortDescription | string | |
|
Perguntas
|
questions | array of string | |
|
Texto da Resposta
|
answerText | string | |
|
Data e hora em que essa resposta foi modificada pela última vez em
|
modifiedAt | date-time | |
|
Modificado por
|
modifiedBy | string |
Bilhete
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID exclusiva do tíquete
|
ticketId | string | |
|
Tópico
|
topic | string | |
|
Link profundo para processar o tíquete
|
ticketUrl | string | |
|
Email do solicitante
|
requesterEmail | string | |
|
Emails de especialistas
|
expertEmails | array of string | |
|
Pergunta que foi feita pelo usuário
|
queryText | string | |
|
Comentários enviados pelo usuário
|
feedbackText | string |
Isso estará vazio se este tíquete não for comentários. |
|
Breve descrição da resposta que o usuário recebeu depois de fazer sua pergunta
|
answerShortDescription | string |
Isso estará vazio se este tíquete não for comentários. |
|
Responder que o usuário recebeu depois de fazer sua pergunta
|
answerText | string |
Isso estará vazio se este tíquete não for comentários. |
|
Data e hora em que o tíquete foi criado
|
createdAt | date-time |