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

Visão geral

Ferramentas disponíveis

mcp_graph_getDirectReports

Liste os subordinados diretos de um usuário especificado no diretório. Você deve fornecer o ID do objeto (GUID) do usuário ou seu userPrincipalName UPN (semelhante a um e-mail). Não use 'eu' como o userIdentifier.

Parâmetros obrigatórios

• 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

Recupere o gerente do usuário logado (o chamador). Este endpoint 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

Recupere os dados do perfil do usuário logado (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

Recupere o perfil de um usuário especificado no diretório. Você deve fornecer o ID do objeto (GUID) do usuário ou seu userPrincipalName UPN (semelhante a um e-mail). Não use 'me' como userIdentifier - use mcp_graph_getMyProfile para o usuário logado.

Parâmetros obrigatórios

• 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

Recupere o gerenciador de um usuário especificado no diretório. Você deve fornecer o ID do objeto (GUID) do usuário ou seu userPrincipalName UPN (semelhante a um e-mail). Não use 'me' como userIdentifier - use mcp_graph_getMyManager para o usuário logado.

Parâmetros obrigatórios

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

Parâmetros opcionais:

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

mcp_graph_listUsers

Obter uma lista de usuários na organização Suporta opções de consulta como $select, $filter, $top $orderby. ConsistencyLevel é definido como eventual por padrão.

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)

Recursos principais

Autoconhecimento

• Obter o perfil do usuário conectado
• Obtenha o gerenciador de usuários logados
• 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
• Access propriedades do usuário (displayName, mail, jobTitle etc.)
• Expandir tabelas relacionadas (manager, directReports)
• Seleção de propriedades com $select

Hierarquia organizacional

• Obter um gerenciador de usuário
• Obtenha os subordinados diretos do usuário
• Navegar pela estrutura de relatórios
• Relacionamentos entre gerente e subordinado direto

Identificação do usuário

• Listar usuários na organização
• Busca em texto livre com recurso de contingência automático
• Filtragem e ordenação OData
• Suporte à paginação
• Conte usuários nos resultados

Capacidades de consulta

• OData $select para seleção de propriedades
• OData $filter para filtragem de usuários
• OData $expand para entidades relacionadas
• OData $orderby para ordenação
• $search de texto livre com alternativa
• Suporte à consistência eventual

Notas

• Usar mcp_graph_getMyProfile para usuário logado, não mcp_graph_getUserProfile com mim
• Uso mcp_graph_getMyManager para o gerenciador de usuários logados
• userIdentifier deve ser o ID do objeto (GUID) ou userPrincipalName (UPN), não use nome de exibição
• Se apenas o nome de exibição estiver disponível, use mcp_graph_listUsers para consultar o usuário primeiro
• $expand só pode expandir uma propriedade por solicitação (manager ou directReports)
• $search possui 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

• Uso mcp_graph_getMyProfile para obter o perfil do usuário atual
• Uso mcp_graph_getMyManager para obter o gerenciador do usuário atual

Localizar um usuário

• Uso mcp_graph_listUsers com parâmetro de busca

  Exemplo: busque='"displayName:John"' para encontrar usuários chamados John

• Obter userPrincipalName ou ID do objeto a partir dos resultados

Obter detalhes do usuário

• Usar mcp_graph_getUserProfile com userIdentifier
• Escolha Propriedades para obter detalhes específicos.
• Use expandir para incluir manager ou directReports

Obter a estrutura organizacional

• Uso mcp_graph_getUsersManager para conseguir um gerenciador de usuários
• Utilize mcp_graph_getDirectReports para obter os relatórios diretos de um usuário
• Chamadas em cadeia para navegar pela hierarquia de relatórios