Starmind (anteprima)

Il connettore Starmind consente una perfetta integrazione con il motore di conoscenze di Starmind, consentendo agli utenti di accedere alle risposte verificate e alle informazioni approfondite degli esperti nell'organizzazione. Connettendosi a Starmind, i flussi di lavoro e gli agenti possono recuperare in modo intelligente le risposte alle domande critiche dell'azienda, conoscere gli esperti e semplificare i processi decisionali.

Questo connettore è disponibile nei prodotti e nelle aree seguenti:

Servizio	Class	Regions
Copilot Studio	Di alta qualità	Tutte le aree di Power Automate , ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD)
App per la logica	Normale	Tutte le aree di App per la logica , ad eccezione delle seguenti: - Aree di Azure per enti pubblici - Aree di Azure Cina - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Apps	Di alta qualità	Tutte le aree di Power Apps , ad eccezione dei seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Automate	Di alta qualità	Tutte le aree di Power Automate , ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD)

Contatto
Nome	Gli esperti di supporto tecnico starmind sono pronti ad ascoltare e aiutare
URL	https://starmind.atlassian.net/servicedesk/customer/portal/2
Email	product@starmind.com

Metadati del connettore
Editore	Starmind (inc)
Sito Web	https://starmind.ai
Informativa sulla privacy	https://www.starmind.ai/privacy-policy
Categorie	Produttività; Collaborazione

Starmind

Sblocca la giusta esperienza esattamente quando ti serve.
Il motore avanzato di conoscenze di Starmind identifica gli esperti all'interno dell'organizzazione e si connette immediatamente alle loro informazioni dettagliate, integrando facilmente l'intelligenza umana nei flussi di lavoro quotidiani.

Starmind Connector consente una perfetta integrazione con il motore di conoscenze di Starmind, consentendo agli utenti di accedere alle risposte verificate e di connettersi con esperti nell'organizzazione. Connettendosi a Starmind, i flussi di lavoro di Power Automate o gli agenti Copilot possono recuperare in modo intelligente le risposte alle domande critiche dell'azienda, conoscere gli esperti e semplificare i processi decisionali.

Autore: nome del server di pubblicazione

Starmind

Prerequisiti

Per usare questa integrazione, è necessaria una rete Starmind preparata per l'integrazione. Richiedere la configurazione tramite il canale di supporto tecnico Starmind. Il connettore può essere usato con qualsiasi piano Starmind.

Operazioni supportate

FindExperts

Trova esperti basati sul contenuto fornito.

FindQuestions

Trova domande in base ai parametri di query forniti.

PostQuestion

Crea una nuova bozza di domanda.

PublishQuestion

Pubblica la bozza di domanda.

GetUserById

Recupera i dettagli dell'utente.

GetQuestion (deprecato)

Recupera i dettagli completi per una domanda, incluse soluzioni, commenti e concetti in base al relativo ID.

ResolveUser (deprecato)

Risolve l'oggetto globalUserId nell'oggetto utente. Fornire la query graphQL per recuperare l'oggetto utente come indicato di seguito:

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

Recupero delle credenziali

Per ottenere una chiave API per Starmind, è necessario contattare il responsabile dell'account Starmind o il team di supporto tecnico tramite il canale di supporto tecnico

Problemi noti e limitazioni

Questo connettore esegue l'autenticazione esclusivamente tramite la chiave API.

L'accesso viene eseguito tramite un account utente tecnico.
L'autenticazione OAuth nel contesto dell'utente connesso non è supportata.

Domande frequenti

Cosa è necessario per usare questo connettore con una rete Starmind?

Per usare questa integrazione, è necessaria una rete Starmind preparata per l'integrazione. Richiedere la configurazione tramite il canale di supporto tecnico Starmind.

Come è possibile ottenere una nuova chiave API?

Per ottenere una chiave API per Starmind, è necessario contattare il responsabile dell'account Starmind o il team di supporto tecnico tramite il canale di supporto tecnico

Istruzioni per la distribuzione

Usare queste istruzioni per distribuire questo connettore come connettore personalizzato in Microsoft Power Automate.

Creazione di una connessione

Il connettore supporta i tipi di autenticazione seguenti:


Predefinita	Parametri per la creazione della connessione.	Tutte le aree geografiche	Non condivisibile

Predefinito

Applicabile: tutte le aree

Parametri per la creazione della connessione.

Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.

Nome	TIPO	Description	Obbligatorio
Rete Starmind. Esempio: yourcompany.starmind.com	corda	Specificare la rete Starmind. Esempio: yourcompany.starmind.com	Vero
Chiave API fornita da Starmind	securestring	Immettere la chiave API fornita da Starmind	Vero

Limiti per la limitazione delle richieste

Nome	Chiamate	Periodo di rinnovo
Chiamate API per connessione	100	60 secondi

Azioni

Creare una bozza di domanda	Crea una nuova bozza di domanda. La bozza non è ancora ricercabile o rispondebile da altri utenti. Dopo la creazione, pubblicare la bozza (tramite l'endpoint di pubblicazione) per attivare la ricerca di esperti, rendere individuabile la domanda e consentire ad altri utenti di rispondere. Fornire la descrizione facoltativa aiuta gli esperti a comprendere meglio la domanda e aumenta le probabilità di ottenere risposte di alta qualità.
Ottenere l'utente in base all'ID	Recupera le informazioni utente in base all'ID utente specificato.
Pubblicare una domanda	Pubblica una bozza di domanda. La pubblicazione della domanda attiva la ricerca di esperti, rende individuabile la domanda e consente ad altri utenti di rispondere. Le domande vengono sempre pubblicate in modo anonimo.
Trova esperti	Trova esperti basati sul text_query fornito. La ricerca sfrutta il grafico delle conoscenze per identificare gli utenti con competenze e conoscenze pertinenti correlate alla query. Specificare la lingua facoltativa per specificare la lingua preferita per il filtro delle etichette del concetto. Ciò non influisce sulla ricerca stessa; filtra solo le competenze mostrate dagli utenti restituiti selezionando i concetti basati sull'etichetta primaria nella lingua scelta. I concetti restituiti vengono deduplicati quando più concetti condividono la stessa etichetta primaria.
Trovare domande	Cerca le domande usando facoltativo `query`, `limit` (impostazione predefinita 10), `filter`e `sort`; restituisce una raccolta impaginata con domanda `items`. Per impostazione predefinita, vengono restituite tutte le domande pubblicate, ordinate in base all'ultima attività (decrescente). È possibile applicare al risultato una combinazione di filtri, query di ricerca e criteri di ordinamento.

Creare una bozza di domanda

ID operazione:: PostQuestionDraft_V3

Crea una nuova bozza di domanda. La bozza non è ancora ricercabile o rispondebile da altri utenti. Dopo la creazione, pubblicare la bozza (tramite l'endpoint di pubblicazione) per attivare la ricerca di esperti, rendere individuabile la domanda e consentire ad altri utenti di rispondere. Fornire la descrizione facoltativa aiuta gli esperti a comprendere meglio la domanda e aumenta le probabilità di ottenere risposte di alta qualità.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
categoria	category		integer	ID facoltativo della categoria a cui assegnare la bozza di domanda
title	title	True	string	Titolo domanda, compreso tra 4 e 100 caratteri per impostazione predefinita. A seconda della configurazione di rete, la lunghezza massima del titolo può essere limitata o estesa ulteriormente.
descrizione	description		string	Descrizione della domanda facoltativa che fornisce contesto dettagliato e informazioni sulla domanda. A seconda della configurazione di rete, la descrizione potrebbe essere applicata come non vuota.
language	language		string	Codice linguistico ISO 639-1 a due lettere ,ad esempio 'en', che rappresenta una lingua supportata. 'xx' può essere usato per indicare una lingua sconosciuta.
knowledge_space	knowledge_space		integer	ID dello spazio conoscenze a cui assegnare la domanda

Restituisce

Corpo: Question

Ottenere l'utente in base all'ID

ID operazione:: GetUserById_V3

Recupera le informazioni utente in base all'ID utente specificato.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID dell'utente	id	True	string	Identificatore utente globale univoco (UUID) come parametro di percorso usato per fare riferimento all'utente nella piattaforma Starmind.

Restituisce

Corpo: GraphQLUserResponse

Pubblicare una domanda

ID operazione:: PublishQuestionDraft_V3

Pubblica una bozza di domanda. La pubblicazione della domanda attiva la ricerca di esperti, rende individuabile la domanda e consente ad altri utenti di rispondere. Le domande vengono sempre pubblicate in modo anonimo.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID della domanda da pubblicare	questionId	True	integer	ID della bozza di domanda da pubblicare

Restituisce

Nome	Percorso	Tipo	Descrizione
number_of_experts	number_of_experts	integer	number_of_experts

Trova esperti

ID operazione:: FindExperts_V3

Trova esperti basati sul text_query fornito. La ricerca sfrutta il grafico delle conoscenze per identificare gli utenti con competenze e conoscenze pertinenti correlate alla query. Specificare la lingua facoltativa per specificare la lingua preferita per il filtro delle etichette del concetto. Ciò non influisce sulla ricerca stessa; filtra solo le competenze mostrate dagli utenti restituiti selezionando i concetti basati sull'etichetta primaria nella lingua scelta. I concetti restituiti vengono deduplicati quando più concetti condividono la stessa etichetta primaria.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
language	language		string	Codice linguistico ISO 639-1 a due lettere ,ad esempio 'en', che rappresenta una lingua supportata. 'xx' può essere usato per indicare una lingua sconosciuta.
text_query	text_query	True	string	Testo di ricerca principale per identificare gli esperti. Può essere una domanda, un riepilogo di un testo, uno o più argomenti.

Restituisce

Nome	Percorso	Tipo	Descrizione
Esperti	experts	array of object	Elenco di esperti che corrispondono alla query di ricerca. Può essere vuoto se non vengono trovati esperti.
concept_scores	experts.concept_scores	ExpertConceptScores	I concetti di ricerca esperti corrispondono ai punteggi inclusi.
Punteggio	experts.score	float	Punteggio di pertinenza che indica il livello di corrispondenza dell'esperto con la query
utente	experts.user	UserV3	Oggetto utente contenente informazioni sull'utente.
label_matches	label_matches	array of ConceptLabelMatch	Etichette corrispondenti per la query di ricerca di esperti. Può essere vuoto se nessuna etichetta corrisponde.

Trovare domande

ID operazione:: FindQuestions_V3

Cerca le domande usando facoltativo query, limit (impostazione predefinita 10), filtere sort; restituisce una raccolta impaginata con domanda items. Per impostazione predefinita, vengono restituite tutte le domande pubblicate, ordinate in base all'ultima attività (decrescente). È possibile applicare al risultato una combinazione di filtri, query di ricerca e criteri di ordinamento.

Parametri

Nome	Chiave	Tipo	Descrizione
Query di ricerca per domande	query	string	Query di ricerca della domanda
Numero massimo di domande da restituire	limit	integer	Limitare il numero di domande restituite. Il valore predefinito è 10.
Filtro predefinito per domande	filter	string	Filtrare l'elenco di domande usando un filtro predefinito.
Criteri di ordinamento per le domande	sort	string	Specificare i criteri in base ai quali viene ordinato il risultato

Restituisce

Nome	Percorso	Tipo	Descrizione
href	_links.self.href	string	href
href	_links.next.href	string	href
href	_links.last.href	string	href
items	items	array of Question	Risultati impaginati della ricerca della domanda.
totale	total	integer	Numero totale di domande corrispondenti alla richiesta.

Definizioni

Domanda

Nome	Percorso	Tipo	Descrizione
knowledge_space_id	knowledge_space_id	integer	ID spazio conoscenze univoco a cui appartiene la domanda.
upvote_count	upvote_count	integer	Numero totale di richiami ricevuti dalla domanda.
view_count	view_count	integer	Numero di volte in cui la domanda è stata visualizzata dagli utenti.
Data di pubblicazione	published	date-time	Timestamp che indica quando la domanda è stata pubblicata (aaaa-MM-ggTHH:mm:ss.fffZ)
is_deleted	is_deleted	boolean	Indica se la domanda viene eliminata. Le domande eliminate non sono visibili agli utenti, ma possono comunque essere accessibili dagli amministratori.
title	title	string	Titolo della domanda
Data ultima attività	last_activity	date-time	Timestamp che indica l'ultima attività con la domanda (aaaa-MM-ggTHH:mm:ss.fffZ)
is_published	is_published	boolean	La domanda is_published flag indica se la domanda viene pubblicata o meno. Una soluzione pubblicata è visibile a tutti gli utenti, mentre una soluzione non pubblicata è in stato bozza visibile solo all'autore.
Data di creazione	created	date-time	Timestamp che indica quando è stata creata la domanda (aaaa-MM-ggTHH:mm:ss.fffZ)
descrizione	description	string	Descrizione della domanda che fornisce contesto dettagliato e informazioni sulla domanda
solution_count	solution_count	integer	Questo è il numero di soluzioni che sono state fornite per questa domanda.
Data aggiornata del contenuto	content_updated	date-time	Timestamp che indica quando il contenuto o gli allegati della domanda sono stati aggiornati per l'ultimo aggiornamento (aa-MM-ggTHH:mm:ss.fffZ)
id	id	integer	ID domanda univoco
data di aggiornamento della domanda	updated	date-time	Ora dell'ultimo aggiornamento della risorsa nel database. Questa data non riflette gli aggiornamenti del contenuto, ma qualsiasi aggiornamento a qualsiasi campo del record. Usare content_updated per informazioni sugli aggiornamenti del contenuto.
language	language	string	Lingua della domanda

ConceptLabelMatch

Nome	Percorso	Tipo	Descrizione
concept_id	concept_id	string	ID concetto univoco
descrizione	description	string	Descrizione del concetto
is_flat	is_flat	boolean	is_flat
label_match	label_match	string	Etichetta che corrisponde al concetto
language	language	string	Linguaggio del concetto
ontology_id	ontology_id	string	ID univoco dell'ontologia a cui appartiene il concetto
primary_label	primary_label	string	Concetto di etichetta primaria

UserId

Identificatore utente univoco (UUID) usato per fare riferimento a un utente nella piattaforma Starmind.

: uuid

UserV3

Oggetto utente contenente informazioni sull'utente.

Nome	Percorso	Tipo	Descrizione
Circa	about	string	Testo personalizzato immesso dall'utente per descriversi nella sezione "Informazioni su di me"
avatar_url	avatar_url	string	URL dell'immagine avatar dell'utente
azienda	company	string	Società dell'utente
country	country	string	Codice paese ISO 3166-1 alpha-2 (ad esempio ch, us, de) dell'utente
created	created	date-time	Timestamp che indica quando è stato creato l'utente (aaaa-MM-ggTHH:mm:ss.fffZ)
cancellato	deleted	date-time	Timestamp che indica quando l'utente è stato eliminato (aaaa-MM-ggTHH:mm:ss.fffZ). Senza autorizzazioni di amministratore, verrà restituito solo l'utente non eliminato
dipartimento	department	string	Reparto dell'utente
posta elettronica	email	email	Email dell'utente
first_name	first_name	string	Nome dell'utente.
first_seen	first_seen	date-time	Timestamp che indica quando l'utente ha eseguito l'accesso alla prima volta (aaaa-MM-ggTHH:mm:ss.fffZ)
id	id	UserId	Identificatore utente univoco (UUID) usato per fare riferimento a un utente nella piattaforma Starmind.
is_federated	is_federated	boolean	Indica se l'utente esegue l'autenticazione usando credenziali locali (posta elettronica/password) anziché un provider SSO esterno (SAML, OpenID Connect)
is_technical	is_technical	boolean	Indica se l'utente è un utente dell'API tecnica (account non interattivo/computer); quando true l'utente esegue in genere l'autenticazione tramite chiave API
language	language	Language	Codice linguistico ISO 639-1 a due lettere ,ad esempio 'en', che rappresenta una lingua supportata. 'xx' può essere usato per indicare una lingua sconosciuta.
last_name	last_name	string	Cognome dell'utente.
ubicazione	location	string	Posizione dell'utente
posizione	position	string	Società dell'utente

Language

Codice linguistico ISO 639-1 a due lettere ,ad esempio 'en', che rappresenta una lingua supportata. 'xx' può essere usato per indicare una lingua sconosciuta.

: string

ExpertConceptScores

I concetti di ricerca esperti corrispondono ai punteggi inclusi.

Nome	Percorso	Tipo	Descrizione
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	Tutte le etichette disponibili per lingue diverse
descrizione	concept.labels_for_languages.description	string	descrizione
description_type	concept.labels_for_languages.description_type	string	description_type
language	concept.labels_for_languages.language	Language	Codice linguistico ISO 639-1 a due lettere ,ad esempio 'en', che rappresenta una lingua supportata. 'xx' può essere usato per indicare una lingua sconosciuta.
labels	concept.labels_for_languages.labels	array of string	labels
primary_label	concept.labels_for_languages.primary_label	string	Etichetta principale per la lingua
last_update	concept.last_update	date-time	last_update
ontology_id	concept.ontology_id	string	ontology_id
genitori	concept.parents	array of uuid	ID concetto padre
Punteggio	score	float	Punteggio

GraphQLUserResponse

Nome	Percorso	Tipo	Descrizione
utente	data.user	UserV3	Oggetto utente contenente informazioni sull'utente.
errori	errors	array of GraphQLError	Matrice facoltativa di errori GraphQL; presente solo se si sono verificati errori

GraphQLError

Nome	Percorso	Tipo
codice	extensions.code	string
località	locations	array of object
column	locations.column	integer
line	locations.line	integer
message	message	string
path	path	array of string

Condividi tramite

Starmind (anteprima)

Starmind

Autore: nome del server di pubblicazione

Prerequisiti

Operazioni supportate

FindExperts

FindQuestions

PostQuestion

PublishQuestion

GetUserById

GetQuestion (deprecato)

ResolveUser (deprecato)

Recupero delle credenziali

Problemi noti e limitazioni

Domande frequenti

Cosa è necessario per usare questo connettore con una rete Starmind?

Come è possibile ottenere una nuova chiave API?

Istruzioni per la distribuzione

Creazione di una connessione

Predefinito

Limiti per la limitazione delle richieste

Azioni

Creare una bozza di domanda

Parametri

Restituisce

Ottenere l'utente in base all'ID

Parametri

Restituisce

Pubblicare una domanda

Parametri

Restituisce

Trova esperti

Parametri

Restituisce

Trovare domande

Parametri

Restituisce

Definizioni

Domanda

ConceptLabelMatch

UserId

UserV3

Language

ExpertConceptScores

GraphQLUserResponse

GraphQLError