Referencia de usuario (vista previa)

Note

Este artículo describe características utilizadas en agentes o flujos de agentes alimentados por el arnés estándar.

Importante

Esta es una función de vista previa.

• Microsoft publica características en versión preliminar antes de su lanzamiento oficial para que los clientes puedan obtener acceso anticipado y enviar comentarios.
• Las características en versión preliminar tienen funcionalidad restringida y no están pensadas para su uso en producción.
• Microsoft podría cambiar los nombres y parámetros de la herramienta MCP en versión preliminar. Evite las dependencias codificadas de forma rígida. Microsoft mantiene la compatibilidad con escenarios.
• Las características en versión preliminar se rigen por los términos de uso adicionales de Microsoft.

Note

Las herramientas MCP específicas de Microsoft 365 (Copilot, Calendar, Mail, SharePoint, OneDrive, Teams, User y Word) solo están pensadas para fines de compatibilidad hacia atrás y no deben usarse en entornos de producción ni en proyectos nuevos. Para proyectos nuevos que requieren acceso a recursos de Microsoft 365, utiliza Work IQ MCP con el arnés GitHub Copilot. Para más información, véase Work IQ MCP en Copilot Studio.

Overview

Id. de servidor	Dirección URL a nivel de arrendatario	Nombre para mostrar	Description
mcp_MeServer	https://agent365.svc.cloud.microsoft/agents/ tenants/{tenantId}/servers/mcp_MeServer	Usuario	Herramientas para el autoconocimiento y la conciencia organizativa. Utiliza esta herramienta para acceder a perfiles de usuario en tu organización y realizar diversas acciones, como obtener tu perfil, el perfil de un usuario, el gestor de un usuario o subordinados directos.

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)

Note

No envíe me como userIdentifier. Si solo hay un nombre para mostrar disponible, busque primero el usuario para obtener userPrincipalName o el Id. de objeto.

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 punto de conexión 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)

Note

No me envíes. Si solo hay un nombre para mostrar disponible, busque primero el usuario.

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)

Note

No me envíes. Si solo hay un nombre para mostrar disponible, busque primero el usuario.

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_listUsers

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 clave

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

• Obtenga 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.
• $search de texto libre con reserva.
• Compatibilidad con la coherencia final.

Notas

• Use mcp_graph_getMyProfile para usuarios conectados, no mcp_graph_getUserProfile con me.
• Ú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 hay un nombre para mostrar disponible, use mcp_graph_listUsers para buscar primero el 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.
• Use mcp_graph_getMyManager para obtener el administrador 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.
• Cadenas de llamadas para navegar por la jerarquía de informes.