Starmind (versão prévia)
O Starmind Connector permite uma integração perfeita com o mecanismo de conhecimento do Starmind, permitindo que os usuários acessem respostas verificadas e insights de especialistas em sua organização. Ao se conectar ao Starmind, seus fluxos de trabalho e agentes podem recuperar de forma inteligente respostas a perguntas críticas aos negócios, conhecer especialistas e simplificar processos de tomada de decisão.
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 | Especialistas em suporte técnico do Starmind estão prontos para ouvir e ajudar |
| URL | https://starmind.atlassian.net/servicedesk/customer/portal/2 |
| product@starmind.com |
| Metadados do conector | |
|---|---|
| Publicador | Starmind (inc) |
| Website | https://starmind.ai |
| Política de privacidade | https://www.starmind.ai/privacy-policy |
| Categorias | Produtividade; Colaboração |
Starmind
Desbloqueie a experiência certa exatamente quando precisar.
O mecanismo de conhecimento avançado do Starmind identifica especialistas em sua organização e conecta você instantaneamente aos insights deles, 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 do Starmind, permitindo que os usuários acessem respostas verificadas e se conectem com especialistas em toda a organização. Ao se conectar ao Starmind, os fluxos de trabalho do Power Automate ou os agentes copilot podem recuperar de forma inteligente respostas a perguntas críticas aos negócios, conhecer especialistas e simplificar processos de tomada de decisão.
Publicador: Nome do Publicador
Starmind
Pré-requisitos
Para usar essa integração, você precisará de uma rede Starmind preparada para a integração. Solicite a configuração por meio do canal de suporte técnico do Starmind. O conector pode ser usado com qualquer plano starmind.
Operações com suporte
FindExperts
Localiza especialistas com base no conteúdo fornecido.
FindQuestions
Localiza perguntas com base nos parâmetros de consulta fornecidos.
PostQuestion
Cria um novo rascunho de pergunta.
PublishQuestion
Publica o rascunho de perguntas.
GetUserById
Recupera os detalhes do usuário.
GetQuestion (preterido)
Recupera os detalhes completos de uma pergunta, incluindo soluções, comentários e conceitos por sua ID.
ResolveUser (preterido)
Resolve o globalUserId para o objeto de usuário. Forneça a consulta graphQL para recuperar o objeto de usuário da seguinte maneira:
query getUser($globalUserId: UUID!) {
user(globalUserId: $globalUserId) {
globalUserId
firstname
lastname
email
languageId
avatarUrl
company
department
position
location
about
countryId
created
dateDeleted
isFederated
}
}
Obtendo credenciais
Para obter uma chave de API para o Starmind, entre em contato com o gerente de conta do Starmind ou com a equipe de suporte por meio do nosso canal de suporte técnico
Problemas e limitações conhecidos
Esse conector é autenticado exclusivamente por meio da chave de API.
- O acesso é executado por meio de uma conta de usuário técnica.
- Não há suporte para a autenticação OAuth no contexto do usuário conectado.
Perguntas frequentes
O que é necessário para usar esse conector com uma rede Starmind?
Para usar essa integração, você precisará de uma rede Starmind preparada para a integração. Solicite a configuração por meio do canal de suporte técnico do Starmind.
Como posso obter uma nova chave de API?
Para obter uma chave de API para o Starmind, entre em contato com o gerente de conta do Starmind ou com a equipe de suporte por meio do nosso canal de suporte técnico
Instruções de implantação
Use estas instruções para implantar esse conector como um conector personalizado no Microsoft Power Automate.
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 |
|---|---|---|---|
| A rede Starmind. Exemplo: yourcompany.starmind.com | cadeia | Especifique sua rede Starmind. Exemplo: yourcompany.starmind.com | Verdade |
| Chave de API, conforme fornecido pelo Starmind | secureString | Insira a chave de API conforme fornecido pelo Starmind | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à 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 responde por outras pessoas. Após a criação, publique o rascunho (por meio do ponto de extremidade de publicação) para disparar a pesquisa de especialistas, tornar a pergunta detectável e permitir que outros usuários respondam. Fornecer a descrição opcional ajuda os especialistas a entender melhor a pergunta e aumenta as chances de obter respostas de alta qualidade. |
| Encontrar perguntas |
Pesquisa perguntas usando opcional |
| Localizar especialistas |
Localiza especialistas com base no text_query fornecido. A pesquisa aproveita o grafo de conhecimento para identificar usuários com conhecimentos e conhecimentos relevantes relacionados à consulta. Forneça o idioma opcional para especificar o idioma preferencial para filtragem de rótulo de conceito. Isso não afeta a própria correspondência de pesquisa; ele filtra apenas quais conhecimentos mostramos de usuários retornados selecionando conceitos com base no rótulo primário no idioma escolhido. Os conceitos retornados são duplicados quando vários conceitos compartilham o mesmo rótulo primário. |
| Obter usuário por ID |
Recupera informações do usuário com base na ID de usuário fornecida. |
| Publicar uma pergunta |
Publica um rascunho de pergunta. A publicação da pergunta dispara a pesquisa de especialistas, torna a pergunta detectável e permite que outros usuários 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 responde por outras pessoas. Após a criação, publique o rascunho (por meio do ponto de extremidade de publicação) para disparar a pesquisa de especialistas, tornar a pergunta detectável e permitir que outros usuários respondam. Fornecer a descrição opcional ajuda os especialistas a entender melhor a pergunta e aumenta as chances de obter respostas de alta qualidade.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
categoria
|
category | integer |
A ID opcional da categoria à qual atribuir o rascunho de pergunta |
|
|
title
|
title | True | string |
Título da pergunta, entre 4 e 100 caracteres por padrão. Dependendo da configuração de rede, o comprimento máximo do título pode ser limitado ou estendido ainda mais. |
|
descrição
|
description | string |
A descrição da pergunta opcional fornecendo contexto detalhado e informações sobre a pergunta. Dependendo da configuração de rede, a descrição pode ser imposta como não vazia. |
|
|
linguagem
|
language | string |
Código de idioma de duas letras ISO 639-1 (por exemplo, 'en') que representa um idioma com suporte. 'xx' pode ser usado para indicar uma linguagem desconhecida. |
|
|
knowledge_space
|
knowledge_space | integer |
a ID do espaço de conhecimento ao qual atribuir a pergunta |
Retornos
- Corpo
- Question
Encontrar perguntas
Pesquisa perguntas usando opcional query, limit (padrão 10) filtere sort; retorna uma coleção paginada com pergunta items. Por padrão, todas as perguntas publicadas são retornadas, ordenadas pela ú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 | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Pesquisar perguntas na consulta
|
query | string |
A consulta de pesquisa de perguntas |
|
|
Número máximo de perguntas a serem retornadas
|
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 para perguntas
|
sort | string |
Especifique os critérios pelos quais o resultado é classificado |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
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 correspondentes à solicitação. |
Localizar especialistas
Localiza especialistas com base no text_query fornecido. A pesquisa aproveita o grafo de conhecimento para identificar usuários com conhecimentos e conhecimentos relevantes relacionados à consulta. Forneça o idioma opcional para especificar o idioma preferencial para filtragem de rótulo de conceito. Isso não afeta a própria correspondência de pesquisa; ele filtra apenas quais conhecimentos mostramos de usuários retornados selecionando conceitos com base no rótulo primário no idioma escolhido. Os conceitos retornados são duplicados quando vários conceitos compartilham o mesmo rótulo primário.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
linguagem
|
language | string |
Código de idioma de duas letras ISO 639-1 (por exemplo, 'en') que representa um idioma com suporte. 'xx' pode ser usado para indicar uma linguagem desconhecida. |
|
|
text_query
|
text_query | True | string |
Texto de pesquisa primário para identificar especialistas. Pode ser uma pergunta, um resumo de um texto, um ou vários tópicos. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
peritos
|
experts | array of object |
Lista de especialistas que correspondem à consulta de pesquisa. Pode estar vazio se nenhum especialista for encontrado. |
|
concept_scores
|
experts.concept_scores | ExpertConceptScores |
Correspondências de conceito de pesquisa de especialistas, incluindo pontuações. |
|
pontuação
|
experts.score | float |
Pontuação de relevância que indica o quão bem o especialista corresponde à consulta |
|
usuário
|
experts.user | UserV3 |
Objeto de usuário que contém informações do usuário. |
|
label_matches
|
label_matches | array of ConceptLabelMatch |
Os rótulos correspondentes para a consulta de pesquisa de especialistas. Pode estar vazio se nenhum rótulo corresponder. |
Obter usuário por ID
Recupera informações do usuário com base na ID de usuário fornecida.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
A ID do usuário
|
id | True | string |
O UUID (identificador de usuário global) exclusivo como parâmetro de caminho usado para fazer referência ao usuário na plataforma Starmind. |
Retornos
- Corpo
- GraphQLUserResponse
Publicar uma pergunta
Publica um rascunho de pergunta. A publicação da pergunta dispara a pesquisa de especialistas, torna a pergunta detectável e permite que outros usuários respondam. As perguntas são sempre publicadas anonimamente.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da pergunta a ser publicada
|
questionId | True | integer |
A ID do rascunho de pergunta a ser publicado |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
number_of_experts
|
number_of_experts | integer |
number_of_experts |
Definições
Pergunta
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
knowledge_space_id
|
knowledge_space_id | integer |
A ID de espaço de conhecimento exclusiva à qual a pergunta pertence. |
|
upvote_count
|
upvote_count | integer |
O número total de upvotes recebidos pela pergunta. |
|
view_count
|
view_count | integer |
O número de vezes que a pergunta foi exibida pelos usuários. |
|
Data da publicação
|
published | date-time |
Carimbo de data/hora que indica quando a pergunta foi publicada (yyyyy-MM-ddTHH:mm:ss.fffZ) |
|
is_deleted
|
is_deleted | boolean |
Indica se a pergunta é excluída. 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 que indica a última atividade com a pergunta (yyyy-MM-ddTHH:mm:ss.fffZ) |
|
is_published
|
is_published | boolean |
A questão is_published sinalizador indica se a pergunta foi 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 da criação
|
created | date-time |
Carimbo de data/hora que indica quando a pergunta foi criada (yyyyy-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 |
Esse é o número de soluções que foram fornecidas para essa questão. |
|
Data atualizada 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 (yyyy-MM-ddTHH:mm:ss.fffZ) |
|
id
|
id | integer |
A ID de pergunta exclusiva |
|
data atualizada da pergunta
|
updated | date-time |
Última vez que o recurso foi atualizado no BD. Essa data não reflete atualizações de conteúdo, mas qualquer atualização para quaisquer campos do registro. Use content_updated para obter informações sobre atualizações de conteúdo. |
|
linguagem
|
language | string |
A linguagem de pergunta |
ConceptLabelMatch
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
concept_id
|
concept_id | string |
A ID de conceito exclusiva |
|
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 correspondeu ao conceito |
|
linguagem
|
language | string |
Linguagem conceitual |
|
ontology_id
|
ontology_id | string |
A ID de ontologia exclusiva à qual o conceito pertence |
|
primary_label
|
primary_label | string |
Rótulo primário de conceito |
UserId
O UUID (identificador de usuário exclusivo) usado para fazer referência a um usuário na plataforma Starmind.
O UUID (identificador de usuário exclusivo) usado para fazer referência a um usuário na plataforma Starmind.
UserV3
Objeto de usuário que contém informações do usuário.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Sobre
|
about | string |
Texto personalizado inserido pelo usuário para se descrever na seção 'Sobre mim' |
|
avatar_url
|
avatar_url | string |
URL para a imagem de avatar do usuário |
|
empresa
|
company | string |
Empresa do usuário |
|
country
|
country | string |
Código de país alfa-2 iso 3166-1 (por exemplo, ch, us, de) do usuário |
|
criadas
|
created | date-time |
Carimbo de data/hora que indica quando o usuário foi criado (yyyyy-MM-ddTHH:mm:ss.fffZ) |
|
excluído
|
deleted | date-time |
Carimbo de data/hora que indica quando o usuário foi excluído (yyy-MM-ddTHH:mm:ss.fffZ). Sem permissões de administrador, somente usuário não excluído será retornado |
|
departamento
|
department | string |
Departamento do usuário |
|
email
|
E-mail do usuário |
||
|
primeiro_nome
|
first_name | string |
Nome do usuário. |
|
first_seen
|
first_seen | date-time |
Carimbo de data/hora indicando quando o usuário fez logon na primeira vez (yyyy-MM-ddTHH:mm:ss.fffZ) |
|
id
|
id | UserId |
O UUID (identificador de usuário exclusivo) usado para fazer referência a um usuário na plataforma Starmind. |
|
is_federated
|
is_federated | boolean |
Indica se o usuário se autentica usando credenciais locais (email/senha) em vez de um provedor de SSO externo (SAML, OpenID Connect) |
|
is_technical
|
is_technical | boolean |
Indica se o usuário é um usuário de API técnica (conta não interativa/de computador); quando true o usuário normalmente se autentica por meio da chave de API |
|
linguagem
|
language | Language |
Código de idioma de duas letras ISO 639-1 (por exemplo, 'en') que representa um idioma com suporte. 'xx' pode ser usado para indicar uma linguagem desconhecida. |
|
sobrenome
|
last_name | string |
Sobrenome do usuário. |
|
local
|
location | string |
Localização do usuário |
|
posição
|
position | string |
Empresa do usuário |
Linguagem
Código de idioma de duas letras ISO 639-1 (por exemplo, 'en') que representa um idioma com suporte. 'xx' pode ser usado para indicar uma linguagem desconhecida.
Código de idioma de duas letras ISO 639-1 (por exemplo, 'en') que representa um idioma com suporte. 'xx' pode ser usado para indicar uma linguagem desconhecida.
ExpertConceptScores
Correspondências de conceito de pesquisa de especialistas, incluindo pontuações.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
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 |
Todos os rótulos disponíveis para idiomas diferentes |
|
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 |
Código de idioma de duas letras ISO 639-1 (por exemplo, 'en') que representa um idioma com suporte. 'xx' pode ser usado para indicar uma linguagem desconhecida. |
|
labels
|
concept.labels_for_languages.labels | array of string |
labels |
|
primary_label
|
concept.labels_for_languages.primary_label | string |
Rótulo principal para o idioma |
|
last_update
|
concept.last_update | date-time |
last_update |
|
ontology_id
|
concept.ontology_id | string |
ontology_id |
|
pais
|
concept.parents | array of uuid |
As IDs de conceito pai |
|
pontuação
|
score | float |
pontuação |
GraphQLUserResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
usuário
|
data.user | UserV3 |
Objeto de usuário que contém informações do usuário. |
|
Erros
|
errors | array of GraphQLError |
Matriz opcional de erros do GraphQL; só estará presente se ocorreram erros |
GraphQLError
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
codificar
|
extensions.code | string | |
|
Locais
|
locations | array of object | |
|
column
|
locations.column | integer | |
|
linha
|
locations.line | integer | |
|
mensagem
|
message | string | |
|
caminho
|
path | array of string |