Manual de referência do utilizador do Work IQ (pré-visualização)

Importante

Esta é uma funcionalidade de pré-visualização.

  • A Microsoft lança funcionalidades de pré-visualização antes do lançamento oficial para que os clientes possam obter acesso antecipado e fornecer feedback.
  • As funcionalidades de pré-visualização têm funcionalidades restritas e não são feitas para uso em produção.
  • A Microsoft pode alterar os nomes e parâmetros das ferramentas MCP de pré-visualização. Evite dependências codificadas de forma rígida. A Microsoft mantém suporte a cenários.
  • As funcionalidades de pré-visualização estão sujeitas a Microsoft termos suplementares de utilização.

Overview

ID do servidor URL ao nível do inquilino Nome de exibição Descrição
mcp_MeServer https://agent365.svc.cloud.microsoft/agents/
tenants/{tenantId}/servers/mcp_MeServer		 Utilizador do Work IQ Servidor MCP para autoconhecimento e consciência organizacional. Use este servidor MCP para aceder a perfis de utilizador na sua organização e realizar várias ações, como obter o seu perfil, o perfil de um utilizador, o gestor de um utilizador ou subordinados diretos.

Ferramentas disponíveis

mcp_graph_getDirectReports

Lista os subordinados diretos de um utilizador especificado no diretório. Tem de fornecer o ID de objeto (GUID) do utilizador ou o UPN userPrincipalName do utilizador (semelhante a um endereço de e-mail). Não use me como o userIdentifier.

Parâmetros necessários:

  • userIdentifier: ID do objeto do utilizador (GUID) ou userPrincipalName (UPN)

Note

Não envie me como userIdentifier. Se apenas o nome de exibição estiver disponível, primeiro procure o utilizador para obter o userPrincipalName ou o ID do objeto.

Parâmetros opcionais:

  • selecionar: Lista separada por vírgulas de propriedades a devolver (por exemplo, id, displayName, mail, jobTitle, userPrincipalName)
  • Máximo: Número de itens a retornar por página

mcp_graph_getMyManager

Recupera o gestor do utilizador iniciado (o chamador). Este endpoint devolve sempre o gestor do contexto do utilizador atual.

Parâmetros opcionais:

  • selecionar: Lista separada por vírgulas das propriedades do gestor a devolver

mcp_graph_getMyProfile

Obtém os detalhes do perfil do utilizador com sessão iniciada (o autor da chamada). Este endpoint devolve sempre o perfil do contexto do utilizador atual.

Parâmetros opcionais:

  • selecionar: Lista separada por vírgulas das propriedades do perfil do utilizador
  • expandir: Expandir tabelas relacionadas (por exemplo, gestor, directReports)

mcp_graph_getUserProfile

Recupera o perfil de um utilizador especificado no diretório. Tem de fornecer ou o ID de objeto (GUID) do utilizador ou o seu userPrincipalName (UPN semelhante a um endereço de e-mail). Não use me como o userIdentifier. Para o utilizador iniciado em sessão, use mcp_graph_getMyProfile.

Parâmetros necessários:

  • userIdentifier: ID do objeto do utilizador (GUID) ou userPrincipalName (UPN)

Note

Não me envies. Se apenas o nome de exibição estiver disponível, primeiro, pesquise o utilizador.

Parâmetros opcionais:

  • selecionar: Lista separada por vírgulas das propriedades do utilizador a devolver
  • expandir: Expanda uma tabela relacionada (manager OU directReports). Só pode expandir uma propriedade por pedido.

mcp_graph_getUsersManager

Recupera o gestor de um utilizador especificado no diretório. Fornece o ID do objeto (GUID) do utilizador ou o seu userPrincipalName UPN (semelhante a email). Não use me como o userIdentifier. Para o utilizador iniciado em sessão, use mcp_graph_getMyManager.

Parâmetros necessários:

  • userIdentifier: ID do objeto do utilizador (GUID) ou userPrincipalName (UPN)

Note

Não me envies. Se apenas o nome de exibição estiver disponível, primeiro procura o utilizador.

Parâmetros opcionais:

  • selecionar: Lista separada por vírgulas de propriedades a devolver para o gestor, como id, displayName, mail, jobTitle, userPrincipalName

mcp_graph_listUsers

Recupera uma lista de utilizadores na organização. Suporta opções de consulta como $select, $filter, $top, $orderby. O padrão ConsistencyLevel é eventual.

Parâmetros opcionais:

  • top: Mostrar apenas os primeiros n utilizadores
  • selecionar: Lista separada por vírgulas das propriedades do utilizador a devolver
  • Filtro: Filtrar utilizadores por propriedade, tais como startswith(displayName,'A')
  • orderby: Ordena os resultados pela propriedade especificada, tal como displayName
  • Pesquisa: Pesquisa em texto livre para utilizadores. Formato: "property:value", como displayName:Neha para pesquisar nomes apresentados que contenham Neha. Suporta múltiplas propriedades com espaços. Regra de recurso: Se $search falhar ou não apresentar resultados, tente automaticamente com $filter.
  • Número: Incluir o número de itens (verdadeiro ou falso)
  • Nível de Consistência: Cabeçalho obrigatório para consultas avançadas (predefinido: eventual)

Principais características

Autoconhecimento

  • Obter o perfil do utilizador autenticado.
  • Obtenha o gestor do utilizador com sessão de registo.
  • Aceda à informação de contexto do utilizador atual.
  • Não são necessários identificadores de utilizador.

Perfis de utilizador

  • Recupere o perfil de qualquer utilizador por ID ou UPN.
  • Aceda a propriedades dos utilizadores como displayName, mail, , jobTitlee outras.
  • Expandir tabelas relacionadas como manager e directReports.
  • Selecione propriedades usando $select.

Hierarquia organizacional

  • Arranja um gestor de utilizadores.
  • Obtenha os subordinados diretos de um utilizador.
  • Navegue pela estrutura de reporte.
  • Relações entre gestores e subordinados diretos.

Descoberta do utilizador

  • Liste os utilizadores na organização.
  • Pesquisa de texto livre com alternativa automática.
  • Filtragem e ordenação do OData.
  • Suporte para paginação.
  • Contar utilizadores nos resultados.

Capacidades de consulta

  • OData $select para selecionar propriedades.
  • OData $filter para filtragem de utilizadores.
  • OData $expand para entidades relacionadas.
  • OData $orderby para ordenação.
  • Texto livre $search com recurso de contingência.
  • Apoio à consistência eventual.

Notes

  • Utilize mcp_graph_getMyProfile para utilizadores com sessão iniciada, não mcp_graph_getUserProfile com mim.
  • Utilize mcp_graph_getMyManager para o gestor do utilizador com sessão iniciada.
  • userIdentifier deve ser o ID do objeto (GUID) ou userPrincipalName (UPN), não usar nome de visualização.
  • Se apenas estiver disponível o nome a apresentar, utilize mcp_graph_listUsers para procurar primeiro o utilizador.
  • $expand Só pode expandir uma propriedade por pedido (manager ou directReports).
  • $search tem recurso automático a $filter se a pesquisa falhar.
  • ConsistencyLevel é eventualmente necessário para consultas avançadas.
  • Formato de pesquisa: "property:value" com aspas.

Casos comuns de utilização

Obter as minhas informações

  • Usa mcp_graph_getMyProfile para obter o perfil do utilizador atual.
  • Usa mcp_graph_getMyManager para obter o superior hierárquico do utilizador atual.

Encontrar um utilizador

  • Utilizamcp_graph_listUsers com o parâmetro de pesquisa.

    Exemplo: search='"displayName:John"' para encontrar utilizadores chamados John.

  • Obtenha userPrincipalName ou o ID do objeto dos resultados.

Obter detalhes do utilizador

  • Utilizar o mcp_graph_getUserProfile com o userIdentifier.
  • Use select para adquirir propriedades específicas.
  • Use expandir para incluir manager ou directReports

Obter a estrutura organizacional

  • Uso mcp_graph_getUsersManager para obter um gestor de utilizadores.
  • Utilize mcp_graph_getDirectReports para obter os subordinados diretos de um utilizador.
  • Chamadas em cadeia para navegar pela hierarquia de relatórios.
  • Last updated on