Partager via


Starmind (préversion)

Le connecteur Starmind permet une intégration transparente avec le moteur de connaissances de Starmind, ce qui permet aux utilisateurs d’accéder aux réponses vérifiées et aux insights d’experts au sein de leur organisation. En vous connectant à Starmind, vos flux de travail et vos agents peuvent récupérer intelligemment des réponses à des questions critiques pour l’entreprise, exposer des connaissances d’experts et rationaliser les processus décisionnels.

Ce connecteur est disponible dans les produits et régions suivants :

Service classe Régions
Copilot Studio Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Applications logiques Norme Toutes les régions Logic Apps , à l’exception des suivantes :
     - Régions Azure Government
     - Régions Azure Chine
     - Us Department of Defense (DoD)
Power Apps Premium Toutes les régions Power Apps , à l’exception des suivantes :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Power Automate Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Contact
Nom Les experts du support technique Starmind sont prêts à écouter et à aider
URL https://starmind.atlassian.net/servicedesk/customer/portal/2
Messagerie électronique product@starmind.com
Métadonnées du connecteur
Éditeur Starmind (inc)
Website https://starmind.ai
Politique de confidentialité https://www.starmind.ai/privacy-policy
Catégories Productivité; Collaboration

Starmind

Déverrouillez la bonne expertise exactement quand vous en avez besoin.
Le moteur de connaissances avancé de Starmind identifie des experts au sein de votre organisation et vous connecte instantanément à leurs insights, en intégrant en toute transparence l’intelligence humaine dans vos workflows quotidiens.

Le connecteur Starmind permet une intégration transparente avec le moteur de connaissances de Starmind, ce qui permet aux utilisateurs d’accéder à des réponses vérifiées et de se connecter à des experts au sein de leur organisation. En vous connectant à Starmind, aux flux de travail Power Automate ou aux agents Copilot, vous pouvez récupérer intelligemment des réponses aux questions critiques pour l’entreprise, exposer des connaissances d’experts et rationaliser les processus décisionnels.

Éditeur : Nom du serveur de publication

Starmind

Prerequisites

Pour utiliser cette intégration, vous aurez besoin d’un réseau Starmind préparé pour l’intégration. Demandez l’installation via le canal de support technique Starmind. Le connecteur peut être utilisé avec n’importe quel plan Starmind.

Opérations prises en charge

FindExperts

Recherche des experts en fonction du contenu fourni.

FindQuestions

Recherche des questions basées sur les paramètres de requête fournis.

PostQuestion

Crée un brouillon de question.

PublishQuestion

Publie le brouillon des questions.

GetUserById

Récupère les détails de l’utilisateur.

GetQuestion (déconseillé)

Récupère les détails complets d’une question, y compris les solutions, les commentaires et les concepts par son ID.

ResolveUser (déconseillé)

Résout le globalUserId en objet utilisateur. Fournissez la requête graphQL pour récupérer l’objet utilisateur comme suit :

query getUser($globalUserId: UUID!) {
  user(globalUserId: $globalUserId) {
    globalUserId
    firstname
    lastname
    email
    languageId
    avatarUrl
    company
    department
    position
    location
    about
    countryId
    created
    dateDeleted
    isFederated
  }
}

Obtention des informations d’identification

Pour obtenir une clé API pour Starmind, vous devez contacter votre responsable de compte Starmind ou votre équipe de support technique via notre canal de support technique

Problèmes connus et limitations

Ce connecteur s’authentifie exclusivement via la clé API.

  • L’accès est effectué via un compte d’utilisateur technique.
  • L’authentification OAuth dans le contexte de l’utilisateur connecté n’est pas prise en charge.

Questions fréquentes

Qu’est-ce qui est nécessaire pour utiliser ce connecteur avec un réseau Starmind ?

Pour utiliser cette intégration, vous aurez besoin d’un réseau Starmind préparé pour l’intégration. Demandez l’installation via le canal de support technique Starmind.

Comment puis-je obtenir une nouvelle clé API ?

Pour obtenir une clé API pour Starmind, vous devez contacter votre responsable de compte Starmind ou votre équipe de support technique via notre canal de support technique

Instructions de déploiement

Utilisez ces instructions pour déployer ce connecteur en tant que connecteur personnalisé dans Microsoft Power Automate.

Création d’une connexion

Le connecteur prend en charge les types d’authentification suivants :

Par défaut Paramètres de création de connexion. Toutes les régions Non partageable

Faire défaut

Applicable : Toutes les régions

Paramètres de création de connexion.

Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.

Nom Type Descriptif Obligatoire
Le réseau Starmind. Exemple : yourcompany.starmind.com ficelle Spécifiez votre réseau Starmind. Exemple : yourcompany.starmind.com Vrai
Clé API fournie par Starmind securestring Entrez la clé API fournie par Starmind Vrai

Limitations

Nom Appels Période de renouvellement
Appels d’API par connexion 100 60 secondes

Actions

Créer un brouillon de questions

Crée un brouillon de question. Le brouillon n’est pas encore accessible à la recherche ou répondable par d’autres. Après la création, publiez le brouillon (via le point de terminaison de publication) pour déclencher la recherche d’experts, rendre la question détectable et autoriser d’autres utilisateurs à y répondre. Fournir la description facultative aide les experts à mieux comprendre la question et augmente les chances d’obtenir des réponses de haute qualité.

Obtenir l’utilisateur par ID

Récupère les informations utilisateur en fonction de l’ID d’utilisateur fourni.

Publier une question

Publie un brouillon de question. La publication de la question déclenche la recherche d’experts, rend la question détectable et permet à d’autres utilisateurs de y répondre. Les questions sont toujours publiées anonymement.

Rechercher des experts

Trouve des experts basés sur le text_query fourni. La recherche tire parti du graphe de connaissances pour identifier les utilisateurs disposant d’une expertise et d’une connaissance pertinentes liées à la requête. Indiquez la langue facultative pour spécifier la langue préférée pour le filtrage des étiquettes de concept. Cela n’affecte pas la recherche elle-même ; il filtre uniquement l’expertise que nous affichons des utilisateurs retournés en sélectionnant des concepts basés sur l’étiquette principale dans la langue choisie. Les concepts retournés sont dédupliqués lorsque plusieurs concepts partagent la même étiquette principale.

Rechercher des questions

Recherche des questions à l’aide de questions facultatives query( limit par défaut 10), filteret sortretourne une collection paginé avec une question items. Par défaut, toutes les questions publiées sont retournées, classées par leur dernière activité (décroissante). Une combinaison de filtres, de requêtes de recherche et de critères de classement peut être appliquée au résultat.

Créer un brouillon de questions

Crée un brouillon de question. Le brouillon n’est pas encore accessible à la recherche ou répondable par d’autres. Après la création, publiez le brouillon (via le point de terminaison de publication) pour déclencher la recherche d’experts, rendre la question détectable et autoriser d’autres utilisateurs à y répondre. Fournir la description facultative aide les experts à mieux comprendre la question et augmente les chances d’obtenir des réponses de haute qualité.

Paramètres

Nom Clé Obligatoire Type Description
catégorie
category integer

ID facultatif de la catégorie à affecter au brouillon de question

title
title True string

Titre de la question, Entre 4 et 100 caractères par défaut. Selon la configuration réseau, la longueur maximale du titre peut être limitée ou étendue ultérieurement.

descriptif
description string

Description facultative de la question fournissant un contexte détaillé et des informations sur la question. Selon la configuration réseau, la description peut être appliquée pour être non vide.

language
language string

Code de langue à deux lettres ISO 639-1 (par exemple, « en ») représentant une langue prise en charge. 'xx' peut être utilisé pour indiquer une langue inconnue.

knowledge_space
knowledge_space integer

id de l’espace de connaissances à attribuer à la question

Retours

Corps
Question

Obtenir l’utilisateur par ID

Récupère les informations utilisateur en fonction de l’ID d’utilisateur fourni.

Paramètres

Nom Clé Obligatoire Type Description
ID de l’utilisateur
id True string

Identificateur d’utilisateur global unique (UUID) en tant que paramètre de chemin utilisé pour référencer l’utilisateur sur la plateforme Starmind.

Retours

Publier une question

Publie un brouillon de question. La publication de la question déclenche la recherche d’experts, rend la question détectable et permet à d’autres utilisateurs de y répondre. Les questions sont toujours publiées anonymement.

Paramètres

Nom Clé Obligatoire Type Description
ID de la question à publier
questionId True integer

ID du brouillon de question à publier

Retours

Nom Chemin d’accès Type Description
number_of_experts
number_of_experts integer

number_of_experts

Rechercher des experts

Trouve des experts basés sur le text_query fourni. La recherche tire parti du graphe de connaissances pour identifier les utilisateurs disposant d’une expertise et d’une connaissance pertinentes liées à la requête. Indiquez la langue facultative pour spécifier la langue préférée pour le filtrage des étiquettes de concept. Cela n’affecte pas la recherche elle-même ; il filtre uniquement l’expertise que nous affichons des utilisateurs retournés en sélectionnant des concepts basés sur l’étiquette principale dans la langue choisie. Les concepts retournés sont dédupliqués lorsque plusieurs concepts partagent la même étiquette principale.

Paramètres

Nom Clé Obligatoire Type Description
language
language string

Code de langue à deux lettres ISO 639-1 (par exemple, « en ») représentant une langue prise en charge. 'xx' peut être utilisé pour indiquer une langue inconnue.

text_query
text_query True string

Texte de recherche principal pour identifier les experts. Il peut s’agir d’une question, d’un résumé d’un texte, d’une ou de plusieurs rubriques.

Retours

Nom Chemin d’accès Type Description
Experts
experts array of object

Liste d’experts correspondant à la requête de recherche. Peut être vide si aucun expert n’est trouvé.

concept_scores
experts.concept_scores ExpertConceptScores

Le concept de recherche d’experts correspond à des scores compris.

score
experts.score float

Score de pertinence indiquant comment l’expert correspond à la requête

utilisateur
experts.user UserV3

Objet utilisateur contenant des informations utilisateur.

label_matches
label_matches array of ConceptLabelMatch

Étiquettes correspondantes pour la requête de recherche d’experts. Peut être vide si aucune étiquette ne correspond.

Rechercher des questions

Recherche des questions à l’aide de questions facultatives query( limit par défaut 10), filteret sortretourne une collection paginé avec une question items. Par défaut, toutes les questions publiées sont retournées, classées par leur dernière activité (décroissante). Une combinaison de filtres, de requêtes de recherche et de critères de classement peut être appliquée au résultat.

Paramètres

Nom Clé Obligatoire Type Description
Rechercher des questions
query string

Requête de recherche de questions

Nombre maximal de questions à retourner
limit integer

Limitez le nombre de questions retournées. La valeur par défaut est 10.

Filtre prédéfini pour les questions
filter string

Filtrez la liste des questions à l’aide d’un filtre prédéfini.

Critères de tri pour les questions
sort string

Spécifier les critères dont le résultat est trié par

Retours

Nom Chemin d’accès Type Description
href
_links.self.href string

href

href
_links.next.href string

href

href
_links.last.href string

href

items
items array of Question

Résultats paginés de la recherche de questions.

total
total integer

Nombre total de questions correspondant à la demande.

Définitions

Question

Nom Chemin d’accès Type Description
knowledge_space_id
knowledge_space_id integer

ID d’espace de connaissances unique auquel appartient la question.

upvote_count
upvote_count integer

Nombre total d’appel à la question.

view_count
view_count integer

Nombre de fois où la question a été consultée par les utilisateurs.

Date de publication
published date-time

Horodatage indiquant quand la question a été publiée (aaaa-MM-ddTHH :mm :ss.fffZ)

is_deleted
is_deleted boolean

Indique si la question est supprimée. Les questions supprimées ne sont pas visibles pour les utilisateurs, mais sont toujours accessibles par les administrateurs.

title
title string

Titre de la question

Date de la dernière activité
last_activity date-time

Horodatage indiquant la dernière activité avec la question (aaaa-MM-ddTHH :mm :ss.fffZ)

is_published
is_published boolean

La question is_published indicateur indique si la question est publiée ou non. Une solution publiée est visible pour tous les utilisateurs, tandis qu’une solution non publiée est en état brouillon uniquement visible par l’auteur.

Date de création
created date-time

Horodatage indiquant quand la question a été créée (aaaa-MM-ddTHH :mm :ss.fffZ)

descriptif
description string

Description de la question fournissant un contexte détaillé et des informations sur la question

solution_count
solution_count integer

Il s’agit du nombre de solutions qui ont été fournies pour cette question.

Date de mise à jour du contenu
content_updated date-time

Horodatage indiquant quand le contenu ou les pièces jointes de la question ont été mis à jour pour la dernière fois (aaaa-MM-ddTHH :mm :ss.fffZ)

pièce d'identité
id integer

ID de question unique

date de mise à jour de la question
updated date-time

Dernière fois que la ressource a été mise à jour dans la base de données. Cette date ne reflète pas les mises à jour de contenu, mais toute mise à jour des champs de l’enregistrement. Utilisez content_updated pour plus d’informations sur les mises à jour de contenu.

language
language string

Langue de la question

ConceptLabelMatch

Nom Chemin d’accès Type Description
concept_id
concept_id string

ID de concept unique

descriptif
description string

Description du concept

is_flat
is_flat boolean

is_flat

label_match
label_match string

Étiquette qui correspond au concept

language
language string

Langage de concept

ontology_id
ontology_id string

ID d’ontologie unique auquel appartient le concept

primary_label
primary_label string

Étiquette principale du concept

UserId

Identificateur d’utilisateur unique (UUID) utilisé pour référencer un utilisateur sur la plateforme Starmind.

Identificateur d’utilisateur unique (UUID) utilisé pour référencer un utilisateur sur la plateforme Starmind.

UserV3

Objet utilisateur contenant des informations utilisateur.

Nom Chemin d’accès Type Description
Sur
about string

Texte personnalisé entré par l’utilisateur pour se décrire dans sa section « À propos de moi »

avatar_url
avatar_url string

URL de l’image d’avatar de l’utilisateur

Entreprise
company string

Société de l’utilisateur

country
country string

Code pays ISO 3166-1 alpha-2 (par exemple ch, nous, de) de l’utilisateur

créé
created date-time

Horodatage indiquant quand l’utilisateur a été créé (aaaa-MM-ddTHH :mm :ss.fffZ)

supprimé
deleted date-time

Horodatage indiquant quand l’utilisateur a été supprimé (aaaa-MM-ddTHH :mm :ss.fffZ). Sans autorisations d’administrateur, seul l’utilisateur non supprimé est retourné

department
department string

Service de l’utilisateur

Messagerie électronique
email email

Email de l’utilisateur

prénom
first_name string

Prénom de l’utilisateur.

first_seen
first_seen date-time

Horodatage indiquant quand l’utilisateur s’est connecté la première fois (aaaa-MM-ddTHH :mm :ss.fffZ)

pièce d'identité
id UserId

Identificateur d’utilisateur unique (UUID) utilisé pour référencer un utilisateur sur la plateforme Starmind.

is_federated
is_federated boolean

Indique si l’utilisateur s’authentifie à l’aide d’informations d’identification locales (e-mail/mot de passe) plutôt qu’un fournisseur d’authentification unique externe (SAML, OpenID Connect)

is_technical
is_technical boolean

Indique si l’utilisateur est un utilisateur d’API technique (compte non interactif/machine) ; quand true l’utilisateur s’authentifie généralement par le biais de la clé API

language
language Language

Code de langue à deux lettres ISO 639-1 (par exemple, « en ») représentant une langue prise en charge. 'xx' peut être utilisé pour indiquer une langue inconnue.

last_name
last_name string

Nom de l’utilisateur.

location
location string

Emplacement de l’utilisateur

position
position string

Société de l’utilisateur

Language

Code de langue à deux lettres ISO 639-1 (par exemple, « en ») représentant une langue prise en charge. 'xx' peut être utilisé pour indiquer une langue inconnue.

Code de langue à deux lettres ISO 639-1 (par exemple, « en ») représentant une langue prise en charge. 'xx' peut être utilisé pour indiquer une langue inconnue.

ExpertConceptScores

Le concept de recherche d’experts correspond à des scores compris.

Nom Chemin d’accès Type 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

Toutes les étiquettes disponibles pour différentes langues

descriptif
concept.labels_for_languages.description string

descriptif

description_type
concept.labels_for_languages.description_type string

description_type

language
concept.labels_for_languages.language Language

Code de langue à deux lettres ISO 639-1 (par exemple, « en ») représentant une langue prise en charge. 'xx' peut être utilisé pour indiquer une langue inconnue.

labels
concept.labels_for_languages.labels array of string

labels

primary_label
concept.labels_for_languages.primary_label string

Étiquette principale pour la langue

last_update
concept.last_update date-time

last_update

ontology_id
concept.ontology_id string

ontology_id

parents
concept.parents array of uuid

ID de concept parent

score
score float

score

GraphQLUserResponse

Nom Chemin d’accès Type Description
utilisateur
data.user UserV3

Objet utilisateur contenant des informations utilisateur.

Erreurs
errors array of GraphQLError

Tableau facultatif d’erreurs GraphQL ; présente uniquement si des erreurs se sont produites

GraphQLError

Nom Chemin d’accès Type Description
code
extensions.code string
lieux
locations array of object
column
locations.column integer
line
locations.line integer
Message
message string
path
path array of string