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 |
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
- Corps
- GraphQLUserResponse
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 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 |