Starmind (Pré-visualização)
O Starmind Connector permite uma integração perfeita com o mecanismo de conhecimento da Starmind, permitindo que os usuários acessem respostas verificadas e insights de especialistas em toda a organização. Ao conectar-se à Starmind, seus fluxos de trabalho e agentes podem recuperar de forma inteligente respostas a perguntas críticas para os negócios, revelar conhecimento especializado e simplificar os processos de tomada de decisão.
Este conector está disponível nos seguintes produtos e regiões:
| Serviço | Class | Regiões |
|---|---|---|
| Estúdio Copiloto | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicações Lógicas | Standard | Todas as regiões do Logic Apps , exceto as seguintes: - Regiões do Azure Government - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Aplicações Power | Premium | Todas as regiões do Power Apps , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Automatize o poder | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Os especialistas em suporte técnico da Starmind estão prontos para ouvir e ajudar |
| URL | https://starmind.atlassian.net/servicedesk/customer/portal/2 |
| product@starmind.com |
| Metadados do conector | |
|---|---|
| Editora | Starmind (inc) |
| Sítio Web | https://starmind.ai |
| Política de privacidade | https://www.starmind.ai/privacy-policy |
| Categorias | Produtividade; Colaboração |
Mente estelar
Desbloqueie a experiência certa exatamente quando precisar.
O mecanismo de conhecimento avançado da Starmind identifica especialistas dentro de sua organização e conecta você instantaneamente a seus insights, integrando perfeitamente a inteligência humana em seus fluxos de trabalho diários.
O Starmind Connector permite uma integração perfeita com o mecanismo de conhecimento da Starmind, permitindo que os usuários acessem respostas verificadas e se conectem com especialistas em toda a organização. Ao conectar-se à Starmind, os fluxos de trabalho do Power Automate ou os agentes do Copilot podem recuperar de forma inteligente respostas a perguntas críticas para os negócios, revelar conhecimento especializado e simplificar os processos de tomada de decisão.
Editora: Nome do editor
Mente estelar
Pré-requisitos
Para usar essa integração, você precisará de uma rede Starmind preparada para a integração. Por favor, solicite a configuração através do canal de suporte técnico Starmind. O conector pode ser usado com qualquer plano Starmind.
Operações suportadas
FindExperts
Encontra especialistas com base no conteúdo fornecido.
FindPerguntas
Localiza perguntas com base nos parâmetros de consulta fornecidos.
Pós-pergunta
Cria um novo rascunho de pergunta.
PublishPergunta
Publica rascunho de perguntas.
GetUserById
Recupera os dados do utilizador.
GetQuestion (Descontinuado)
Recupera os detalhes completos de uma pergunta, incluindo soluções, comentários e conceitos por sua ID.
ResolveUser (Descontinuado)
Resolve o objeto globalUserId to user. Forneça a consulta graphQL para recuperar o objeto de utilizador da seguinte forma:
query getUser($globalUserId: UUID!) {
user(globalUserId: $globalUserId) {
globalUserId
firstname
lastname
email
languageId
avatarUrl
company
department
position
location
about
countryId
created
dateDeleted
isFederated
}
}
Obtenção de credenciais
Para obter uma chave API para Starmind, você precisa entrar em contato com seu gerente de conta Starmind ou equipe de suporte através do nosso canal de suporte técnico
Problemas conhecidos e limitações
Este conector autentica-se exclusivamente através da chave API.
- O acesso é realizado através de uma conta de utilizador técnico.
- Não há suporte para autenticação OAuth no contexto do usuário conectado.
Perguntas Frequentes
O que é necessário para usar este conector com uma rede Starmind?
Para usar essa integração, você precisará de uma rede Starmind preparada para a integração. Por favor, solicite a configuração através do canal de suporte técnico Starmind.
Como posso obter uma nova chave de API?
Para obter uma chave API para Starmind, você precisa entrar em contato com seu gerente de conta Starmind ou equipe de suporte através do nosso canal de suporte técnico
Instruções de implantação
Utilize estas instruções para implementar este conector como um conector personalizado no Microsoft Power Automate.
A criar uma ligação
O conector suporta os seguintes tipos de autenticação:
| Predefinição | 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.
Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| A rede Starmind. Exemplo: yourcompany.starmind.com | cadeia (de caracteres) | Especifique a sua rede Starmind. Exemplo: yourcompany.starmind.com | Verdade |
| Chave de API fornecida pela Starmind | securestring | Insira a chave da API conforme fornecido pela Starmind | Verdade |
Limites de Limitação
| Nome | Chamadas | Período de Renovação |
|---|---|---|
| Chamadas de API por conexão | 100 | 60 segundos |
Ações
| Criar um rascunho de pergunta |
Cria um novo rascunho de pergunta. O rascunho ainda não é pesquisável ou respondido por outros. Após a criação, publique o rascunho (através do endpoint de publicação) para ativar a pesquisa de especialistas, tornar a pergunta descobrível e permitir que outros utilizadores respondam. Fornecer a descrição opcional ajuda os especialistas a compreender melhor a questão e aumenta as hipóteses de obter respostas de alta qualidade. |
| Encontrar perguntas |
Pesquisa perguntas usando opcionais |
| Encontre especialistas |
Encontra especialistas com base no text_query fornecido. A pesquisa utiliza o grafo de conhecimento para identificar utilizadores com conhecimentos e conhecimentos relevantes relacionados com a consulta. Forneça a linguagem opcional para especificar a linguagem preferida para filtragem de rótulos de conceitos. Isto não afeta a correspondência da pesquisa em si; Filtra apenas a especialização que mostramos dos utilizadores retornados, selecionando conceitos com base no rótulo primário na língua escolhida. Conceitos devolvidos são desduplicados quando múltiplos conceitos partilham o mesmo rótulo primário. |
| Obter usuário por id |
Recupera informações do utilizador com base no ID fornecido. |
| Publicar uma pergunta |
Publica um rascunho de perguntas. Publicar a pergunta desencadeia a pesquisa de especialistas, torna a pergunta descobrível e permite que outros utilizadores respondam. As perguntas são sempre publicadas anonimamente. |
Criar um rascunho de pergunta
Cria um novo rascunho de pergunta. O rascunho ainda não é pesquisável ou respondido por outros. Após a criação, publique o rascunho (através do endpoint de publicação) para ativar a pesquisa de especialistas, tornar a pergunta descobrível e permitir que outros utilizadores respondam. Fornecer a descrição opcional ajuda os especialistas a compreender melhor a questão e aumenta as hipóteses de obter respostas de alta qualidade.
Parâmetros
| Nome | Chave | Necessário | Tipo | Descrição |
|---|---|---|---|---|
|
categoria
|
category | integer |
O id opcional da categoria a atribuir o rascunho da pergunta |
|
|
title
|
title | True | string |
Título da pergunta, entre 4 e 100 caracteres por defeito. Dependendo da configuração da rede, o comprimento máximo do título pode ser limitado ou prolongado. |
|
descrição
|
description | string |
A descrição opcional da pergunta fornece contexto detalhado e informações sobre a questão. Dependendo da configuração da rede, a descrição pode ser imposta para não estar vazia. |
|
|
linguagem
|
language | string |
ISO 639-1 código de língua de duas letras (por exemplo, 'en') representando uma linguagem suportada. 'xx' pode ser usado para indicar uma língua desconhecida. |
|
|
knowledge_space
|
knowledge_space | integer |
O ID do espaço de conhecimento ao qual atribuir a pergunta |
Regressos
- Body
- Question
Encontrar perguntas
Pesquisa perguntas usando opcionais query, (por defeito 10), filter, e sort; devolve uma coleção paginada com a pergunta itemslimit . Por defeito, todas as perguntas publicadas são devolvidas, ordenadas pela sua última atividade (decrescente). Uma combinação de filtros, consultas de pesquisa e critérios de ordenação pode ser aplicada ao resultado.
Parâmetros
| Nome | Chave | Necessário | Tipo | Descrição |
|---|---|---|---|---|
|
Procurar perguntas
|
query | string |
A consulta de pesquisa de perguntas |
|
|
Número máximo de perguntas a devolver
|
limit | integer |
Limite o número de perguntas retornadas. O valor padrão é 10. |
|
|
Filtro predefinido para perguntas
|
filter | string |
Filtre a lista de perguntas usando um filtro predefinido. |
|
|
Critérios de classificação das perguntas
|
sort | string |
Especificar os critérios pelos quais o resultado é ordenado |
Regressos
| Nome | Percurso | Tipo | Descrição |
|---|---|---|---|
|
HREF
|
_links.self.href | string |
HREF |
|
HREF
|
_links.next.href | string |
HREF |
|
HREF
|
_links.last.href | string |
HREF |
|
items
|
items | array of Question |
Resultados paginados da pesquisa de perguntas. |
|
total
|
total | integer |
Número total de perguntas que correspondem ao pedido. |
Encontre especialistas
Encontra especialistas com base no text_query fornecido. A pesquisa utiliza o grafo de conhecimento para identificar utilizadores com conhecimentos e conhecimentos relevantes relacionados com a consulta. Forneça a linguagem opcional para especificar a linguagem preferida para filtragem de rótulos de conceitos. Isto não afeta a correspondência da pesquisa em si; Filtra apenas a especialização que mostramos dos utilizadores retornados, selecionando conceitos com base no rótulo primário na língua escolhida. Conceitos devolvidos são desduplicados quando múltiplos conceitos partilham o mesmo rótulo primário.
Parâmetros
| Nome | Chave | Necessário | Tipo | Descrição |
|---|---|---|---|---|
|
linguagem
|
language | string |
ISO 639-1 código de língua de duas letras (por exemplo, 'en') representando uma linguagem suportada. 'xx' pode ser usado para indicar uma língua desconhecida. |
|
|
text_query
|
text_query | True | string |
Texto principal de pesquisa para identificar especialistas. Pode ser uma pergunta, um resumo de um texto, um ou vários tópicos. |
Regressos
| Nome | Percurso | Tipo | Descrição |
|---|---|---|---|
|
especialistas
|
experts | array of object |
Lista de especialistas que correspondem à consulta de pesquisa. Pode ficar vazio se não forem encontrados especialistas. |
|
concept_scores
|
experts.concept_scores | ExpertConceptScores |
Conceitos de pesquisa especializados correspondem a pontuações. |
|
classificação
|
experts.score | float |
Pontuação de relevância indica quão bem o especialista corresponde à consulta |
|
utilizador
|
experts.user | UserV3 |
Objeto de utilizador contendo informação do utilizador. |
|
label_matches
|
label_matches | array of ConceptLabelMatch |
As etiquetas correspondentes para a consulta de pesquisa especializada. Pode ficar vazio se não houver etiquetas correspondentes. |
Obter usuário por id
Recupera informações do utilizador com base no ID fornecido.
Parâmetros
| Nome | Chave | Necessário | Tipo | Descrição |
|---|---|---|---|---|
|
O ID do usuário
|
id | True | string |
O identificador global único de utilizador (UUID) como parâmetro de caminho usado para referenciar o utilizador através da plataforma Starmind. |
Regressos
- Body
- GraphQLUserResponse
Publicar uma pergunta
Publica um rascunho de perguntas. Publicar a pergunta desencadeia a pesquisa de especialistas, torna a pergunta descobrível e permite que outros utilizadores respondam. As perguntas são sempre publicadas anonimamente.
Parâmetros
| Nome | Chave | Necessário | Tipo | Descrição |
|---|---|---|---|---|
|
ID da pergunta a publicar
|
questionId | True | integer |
O ID do rascunho da pergunta a ser publicado |
Regressos
| Nome | Percurso | Tipo | Descrição |
|---|---|---|---|
|
number_of_experts
|
number_of_experts | integer |
number_of_experts |
Definições
Question
| Nome | Percurso | Tipo | Descrição |
|---|---|---|---|
|
knowledge_space_id
|
knowledge_space_id | integer |
O espaço de conhecimento único a que a pergunta pertence. |
|
upvote_count
|
upvote_count | integer |
O número total de votos positivos que a pergunta recebeu. |
|
view_count
|
view_count | integer |
O número de vezes que a pergunta foi vista pelos utilizadores. |
|
Data de publicação
|
published | date-time |
Carimbo de data/hora indicando quando a pergunta foi publicada (aaaa-MM-ddTHH:mm:ss.fffZ) |
|
is_deleted
|
is_deleted | boolean |
Indica se a pergunta foi eliminada. As perguntas excluídas não são visíveis para os usuários, mas ainda podem ser acessadas pelos administradores. |
|
title
|
title | string |
O título da pergunta |
|
Data da última atividade
|
last_activity | date-time |
Carimbo de data/hora indicando a última atividade com a pergunta (aaaa-MM-ddTHH:mm:ss.fffZ) |
|
is_published
|
is_published | boolean |
A pergunta is_published sinalizador indica se a pergunta está publicada ou não. Uma solução publicada é visível para todos os usuários, enquanto uma solução não publicada está em estado de rascunho visível apenas para o autor. |
|
Data de criação
|
created | date-time |
Carimbo de data/hora indicando quando a pergunta foi criada (aaaa-MM-ddTHH:mm:ss.fffZ) |
|
descrição
|
description | string |
Descrição da pergunta fornecendo contexto detalhado e informações sobre a pergunta |
|
solution_count
|
solution_count | integer |
Este é o número de soluções que foram apresentadas para esta questão. |
|
Data de atualização do conteúdo
|
content_updated | date-time |
Carimbo de data/hora que indica quando o conteúdo ou os anexos da pergunta foram atualizados pela última vez (aaaa-MM-ddTHH:mm:ss.fffZ) |
|
id
|
id | integer |
A pergunta única id |
|
pergunta data atualizada
|
updated | date-time |
Última vez que o recurso foi atualizado no banco de dados. Esta data não reflete atualizações de conteúdo, mas qualquer atualização de quaisquer campos do registo. Use content_updated para obter informações sobre atualizações de conteúdo. |
|
linguagem
|
language | string |
A linguagem da pergunta |
ConceptLabelMatch
| Nome | Percurso | Tipo | Descrição |
|---|---|---|---|
|
concept_id
|
concept_id | string |
O conceito único id |
|
descrição
|
description | string |
A descrição do conceito |
|
is_flat
|
is_flat | boolean |
is_flat |
|
label_match
|
label_match | string |
O rótulo que correspondia ao conceito |
|
linguagem
|
language | string |
Linguagem de conceito |
|
ontology_id
|
ontology_id | string |
O id ontológico único ao qual o conceito pertence |
|
primary_label
|
primary_label | string |
Rótulo primário do conceito |
UserId
O identificador único de utilizador (UUID) é usado para referenciar um utilizador em toda a plataforma Starmind.
O identificador único de utilizador (UUID) é usado para referenciar um utilizador em toda a plataforma Starmind.
UserV3
Objeto de utilizador contendo informação do utilizador.
| Nome | Percurso | Tipo | Descrição |
|---|---|---|---|
|
Sobre
|
about | string |
Texto personalizado introduzido pelo utilizador para se descrever na secção 'Sobre Mim' |
|
avatar_url
|
avatar_url | string |
URL da imagem avatar do utilizador |
|
Companhia
|
company | string |
Companhia do utilizador |
|
country
|
country | string |
Código de país alfa-2 ISO 3166-1 (ex.: ch, us, de) do utilizador |
|
criado
|
created | date-time |
Carimbo temporal indicando quando o utilizador foi criado (yyyy-MM-ddTHH:mm:ss.fffZ) |
|
Suprimido
|
deleted | date-time |
Carimbo temporal que indica quando o utilizador foi eliminado (yyyy-MM-ddTHH:mm:ss.fffZ). Sem permissões de administrador, só o utilizador não eliminado será devolvido |
|
departamento
|
department | string |
Departamento do utilizador |
|
e-mail
|
E-mail do utilizador |
||
|
primeiro_nome
|
first_name | string |
Nome próprio do utilizador. |
|
first_seen
|
first_seen | date-time |
Carimbo temporal que indica quando o utilizador iniciou sessão pela primeira vez (yyyy-MM-ddTHH:mm:ss.fffZ) |
|
id
|
id | UserId |
O identificador único de utilizador (UUID) é usado para referenciar um utilizador em toda a plataforma Starmind. |
|
is_federated
|
is_federated | boolean |
Indica se o utilizador autentica usando credenciais locais (email/palavra-passe) em vez de um fornecedor SSO externo (SAML, OpenID Connect) |
|
is_technical
|
is_technical | boolean |
Indica se o utilizador é um utilizador da API técnica (conta não interativa/de máquina); quando verdade, o utilizador normalmente autentica-se via chave API |
|
linguagem
|
language | Language |
ISO 639-1 código de língua de duas letras (por exemplo, 'en') representando uma linguagem suportada. 'xx' pode ser usado para indicar uma língua desconhecida. |
|
sobrenome
|
last_name | string |
Apelido do utilizador. |
|
localização
|
location | string |
Localização do utilizador |
|
posição
|
position | string |
Companhia do utilizador |
Linguagem
ISO 639-1 código de língua de duas letras (por exemplo, 'en') representando uma linguagem suportada. 'xx' pode ser usado para indicar uma língua desconhecida.
ISO 639-1 código de língua de duas letras (por exemplo, 'en') representando uma linguagem suportada. 'xx' pode ser usado para indicar uma língua desconhecida.
PontuaçõesConceito Expert
Conceitos de pesquisa especializados correspondem a pontuações.
| Nome | Percurso | Tipo | Descrição |
|---|---|---|---|
|
concept_id
|
concept.concept_id | string |
concept_id |
|
encounter_count
|
concept.encounter_count | integer |
encounter_count |
|
is_excluded_from_suggestion
|
concept.is_excluded_from_suggestion | boolean |
is_excluded_from_suggestion |
|
is_flat
|
concept.is_flat | boolean |
is_flat |
|
labels_for_languages
|
concept.labels_for_languages | array of object |
Todas as etiquetas disponíveis para diferentes línguas |
|
descrição
|
concept.labels_for_languages.description | string |
descrição |
|
description_type
|
concept.labels_for_languages.description_type | string |
description_type |
|
linguagem
|
concept.labels_for_languages.language | Language |
ISO 639-1 código de língua de duas letras (por exemplo, 'en') representando uma linguagem suportada. 'xx' pode ser usado para indicar uma língua desconhecida. |
|
labels
|
concept.labels_for_languages.labels | array of string |
labels |
|
primary_label
|
concept.labels_for_languages.primary_label | string |
Rótulo principal da língua |
|
last_update
|
concept.last_update | date-time |
last_update |
|
ontology_id
|
concept.ontology_id | string |
ontology_id |
|
pais
|
concept.parents | array of uuid |
Os ids do conceito pai |
|
classificação
|
score | float |
classificação |
GraphQLUserResponse
| Nome | Percurso | Tipo | Descrição |
|---|---|---|---|
|
utilizador
|
data.user | UserV3 |
Objeto de utilizador contendo informação do utilizador. |
|
erros
|
errors | array of GraphQLError |
Array opcional de erros GraphQL; Presente apenas se ocorrerem erros |
GraphQLError
| Nome | Percurso | Tipo | Descrição |
|---|---|---|---|
|
código
|
extensions.code | string | |
|
localizações
|
locations | array of object | |
|
coluna
|
locations.column | integer | |
|
linha
|
locations.line | integer | |
|
mensagem
|
message | string | |
|
caminho
|
path | array of string |