Referencia de usuario (vista previa)

Información general

Herramientas disponibles

mcp_graph_getDirectReports

Enumera los informes directos de un usuario especificado en el directorio. Debes proporcionar el ID de objeto (GUID) del usuario o su userPrincipalName UPN (tipo correo electrónico). No use me como userIdentifier.

Parámetros requeridos:

• Identificador de usuario: ID de objeto del usuario (GUID) o userPrincipalName (UPN)

Parámetros opcionales:

• seleccionar: Lista separada por comas de propiedades que deben devolver (por ejemplo, id, displayName, mail, jobTitle, userPrincipalName)
• top: número de elementos que se van a devolver por página

mcp_graph_getMyManager

Recupera el administrador del usuario que ha iniciado sesión (el autor de la llamada). Este extremo siempre devuelve el administrador del contexto de usuario actual.

Parámetros opcionales:

• select: lista de propiedades del administrador separada por comas que se van a devolver

mcp_graph_getMyProfile

Recupera los detalles del perfil del usuario que ha iniciado sesión (el autor de la llamada). Este punto de conexión siempre devuelve el perfil del contexto de usuario actual.

Parámetros opcionales:

• select: lista separada por comas de propiedades de perfil de usuario
• Ampliar: Expande tablas relacionadas (por ejemplo, gestor, directReports)

mcp_graph_getUserProfile

Recupera el perfil de un usuario especificado en el directorio . Debes proporcionar el ID de objeto (GUID) del usuario o su userPrincipalName UPN (tipo correo electrónico). No use me como userIdentifier. Para el usuario que ha iniciado sesión, use mcp_graph_getMyProfile.

Parámetros requeridos:

• Identificador de usuario: ID de objeto del usuario (GUID) o userPrincipalName (UPN)

Parámetros opcionales:

• select: lista separada por comas de propiedades de usuario que se van a devolver
• Ampliar: Amplía una tabla relacionada (manager O directReports). Solo puede expandir una propiedad por solicitud.

mcp_graph_getUsersManager

Recupera el administrador de un usuario especificado en el directorio . Proporcione el identificador de objeto (GUID) del usuario o su userPrincipalName (UPN similar al correo electrónico). No use me como userIdentifier. Para el usuario que ha iniciado sesión, use mcp_graph_getMyManager.

Parámetros requeridos:

• Identificador de usuario: ID de objeto del usuario (GUID) o userPrincipalName (UPN)

Parámetros opcionales:

• seleccione: Lista separada por comas de propiedades que se van a devolver para el administrador, como id, displayName, mail, , , jobTitleuserPrincipalName

mcp_graph_listarUsuarios

Recupera una lista de usuarios de la organización. Admite opciones de consulta como $select, $filter, $top, . $orderby El valor predeterminado ConsistencyLevel es eventual.

Parámetros opcionales:

• Arriba: Mostrar solo los primeros n usuarios
• select: lista separada por comas de propiedades de usuario que se van a devolver
• Filtrar: Filtra usuarios por propiedad, como startswith(displayName,'A')
• ordenar: Ordenar los resultados por la propiedad dada, como displayName
• search: búsqueda de texto libre para los usuarios. Formato: "property:value", como displayName:Neha para buscar nombres para mostrar que contengan Neha. Admite varias propiedades con espacios. Regla de respaldo: Si $search falla o no devuelve ningún resultado, reintentar automáticamente con $filter.
• count: Incluir recuento de elementos (true o false)
• ConsistencyLevel: Encabezado obligatorio para consultas avanzadas (valor predeterminado: eventual)

Características principales

Autoconocimiento

• Obtiene el perfil del usuario que ha iniciado sesión.
• Obtenga el administrador del usuario que ha iniciado sesión.
• Acceda a la información de contexto del usuario actual.
• No es necesario usar identificadores de usuario.

Perfiles de usuario

• Recupere el perfil de cualquier usuario por identificador o UPN.
• Acceda a las propiedades de usuario como displayName, mail, jobTitley mucho más.
• Expanda tablas relacionadas como manager y directReports.
• Seleccione las propiedades mediante $select.

Jerarquía organizativa

• Obtener el administrador de un usuario.
• Descubra quiénes son los subordinados directos del usuario.
• Navegue por la estructura de informes.
• Relaciones entre responsables y subordinados directos.

Descubrimiento por parte del usuario

• Haz una lista de usuarios dentro de la organización.
• Búsqueda de texto libre con alternativa automática.
• Filtrado y ordenación de OData.
• Compatibilidad con la paginación.
• Contar usuarios en los resultados.

Funcionalidades de consulta

• OData $select para la selección de propiedades.
• OData $filter para el filtrado de usuarios.
• OData $expand para entidades relacionadas.
• OData $orderby para la ordenación.
• Búsqueda $search de texto libre con alternativa.
• Compatibilidad con la coherencia eventual.

Notas

• Úsalo mcp_graph_getMyProfile para el usuario que ha iniciado sesión, no mcp_graph_getUserProfileconmigo.
• Úsala mcp_graph_getMyManager para el gestor de usuarios con inicio de sesión.
• userIdentifier debe ser ID de objeto (GUID) o userPrincipalName (UPN), no usar nombre de visualización.
• Si solo está disponible el nombre para mostrar, use mcp_graph_listUsers primero para buscar al usuario.
• $expand solo puede expandir una propiedad por solicitud (manager o directReports).
• $search recurre automáticamente a $filter si falla la búsqueda.
• ConsistencyLevel eventual necesario para las consultas avanzadas.
• Formato de búsqueda: "property:value" con comillas.

Casos de uso comunes

Obtener mi información

• Úsalo mcp_graph_getMyProfile para obtener el perfil del usuario actual.
• Úsalo mcp_graph_getMyManager para obtener el gestor del usuario actual.

Búsqueda de un usuario

• Usa mcp_graph_listUsers con el parámetro de búsqueda.

  Ejemplo: search='"displayName:John"' para buscar usuarios denominados John.

• Obtenga userPrincipalName o el identificador del objeto a partir de los resultados.

Obtención de detalles del usuario

• Usar mcp_graph_getUserProfile con userIdentifier.
• Use select para obtener propiedades específicas.
• Úsase expand para incluir manager o directReports.

Obtención de la estructura organizativa

• Use mcp_graph_getUsersManager para obtener el administrador de un usuario.
• Use mcp_graph_getDirectReports para obtener los informes directos de un usuario.
• Encadenar llamadas para navegar por la jerarquía de informes.