Starmind (preview)
De Starmind Connector maakt naadloze integratie mogelijk met de kennis-engine van Starmind, zodat gebruikers toegang hebben tot geverifieerde antwoorden en deskundige inzichten in hun organisatie. Door verbinding te maken met Starmind kunnen uw werkstromen en agenten op intelligente wijze antwoorden op bedrijfskritieke vragen ophalen, deskundige kennis opdoen en besluitvormingsprocessen stroomlijnen.
Deze connector is beschikbaar in de volgende producten en regio's:
| Dienst | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Logic-apps | Standaard | Alle Logic Apps-regio's , met uitzondering van het volgende: - Azure Government-regio's - Azure China-regio's - Us Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Contactpersoon | |
|---|---|
| Naam | Starmind technische ondersteuningsexperts zijn klaar om te luisteren en te helpen |
| URL | https://starmind.atlassian.net/servicedesk/customer/portal/2 |
| E-mailen | product@starmind.com |
| Connectormetagegevens | |
|---|---|
| Uitgever | Starmind (inc) |
| Webpagina | https://starmind.ai |
| Privacybeleid | https://www.starmind.ai/privacy-policy |
| Categorieën | Productiviteit; Samenwerking |
Starmind
Ontgrendel de juiste expertise precies wanneer u deze nodig hebt.
Starmind's geavanceerde kennisengine identificeert experts binnen uw organisatie en verbindt u direct met hun inzichten, waarbij menselijke intelligentie naadloos wordt geïntegreerd in uw dagelijkse werkstromen.
De Starmind Connector maakt naadloze integratie mogelijk met de kennis-engine van Starmind, zodat gebruikers toegang hebben tot geverifieerde antwoorden en contact kunnen maken met experts binnen hun organisatie. Door verbinding te maken met Starmind kunnen Power Automate-werkstromen of Copilot-agents op intelligente wijze antwoorden ophalen op bedrijfskritieke vragen, deskundige kennis opdoen en besluitvormingsprocessen stroomlijnen.
Uitgever: naam van uitgever
Starmind
Vereiste voorwaarden
Als u deze integratie wilt gebruiken, hebt u een Starmind-netwerk nodig dat is voorbereid voor de integratie. Vraag de installatie aan via het starmind-kanaal voor technische ondersteuning. De connector kan worden gebruikt met elk Starmind-plan.
Ondersteunde bewerkingen
FindExperts
Zoekt experts op basis van de geleverde inhoud.
FindQuestions
Hiermee vindt u vragen op basis van de opgegeven queryparameters.
PostQuestion
Hiermee maakt u een nieuw concept voor vragen.
PublishQuestion
Hiermee publiceert u het concept van de vraag.
GetUserById
Haalt de gebruikersgegevens op.
GetQuestion (afgeschaft)
Haalt de volledige details voor een vraag op, inclusief oplossingen, opmerkingen en concepten op basis van de id.
ResolveUser (afgeschaft)
Hiermee wordt de globalUserId omgezet in het gebruikersobject. Geef de graphQL-query op om het gebruikersobject als volgt op te halen:
query getUser($globalUserId: UUID!) {
user(globalUserId: $globalUserId) {
globalUserId
firstname
lastname
email
languageId
avatarUrl
company
department
position
location
about
countryId
created
dateDeleted
isFederated
}
}
Referenties verkrijgen
Als u een API-sleutel voor Starmind wilt verkrijgen, moet u contact opnemen met uw Starmind-accountmanager of ondersteuningsteam via ons technische ondersteuningskanaal
Bekende problemen en beperkingen
Deze connector wordt uitsluitend geverifieerd via API-sleutel.
- Toegang wordt uitgevoerd via een technisch gebruikersaccount.
- OAuth-verificatie in de context van de aangemelde gebruiker wordt niet ondersteund.
Veelgestelde vragen
Wat is vereist om deze connector te gebruiken met een Starmind-netwerk?
Als u deze integratie wilt gebruiken, hebt u een Starmind-netwerk nodig dat is voorbereid voor de integratie. Vraag de installatie aan via het starmind-kanaal voor technische ondersteuning.
Hoe kan ik een nieuwe API-sleutel ophalen?
Als u een API-sleutel voor Starmind wilt verkrijgen, moet u contact opnemen met uw Starmind-accountmanager of ondersteuningsteam via ons technische ondersteuningskanaal
Implementatie-instructies
Gebruik deze instructies om deze connector te implementeren als een aangepaste connector in Microsoft Power Automate.
Een verbinding maken
De connector ondersteunt de volgende verificatietypen:
| standaard | Parameters voor het maken van verbinding. | Alle regio's | Niet deelbaar |
Verstek
Van toepassing: Alle regio's
Parameters voor het maken van verbinding.
Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.
| Naam | Typologie | Description | Verplicht |
|---|---|---|---|
| Het Starmind-netwerk. Voorbeeld: yourcompany.starmind.com | touw | Geef uw Starmind-netwerk op. Voorbeeld: yourcompany.starmind.com | Klopt |
| API-sleutel zoals geleverd door Starmind | beveiligde string | Voer de API-sleutel in zoals opgegeven door Starmind | Klopt |
Beperkingslimieten
| Name | Aanroepen | Verlengingsperiode |
|---|---|---|
| API-aanroepen per verbinding | 100 | 60 seconden |
Acties
| Een concept van een vraag maken |
Hiermee maakt u een nieuw concept voor vragen. Het concept kan nog niet door anderen worden doorzocht of beantwoord. Nadat het is gemaakt, publiceert u het concept (via het publicatie-eindpunt) om een deskundige zoekopdracht te activeren, maakt u de vraag detecteerbaar en kunnen andere gebruikers deze beantwoorden. Door de optionele beschrijving te geven, kunnen experts de vraag beter begrijpen en de kans vergroten dat ze antwoorden van hoge kwaliteit krijgen. |
| Een vraag publiceren |
Hiermee publiceert u een concept van een vraag. Door de vraag te publiceren, kan de vraag worden gevonden en kunnen andere gebruikers deze beantwoorden. Vragen worden altijd anoniem gepubliceerd. |
| Experts zoeken |
Vindt experts op basis van de geleverde text_query. De zoekopdracht maakt gebruik van de kennisgrafiek om gebruikers te identificeren met relevante expertise en kennis met betrekking tot de query. Geef de optionele taal op om de voorkeurstaal op te geven voor het filteren van conceptlabels. Dit heeft geen invloed op de zoekactie zelf; hiermee wordt alleen gefilterd welke expertise we van geretourneerde gebruikers weergeven door concepten te selecteren op basis van het primaire label in de gekozen taal. Geretourneerde concepten worden ontdubbeld wanneer meerdere concepten hetzelfde primaire label delen. |
| Gebruiker ophalen op id |
Haalt gebruikersgegevens op op basis van de opgegeven gebruikers-id. |
| Vragen zoeken |
Zoekt naar vragen met optionele |
Een concept van een vraag maken
Hiermee maakt u een nieuw concept voor vragen. Het concept kan nog niet door anderen worden doorzocht of beantwoord. Nadat het is gemaakt, publiceert u het concept (via het publicatie-eindpunt) om een deskundige zoekopdracht te activeren, maakt u de vraag detecteerbaar en kunnen andere gebruikers deze beantwoorden. Door de optionele beschrijving te geven, kunnen experts de vraag beter begrijpen en de kans vergroten dat ze antwoorden van hoge kwaliteit krijgen.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
category
|
category | integer |
De optionele id van de categorie waaraan het vraagconcept moet worden toegewezen |
|
|
title
|
title | True | string |
Vraagtitel, standaard tussen 4 en 100 tekens. Afhankelijk van de netwerkconfiguratie kan de maximale lengte van de titel beperkt of verder worden uitgebreid. |
|
beschrijving
|
description | string |
De optionele vraagbeschrijving biedt gedetailleerde context en informatie over de vraag. Afhankelijk van de netwerkconfiguratie kan de beschrijving worden afgedwongen om niet-leeg te zijn. |
|
|
language
|
language | string |
ISO 639-1 tweeletterige taalcode (bijvoorbeeld 'en') die een ondersteunde taal vertegenwoordigt. 'xx' kan worden gebruikt om een onbekende taal aan te geven. |
|
|
knowledge_space
|
knowledge_space | integer |
de id van de kennisruimte waaraan de vraag moet worden toegewezen |
Retouren
- Body
- Question
Een vraag publiceren
Hiermee publiceert u een concept van een vraag. Door de vraag te publiceren, kan de vraag worden gevonden en kunnen andere gebruikers deze beantwoorden. Vragen worden altijd anoniem gepubliceerd.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Id van de vraag die moet worden gepubliceerd
|
questionId | True | integer |
De id van het vraagontwerp dat moet worden gepubliceerd |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
number_of_experts
|
number_of_experts | integer |
number_of_experts |
Experts zoeken
Vindt experts op basis van de geleverde text_query. De zoekopdracht maakt gebruik van de kennisgrafiek om gebruikers te identificeren met relevante expertise en kennis met betrekking tot de query. Geef de optionele taal op om de voorkeurstaal op te geven voor het filteren van conceptlabels. Dit heeft geen invloed op de zoekactie zelf; hiermee wordt alleen gefilterd welke expertise we van geretourneerde gebruikers weergeven door concepten te selecteren op basis van het primaire label in de gekozen taal. Geretourneerde concepten worden ontdubbeld wanneer meerdere concepten hetzelfde primaire label delen.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
language
|
language | string |
ISO 639-1 tweeletterige taalcode (bijvoorbeeld 'en') die een ondersteunde taal vertegenwoordigt. 'xx' kan worden gebruikt om een onbekende taal aan te geven. |
|
|
text_query
|
text_query | True | string |
Primaire zoektekst om experts te identificeren. Dit kan een vraag zijn, een samenvatting van een tekst, een of meer onderwerpen. |
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
deskundigen
|
experts | array of object |
Lijst met experts die overeenkomen met de zoekquery. Kan leeg zijn als er geen experts worden gevonden. |
|
concept_scores
|
experts.concept_scores | ExpertConceptScores |
Het zoekconcept van experts komt overeen met scores. |
|
partituur
|
experts.score | float |
Relevantiescore die aangeeft hoe goed de expert overeenkomt met de query |
|
user
|
experts.user | UserV3 |
Gebruikersobject met gebruikersgegevens. |
|
label_matches
|
label_matches | array of ConceptLabelMatch |
De overeenkomende labels voor de zoekquery voor experts. Kan leeg zijn als er geen labels overeenkomen. |
Gebruiker ophalen op id
Haalt gebruikersgegevens op op basis van de opgegeven gebruikers-id.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
De id van de gebruiker
|
id | True | string |
De unieke globale gebruikers-id (UUID) als padparameter die wordt gebruikt om te verwijzen naar de gebruiker op het Starmind-platform. |
Retouren
- Body
- GraphQLUserResponse
Vragen zoeken
Zoekt naar vragen met optionele query, limit (standaard 10) filteren sort; retourneert een gepagineerde verzameling met vraag items. Standaard worden alle gepubliceerde vragen geretourneerd, gesorteerd op hun laatste activiteit (aflopend). Een combinatie van filters, zoekquery's en bestelcriteria kan worden toegepast op het resultaat.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Zoekquery voor vragen
|
query | string |
De zoekquery voor vragen |
|
|
Maximum aantal vragen dat moet worden geretourneerd
|
limit | integer |
Beperk het aantal geretourneerde vragen. De standaardwaarde is 10. |
|
|
Vooraf gedefinieerd filter voor vragen
|
filter | string |
Filter de lijst met vragen met behulp van een vooraf gedefinieerd filter. |
|
|
Sorteercriteria voor vragen
|
sort | string |
Geef de criteria op waarop het resultaat is gesorteerd |
Retouren
| Name | Pad | 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 |
Gepagineerde resultaten van de zoekopdracht naar vragen. |
|
totaal
|
total | integer |
Totaal aantal vragen dat overeenkomt met de aanvraag. |
Definities
Question
| Name | Pad | Type | Description |
|---|---|---|---|
|
knowledge_space_id
|
knowledge_space_id | integer |
De unieke kennisruimte-id waartoe de vraag behoort. |
|
upvote_count
|
upvote_count | integer |
Het totale aantal upvotes dat de vraag heeft ontvangen. |
|
view_count
|
view_count | integer |
Het aantal keren dat de vraag door gebruikers is bekeken. |
|
Gepubliceerde datum
|
published | date-time |
Tijdstempel die aangeeft wanneer de vraag is gepubliceerd (jjjj-MM-ddTHH:mm:ss.fffZ) |
|
is_deleted
|
is_deleted | boolean |
Geeft aan of de vraag is verwijderd. Verwijderde vragen zijn niet zichtbaar voor gebruikers, maar kunnen nog steeds worden geopend door de beheerders. |
|
title
|
title | string |
De titel van de vraag |
|
Datum van laatste activiteit
|
last_activity | date-time |
Tijdstempel die de laatste activiteit aangeeft met de vraag (jjjj-MM-ddTHH:mm:ss.fffZ) |
|
is_published
|
is_published | boolean |
De vraag is_published vlag geeft aan of de vraag al dan niet is gepubliceerd. Een gepubliceerde oplossing is zichtbaar voor alle gebruikers, terwijl een niet-gepubliceerde oplossing alleen zichtbaar is voor de auteur. |
|
Aanmaakdatum
|
created | date-time |
Tijdstempel die aangeeft wanneer de vraag is gemaakt (jjjj-MM-ddTHH:mm:ss.fffZ) |
|
beschrijving
|
description | string |
Beschrijving van de vraag met gedetailleerde context en informatie over de vraag |
|
solution_count
|
solution_count | integer |
Dit is het aantal oplossingen dat voor deze vraag is verstrekt. |
|
Bijgewerkte datum van inhoud
|
content_updated | date-time |
Tijdstempel die aangeeft wanneer de inhoud of bijlagen van de vraag voor het laatst zijn bijgewerkt (jjjj-MM-ddTHH:mm:ss.fffZ) |
|
identiteitskaart
|
id | integer |
De unieke vraag-id |
|
bijgewerkte datum van vraag
|
updated | date-time |
De laatste keer dat de resource is bijgewerkt in de database. Deze datum geeft geen inhoudsupdates weer, maar wordt bijgewerkt naar velden van de record. Gebruik content_updated voor informatie over inhoudsupdates. |
|
language
|
language | string |
De vraagtaal |
ConceptLabelMatch
| Name | Pad | Type | Description |
|---|---|---|---|
|
concept_id
|
concept_id | string |
De unieke concept-id |
|
beschrijving
|
description | string |
De conceptbeschrijving |
|
is_flat
|
is_flat | boolean |
is_flat |
|
label_match
|
label_match | string |
Het label dat overeenkomt met het concept |
|
language
|
language | string |
Concepttaal |
|
ontology_id
|
ontology_id | string |
De unieke ontologie-id waartoe het concept behoort |
|
primary_label
|
primary_label | string |
Primair conceptlabel |
UserId
De unieke gebruikers-id (UUID) die wordt gebruikt om te verwijzen naar een gebruiker in het Starmind-platform.
De unieke gebruikers-id (UUID) die wordt gebruikt om te verwijzen naar een gebruiker in het Starmind-platform.
UserV3
Gebruikersobject met gebruikersgegevens.
| Name | Pad | Type | Description |
|---|---|---|---|
|
Over
|
about | string |
Aangepaste tekst die door de gebruiker is ingevoerd om zichzelf te beschrijven in de sectie Info over mij |
|
avatar_url
|
avatar_url | string |
URL naar de avatarafbeelding van de gebruiker |
|
bedrijf
|
company | string |
Bedrijf van de gebruiker |
|
country
|
country | string |
ISO 3166-1 alfa-2-landcode (bijvoorbeeld ch, us, de) van de gebruiker |
|
created
|
created | date-time |
Tijdstempel die aangeeft wanneer de gebruiker is gemaakt (jjjj-MM-ddTHH:mm:ss.fffZ) |
|
verwijderd
|
deleted | date-time |
Tijdstempel die aangeeft wanneer de gebruiker is verwijderd (jjjj-MM-ddTHH:mm:ss.fffZ). Zonder beheerdersmachtigingen wordt alleen niet-verwijderde gebruiker geretourneerd |
|
afdeling
|
department | string |
Afdeling van de gebruiker |
|
e-mailadres
|
E-mail van de gebruiker |
||
|
voornaam
|
first_name | string |
Voornaam van de gebruiker. |
|
first_seen
|
first_seen | date-time |
Tijdstempel die aangeeft wanneer de gebruiker zich voor het eerst heeft aangemeld (jjjj-MM-ddTHH:mm:ss.fffZ) |
|
identiteitskaart
|
id | UserId |
De unieke gebruikers-id (UUID) die wordt gebruikt om te verwijzen naar een gebruiker in het Starmind-platform. |
|
is_federated
|
is_federated | boolean |
Geeft aan of de gebruiker verifieert met behulp van lokale referenties (e-mail/wachtwoord) in plaats van een externe SSO-provider (SAML, OpenID Connect) |
|
is_technical
|
is_technical | boolean |
Geeft aan of de gebruiker een technische API-gebruiker is (niet-interactief/machineaccount); wanneer waar is, verifieert de gebruiker zich doorgaans via API-sleutel |
|
language
|
language | Language |
ISO 639-1 tweeletterige taalcode (bijvoorbeeld 'en') die een ondersteunde taal vertegenwoordigt. 'xx' kan worden gebruikt om een onbekende taal aan te geven. |
|
achternaam
|
last_name | string |
Achternaam van de gebruiker. |
|
location
|
location | string |
Locatie van de gebruiker |
|
positie
|
position | string |
Bedrijf van de gebruiker |
Language
ISO 639-1 tweeletterige taalcode (bijvoorbeeld 'en') die een ondersteunde taal vertegenwoordigt. 'xx' kan worden gebruikt om een onbekende taal aan te geven.
ISO 639-1 tweeletterige taalcode (bijvoorbeeld 'en') die een ondersteunde taal vertegenwoordigt. 'xx' kan worden gebruikt om een onbekende taal aan te geven.
ExpertConceptScores
Het zoekconcept van experts komt overeen met scores.
| Name | Pad | 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 |
Alle beschikbare labels voor verschillende talen |
|
beschrijving
|
concept.labels_for_languages.description | string |
beschrijving |
|
description_type
|
concept.labels_for_languages.description_type | string |
description_type |
|
language
|
concept.labels_for_languages.language | Language |
ISO 639-1 tweeletterige taalcode (bijvoorbeeld 'en') die een ondersteunde taal vertegenwoordigt. 'xx' kan worden gebruikt om een onbekende taal aan te geven. |
|
labels
|
concept.labels_for_languages.labels | array of string |
labels |
|
primary_label
|
concept.labels_for_languages.primary_label | string |
Hoofdlabel voor de taal |
|
last_update
|
concept.last_update | date-time |
last_update |
|
ontology_id
|
concept.ontology_id | string |
ontology_id |
|
ouders
|
concept.parents | array of uuid |
De bovenliggende concept-id's |
|
partituur
|
score | float |
partituur |
GraphQLUserResponse
| Name | Pad | Type | Description |
|---|---|---|---|
|
user
|
data.user | UserV3 |
Gebruikersobject met gebruikersgegevens. |
|
Fouten
|
errors | array of GraphQLError |
Optionele matrix van GraphQL-fouten; alleen aanwezig als er fouten zijn opgetreden |
GraphQLError
| Name | Pad | Type | Description |
|---|---|---|---|
|
code
|
extensions.code | string | |
|
locaties
|
locations | array of object | |
|
kolom
|
locations.column | integer | |
|
lijn
|
locations.line | integer | |
|
message
|
message | string | |
|
path
|
path | array of string |