Referência do usuário do Work IQ (prévia)

Overview

Ferramentas disponíveis

mcp_graph_getDirectReports

Lista os relatórios diretos de um usuário especificado no diretório. Você deve fornecer a ID do objeto (GUID) do usuário ou seu userPrincipalName (UPN semelhante a um email). Não use me como o userIdentifier.

Parâmetros requeridos:

• IdentificadorUsuário: ID de objeto do usuário (GUID) ou userPrincipalName (UPN)

Parâmetros opcionais:

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

mcp_graph_getMyManager

Obtém o gerente do usuário conectado (o chamador). Este ponto de extremidade sempre retorna o gerente do contexto do usuário atual.

Parâmetros opcionais:

• select: lista separada por vírgulas das propriedades do gerenciador para devolver

mcp_graph_getMyProfile

Recupera os detalhes do perfil do usuário conectado (o chamador). O endpoint sempre retorna o perfil do contexto do usuário atual.

Parâmetros opcionais:

• select: lista separada por vírgulas das propriedades do perfil do usuário
• expandir: Expandir tabelas relacionadas (por exemplo, gerente, directReports)

mcp_graph_getUserProfile

Recupera o perfil de um usuário especificado no diretório. Você deve fornecer a ID do objeto (GUID) do usuário ou seu userPrincipalName (UPN semelhante a um email). Não use me como o userIdentifier. Para o usuário conectado, use mcp_graph_getMyProfile.

Parâmetros requeridos:

• IdentificadorUsuário: ID de objeto do usuário (GUID) ou userPrincipalName (UPN)

Parâmetros opcionais:

• select: lista separada por vírgulas das propriedades do usuário para devolver
• expandir: Expandir uma tabela relacionada (gerente OU directReports). Você pode expandir apenas uma propriedade por pedido.

mcp_graph_getUsersManager

Recupera o gerente de um usuário especificado no diretório. Forneça o ID do objeto (GUID) do usuário ou o userPrincipalName dele (UPN semelhante a um email). Não use me como o userIdentifier. Para o usuário conectado, use mcp_graph_getMyManager.

Parâmetros requeridos:

• IdentificadorUsuário: ID de objeto do usuário (GUID) ou userPrincipalName (UPN)

Parâmetros opcionais:

• Selecione: Lista separada por vírgulas de propriedades a serem retornadas para o gerente, comoid, , displayName, mail, , jobTitleuserPrincipalName

mcp_graph_listUsers

Recupera uma lista de usuários na organização. Dá suporte a opções de consulta como $select, , $filter, $top, $orderby. O ConsistencyLevel padrão é eventual.

Parâmetros opcionais:

• Topo: Mostrar somente os primeiros n utilizadores
• select: lista separada por vírgulas das propriedades do usuário para devolver
• Filtrar: Filtrar usuários por propriedade, como startswith(displayName,'A')
• orderby: Ordenar resultados por determinada propriedade, como displayName
• busca: Busca em texto livre para usuários. Formato: "property:value", como displayName:Neha para pesquisar nomes de exibição que contêm Neha. Suporta múltiplas propriedades com espaços. Regra de fallback: se $search falhar ou não retornar resultados, tente novamente automaticamente com $filter.
• Contagem: Incluir contagem de itens (true ou false)
• ConsistencyLevel: Cabeçalho necessário para consultas avançadas (padrão: eventual)

Características principais

Autoconhecimento

• Obtenha o perfil do usuário conectado.
• Obtenha o gestor do usuário autenticado.
• Acesse as informações de contexto do usuário atual.
• Não há necessidade de identificadores de usuário.

Perfis de usuário

• Recupere o perfil de qualquer usuário por ID ou UPN.
• Acesse propriedades do usuário, como displayName, maile jobTitlemuito mais.
• Expanda tabelas relacionadas, como manager e directReports.
• Selecione propriedades usando $select.

Hierarquia organizacional

• Obter um gerente do usuário.
• Obtenha relatórios diretos do usuário.
• Navegue pela estrutura de relatórios.
• Relações entre gerente e subordinado direto.

Identificação do usuário

• Listar usuários na organização.
• Pesquisa em texto livre com alternativa automática.
• Filtragem e ordenação do OData.
• Suporte à paginação.
• Contar usuários nos resultados.

Capacidades de consulta

• OData $select para seleção de propriedades.
• O OData $filter para filtragem de usuário.
• OData $expand para entidades relacionadas.
• $orderby de OData para classificação.
• $search de texto livre com fallback.
• Suporte de consistência eventual.

Notes

• Use mcp_graph_getMyProfile para usuário conectado, não mcp_graph_getUserProfile para mim.
• Use mcp_graph_getMyManager para o gestor do usuário conectado.
• userIdentifier deve ser GUID (ID do objeto) ou userPrincipalName (UPN), não use o nome de exibição.
• Se apenas o nome de exibição estiver disponível, use mcp_graph_listUsers para primeiro localizar o usuário.
• $expand só pode expandir uma propriedade por solicitação (manager ou directReports).
• $search tem fallback automático para $filter se a pesquisa falhar.
• ConsistencyLevel eventual necessário para consultas avançadas.
• Formato de pesquisa: "property:value" com aspas.

Casos de uso comuns

Obter minhas informações

• Usa mcp_graph_getMyProfile para obter o perfil do usuário atual.
• Usa mcp_graph_getMyManager para obter o gerente do usuário atual.

Localizar um usuário

• Usa-se mcp_graph_listUsers com o parâmetro de pesquisa.

  Exemplo: search='"displayName:John"' para localizar usuários chamados John.

• Obter userPrincipalName ou ID do objeto dos resultados.

Obter detalhes do usuário

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

Obter estrutura organizacional

• Use mcp_graph_getUsersManager para obter o gerente do usuário.
• Use mcp_graph_getDirectReports para obter os relatórios diretos de um usuário.
• Encadeie chamadas para navegar na hierarquia de relatórios.