Référence utilisateur (aperçu)

Note

Cet article décrit les caractéristiques utilisées dans les agents ou flux d’agents alimentés par le faisceau standard.

Important

Il s’agit d’une fonctionnalité en version préliminaire.

• Microsoft publie des fonctionnalités en préversion avant leur publication officielle afin que les clients puissent y accéder en avant-première et faire part de leurs commentaires.
• Les fonctionnalités en préversion ont des fonctionnalités restreintes et ne sont pas destinées à une utilisation en production.
• Microsoft pourrait modifier les noms et les paramètres des outils MCP en préversion. Évitez les dépendances codées en dur. Microsoft gère la prise en charge des scénarios.
• Les fonctionnalités en préversion sont soumises à Microsoft conditions d’utilisation supplémentaires.

Aperçu

ID du serveur	URL au niveau du locataire	Nom d'affichage	Description
mcp_MeServer	https://agent365.svc.cloud.microsoft/agents/ tenants/{tenantId}/servers/mcp_MeServer	Utilisateur	Outils pour la connaissance de soi et la conscience organisationnelle. Utilisez cet outil pour accéder aux profils utilisateurs de votre organisation et effectuer diverses actions telles que l’accès à votre profil, celui d’un utilisateur, un gestionnaire d’utilisateur ou des subordonnés directs.

Outils disponibles

mcp_graph_getDirectReports

Répertorie les rapports directs d’un utilisateur spécifié dans le répertoire. Vous devez fournir soit l’ID d’objet (GUID) de l’utilisateur, soit leur userPrincipalName UPN (de type email). N’utilisez pas me comme le userIdentifier.

Paramètres obligatoires :

• userIdentifier : ID d’objet de l’utilisateur (GUID) ou userPrincipalName (UPN)

Note

N’envoyez me pas en tant que userIdentifier. Si seul le nom d’affichage est disponible, recherchez d’abord l’utilisateur pour obtenir userPrincipalName, ou l’identifiant de l’objet.

Paramètres facultatifs :

• Sélectionner : Liste des propriétés séparées par virgule à retourner (par exemple, id, displayName, mail, jobTitle, userPrincipalName)
• top : nombre d’éléments à retourner par page

mcp_graph_getMyManager

Récupère le gestionnaire de l’utilisateur connecté (l’appelant). Ce point de terminaison renvoie toujours le responsable du contexte utilisateur actuel.

Paramètres facultatifs :

• select : liste de propriétés du responsable à renvoyer, séparées par des virgules

mcp_graph_getMyProfile

Récupère les détails du profil de l’utilisateur connecté (l’appelant). Ce point de terminaison renvoie toujours le profil du contexte utilisateur actuel.

Paramètres facultatifs :

• select : liste séparée par des virgules des propriétés de profil utilisateur
• Étendre : Développer les tables associées (par exemple, manager, directReports)

mcp_graph_getUserProfile

Récupère le profil d’un utilisateur spécifié dans le répertoire. Vous devez fournir soit l’ID d’objet (GUID) de l’utilisateur, soit leur userPrincipalName UPN (de type email). N’utilisez pas me comme le userIdentifier. Pour l’utilisateur connecté, utilisez mcp_graph_getMyProfile.

Paramètres obligatoires :

• userIdentifier : ID d’objet de l’utilisateur (GUID) ou userPrincipalName (UPN)

Note

Ne m’envoyez pas. Si seul le nom d’affichage est disponible, recherchez d’abord l’utilisateur.

Paramètres facultatifs :

• select : liste de propriétés de l’utilisateur à renvoyer, séparées par des virgules
• Étendre : Étendre une table liée (manager OU directReports). Vous ne pouvez étendre qu’une seule propriété par requête.

mcp_graph_getUsersManager

Récupère le gestionnaire d’un utilisateur spécifié dans le répertoire. Indiquez l’ID d’objet de l’utilisateur (GUID) ou son userPrincipalName (UPN de type e-mail). N’utilisez pas me comme le userIdentifier. Pour l’utilisateur connecté, utilisez mcp_graph_getMyManager.

Paramètres obligatoires :

• userIdentifier : ID d’objet de l’utilisateur (GUID) ou userPrincipalName (UPN)

Note

Ne m’envoyez pas. Si seul le nom d’affichage est disponible, recherchez d’abord l’utilisateur.

Paramètres facultatifs :

• select: Liste de propriétés séparées par des virgules à renvoyer pour le gestionnaire, telles que id, displayName, mail, jobTitle, userPrincipalName

mcp_graph_listUsers

Récupère une liste d’utilisateurs de l’organisation. Prend en charge les options de requête telles que $select, $filter, $top$orderby. La valeur par défaut ConsistencyLevel est éventuelle.

Paramètres facultatifs :

• Top: Afficher uniquement les n premiers utilisateurs
• select : liste de propriétés de l’utilisateur à renvoyer, séparées par des virgules
• Filtre : Filtrez les utilisateurs par propriété, tels que startswith(displayName,'A')
• Ordonner par : Classer les résultats par la propriété donnée, telle que displayName
• search : recherche en texte libre pour les utilisateurs. Format : « property :value », par exemple displayName:Neha pour rechercher des noms d’affichage contenant Neha. Prend en charge plusieurs propriétés avec des espaces. Règle de secours : si $search échoue ou ne renvoie aucun résultat, réessayer automatiquement avec $filter.
• Compter: Inclure le nombre d’éléments (true ou false)
• ConsistencyLevel : En-tête requis pour les requêtes avancées (valeur par défaut : éventuelle)

Fonctionnalités clés

Connaissance de soi

• Obtenez le profil de l’utilisateur connecté.
• Obtenez le gestionnaire de l’utilisateur connecté.
• Accédez aux informations de contexte utilisateur actuelles.
• Il n’est pas nécessaire d’identifier l’utilisateur.

Profils utilisateur

• Récupérez le profil d’un utilisateur par ID ou UPN.
• Accédez aux propriétés utilisateur telles que displayName, mail, jobTitleet bien plus encore.
• Développez les tables associées telles que manager et directReports.
• Sélectionnez les propriétés à l’aide de $select.

Hiérarchie organisationnelle

• Récupérez le supérieur hiérarchique d’un utilisateur.
• Obtenir les collaborateurs directs d’un utilisateur.
• Parcourez la structure hiérarchique.
• Relations entre le manager et ses collaborateurs directs.

Découverte utilisateur

• Listez les utilisateurs de l’organisation.
• Recherche en texte libre avec basculement automatique.
• Filtrage et classement OData.
• Prise en charge de la pagination.
• Compter les utilisateurs dans les résultats.

Fonctionnalités de requête

• OData $select pour la sélection de propriétés.
• OData $filter pour le filtrage utilisateur.
• OData $expand pour les entités associées.
• OData $orderby pour le tri.
• $search en texte libre avec repli.
• Prise en charge de la cohérence éventuelle.

Remarques

• Utilisez-le mcp_graph_getMyProfile pour l’utilisateur connecté, pas mcp_graph_getUserProfile avec moi.
• Utilisez mcp_graph_getMyManager pour le gestionnaire de l’utilisateur connecté.
• userIdentifier doit être l’identifiant d’objet (GUID) ou userPrincipalName (UPN), n’utilisez pas le nom d’affichage.
• Si seul le nom d’affichage est disponible, utilisez mcp_graph_listUsers pour rechercher d’abord l’utilisateur.
• $expand ne peut développer qu’une seule propriété par requête (manager ou directReports).
• $search bascule automatiquement sur $filter si la recherche échoue.
• ConsistencyLevel éventuellement requis pour les requêtes avancées.
• Format de recherche : « property :value » avec des guillemets.

Cas d’utilisation courants

Obtenir mes informations

• Utilisez-le mcp_graph_getMyProfile pour obtenir le profil de l’utilisateur actuel.
• Utilisez mcp_graph_getMyManager pour obtenir le gestionnaire de l’utilisateur actuel.

Rechercher un utilisateur

• Utilisez mcp_graph_listUsers avec le paramètre de recherche.

  Exemple : search='"displayName:John"' pour rechercher des utilisateurs nommés John.

• Obtenir userPrincipalName ou l’identifiant d’objet à partir des résultats.

Obtenir les détails de l’utilisateur

• utiliser mcp_graph_getUserProfile avec userIdentifier.
• Permet select d’obtenir des propriétés spécifiques.
• À utiliser expand pour inclure manager ou directReports.

Obtenir une structure organisationnelle

• Utilisez mcp_graph_getUsersManager pour obtenir le responsable d’un utilisateur.
• Permet mcp_graph_getDirectReports d’obtenir les rapports directs d’un utilisateur.
• Chaîner les appels pour naviguer dans la hiérarchie de supervision.