Partilhar via


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
Email 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 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.

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

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
email email

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