Informazioni di riferimento sugli utenti di IQ aziendale (anteprima)

Importante

Si tratta di una funzionalità di anteprima.

• Microsoft rilascia funzionalità di anteprima prima di una versione ufficiale, in modo che i clienti possano ottenere l'accesso anticipato e fornire commenti e suggerimenti.
• Le funzionalità di anteprima hanno funzionalità limitate e non sono destinate all'uso in produzione.
• Microsoft potrebbero modificare i nomi e i parametri degli strumenti MCP in anteprima. Evitare le dipendenze codificate in modo rigido. Microsoft mantiene il supporto per questo scenario.
• Le funzionalità di anteprima sono soggette a Microsoft condizioni supplementari per l'utilizzo.

Overview

ID del server	URL a livello di tenant	Nome visualizzato	Description
mcp_MeServer	https://agent365.svc.cloud.microsoft/agents/ tenants/{tenantId}/servers/mcp_MeServer	Utente di IQ aziendale	Server MCP per la consapevolezza di sé e la consapevolezza dell'organizzazione. Usa questo server MCP per accedere ai profili utente nell'organizzazione ed eseguire varie azioni, ad esempio ottenere il profilo, il profilo di un utente, il manager di un utente o i report diretti.

Strumenti disponibili

mcp_graph_getDirectReports

Elenca i report diretti di un utente specificato nella directory. Devi fornire o l'ID dell'oggetto (GUID) dell'utente o il loro userPrincipalName UPN (simile a una email). Non usare me come userIdentifier.

Parametri obbligatori:

• userIdentifier: ID oggetto dell'utente (GUID) o userPrincipalName (UPN)

Note

Non inviare me come userIdentifier. Se è disponibile solo il nome visualizzato, cerca prima l'utente per ottenere userPrincipalName o l'ID dell'oggetto.

Parametri facoltativi:

• seleziona: Elenco separato da virgola delle proprietà da restituire (ad esempio, id, displayName, mail, jobTitle, userPrincipalName)
• top: numero di elementi da restituire per pagina

mcp_graph_getMyManager

Recupera il gestore dell'utente connesso (il chiamante). Questo endpoint restituisce sempre il gestore del contesto utente corrente.

Parametri facoltativi:

• select: elenco di proprietà dei manager separato da virgole da restituire

mcp_graph_getMyProfile

Recupera i dettagli del profilo dell'utente connesso (il chiamante). Questo endpoint restituisce sempre il profilo del contesto utente corrente.

Parametri facoltativi:

• select: elenco delimitato da virgole delle proprietà del profilo utente
• Espandi: Espandi le tabelle correlate (ad esempio, manager, directReports)

mcp_graph_getUserProfile

Recupera il profilo di un utente specificato nella directory. Devi fornire o l'ID dell'oggetto (GUID) dell'utente o il loro userPrincipalName UPN (simile a una email). Non usare me come userIdentifier. Per l'utente connesso, usare mcp_graph_getMyProfile.

Parametri obbligatori:

• userIdentifier: ID oggetto dell'utente (GUID) o userPrincipalName (UPN)

Note

Non mandarmi. Se è disponibile solo il nome visualizzato, cercare prima di tutto l'utente.

Parametri facoltativi:

• select: elenco delimitato da virgole di proprietà utente da restituire
• Espandi: Espandi una tabella correlata (manager oppure directReports). Puoi espandere una sola proprietà per richiesta.

mcp_graph_getUsersManager

Recupera il gestore di un utente specificato nella directory . Fornire l'ID oggetto (GUID) dell'utente oppure l'UPN userPrincipalName (simile a un indirizzo e-mail). Non usare me come userIdentifier. Per l'utente connesso, usare mcp_graph_getMyManager.

Parametri obbligatori:

• userIdentifier: ID oggetto dell'utente (GUID) o userPrincipalName (UPN)

Note

Non mandarmi. Se è disponibile solo il nome visualizzato, cercare prima l'utente.

Parametri facoltativi:

• Selezionare: Elenco delimitato da virgole di proprietà da restituire per il gestore, ad esempio id, displayNamemail, , jobTitle,userPrincipalName

mcp_graph_listUsers

Recupera un elenco di utenti nell'organizzazione. Supporta opzioni di query come $select, $filter, $top, $orderby. Il valore predefinito ConsistencyLevel è finale.

Parametri facoltativi:

• Superiore: Mostra solo i n primi utenti
• select: elenco delimitato da virgole di proprietà utente da restituire
• Filtro: Filtra gli utenti per proprietà, ad esempio startswith(displayName,'A')
• Orderby: L'ordine risulta tramite una proprietà data, come ad esempio displayName
• search: ricerca di testo libero per gli utenti. Formato: "property:value", ad esempio displayName:Neha per cercare nomi visualizzati contenenti Neha. Supporta più proprietà che includono spazi. Regola di fallback: se $search ha esito negativo o non restituisce risultati, riprovare automaticamente con $filter.
• Conteggio: Includi conteggio degli elementi (vero o falso)
• ConsistencyLevel: Intestazione obbligatoria per le query avanzate (impostazione predefinita: finale)

Funzionalità principali

Conoscenza di sé

• Ottenere il profilo dell'utente connesso.
• Recupera il responsabile dell'utente connesso.
• Accedere alle informazioni sul contesto utente correnti.
• Nessuna necessità di identificatori utente.

Profili utente

• Recuperare il profilo di qualsiasi utente in base all'ID o all'UPN.
• Accedere alle proprietà utente, ad esempio displayName, mailjobTitle, e altro ancora.
• Espandere le tabelle correlate, manager ad esempio e directReports.
• Selezionare le proprietà usando $select.

Gerarchia organizzativa

• Ottieni il responsabile di un utente.
• Ottenere i report diretti di un utente.
• Passare in rassegna la gerarchia dei report.
• Responsabili e relazioni con i collaboratori diretti.

Ricerca utente

• Elencare gli utenti nell'organizzazione.
• Ricerca a testo libero con fallback automatico.
• Filtro e ordinamento di OData.
• Supporto per la paginazione.
• Contare gli utenti nei risultati.

Funzionalità di query

• OData $select per la selezione delle proprietà.
• OData $filter per il filtro utente.
• OData $expand per le entità correlate.
• $orderby OData per l'ordinamento.
• $search di testo libero con fallback.
• Supporto della coerenza finale.

Notes

• Usa mcp_graph_getMyProfile per l'utente che ha effettuato l'accesso, non mcp_graph_getUserProfile con me.
• Usare mcp_graph_getMyManager per il responsabile dell'utente che ha effettuato l'accesso.
• userIdentifier deve essere l'ID dell'oggetto (GUID) o userPrincipalName (UPN), non utilizzare il nome visualizzato.
• Se è disponibile solo il nome visualizzato, utilizzare mcp_graph_listUsers per cercare prima l'utente.
• $expand può espandere una sola proprietà per richiesta (manager o directReports).
• $search passa automaticamente a $filter se la ricerca non riesce.
• ConsistencyLevel eventual è richiesto per le query avanzate.
• Formato di ricerca: "property:value" con virgolette.

Casi d'uso comuni

Ottenere le mie informazioni

• Usa mcp_graph_getMyProfile per ottenere il profilo dell'utente corrente.
• Usa mcp_graph_getMyManager per ottenere il manager dell'utente corrente.

Trovare un utente

• Utilizzamcp_graph_listUsers con il parametro di ricerca.

  Esempio: search='"displayName:John"' per trovare utenti denominati John.

• Recuperare userPrincipalName o l'ID dell'oggetto dai risultati.

Ottenere i dettagli utente

• Uso di mcp_graph_getUserProfile con userIdentifier.
• Usare select per ottenere proprietà specifiche.
• Usa espandi per includere manager o directReports

Recupera la struttura organizzativa

• Utilizzare mcp_graph_getUsersManager per ottenere il manager di un utente.
• Usare mcp_graph_getDirectReports per ottenere i report diretti di un utente.
• Concatenare le chiamate per spostarsi nella gerarchia dei report.