Referencia de usuario de Work IQ (versión preliminar)

Importante

Esta es una característica en vista previa.

  • Microsoft publica versiones preliminares de las características antes de un lanzamiento oficial para que los clientes puedan tener 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.

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 de Work IQ Servidor MCP para el autoconocimiento y la conciencia organizacional. Usa este servidor MCP para acceder a los perfiles de usuario de su organización y realizar diversas acciones, como obtener su perfil, el perfil de un usuario, el supervisor de un usuario o los 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)

Nota:

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)

Nota:

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, utilice mcp_graph_getMyManager.

Parámetros requeridos:

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

Nota:

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

  • Enumerar usuarios 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.

Funciones de consultas

  • 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

  • Usa mcp_graph_getMyProfile para el usuario que ha iniciado sesión, no mcp_graph_getUserProfile con me.
  • Use mcp_graph_getMyManager para el administrador del usuario que ha iniciado sesión.
  • userIdentifier debe ser el id. de objeto (GUID) o userPrincipalName (UPN), no use el nombre para mostrar.
  • Si solo está disponible el nombre visible, use mcp_graph_listUsers para buscar primero 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

  • Usa mcp_graph_getMyProfile para obtener el perfil del usuario actual.
  • Usa mcp_graph_getMyManager para obtener el administrador del usuario actual.

Búsqueda de un usuario

  • Usamcp_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.
  • Utilice expandir 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.
  • Last updated on