Compartilhar via

Inteligência de pessoas e no local de trabalho no Microsoft Graph

  • Artigo

As centenas de milhões de usuários que utilizam os serviços de nuvem do Microsoft 365 fazem parte do núcleo do Microsoft Graph. Os dados dos usuários são cuidadosamente gerenciados, protegidos e, com a autorização adequada, disponibilizados pelos serviços do Microsoft Graph para promover a criatividade e a produtividade em empresas.

A API de perfil permite que você, como desenvolvedores de aplicativos, modele e represente pessoas nos serviços do Microsoft 365, e a API do cartão de perfil permite que os administradores controlem as informações exibidas nos cartões de perfil dos usuários na organização.

Como os dados do usuário são onipresentes no Microsoft Graph, os dados derivados das interações do usuário são particularmente interessantes. Eles fornece informações inteligentes que podem responder a perguntas como:

  • "Pesquisar Pessoas cujo nome comece com ‘J’"
  • "Quais documentos são interessantes para essa pessoa?"

Você pode utilizar a API de pessoas e a API de insights no Microsoft Graph para criar aplicativos mais inteligentes que podem, respectivamente, acessar pessoas e documentos relevantes para um usuário.

A API de pessoas retorna pessoas ordenadas por relevância para um usuário, com base nos contatos, no diretório da organização e nas comunicações recentes no email. Isso é particularmente útil para cenários de seleção de pessoas.

A API do Insights usa análises e avançadas e o aprendizado de máquina para fornecer os arquivos mais relevantes de que os usuários precisam ao longo de seu dia de trabalho. Essa API capacita experiências familiares do Microsoft 365, incluindo o Office Delve, a página inicial do SharePoint, o modo de exibição Descoberta do OneDrive for Business e o Outlook na Web.

As APIs de Pessoas e do Insights retornam pessoas e documentos relevantes para um usuário

Por que se integrar com dados de pessoas?

A API de Pessoas retorna dados de uma única entidade, person, que inclui dados típicos de um indivíduo no mundo de negócios de hoje. O que torna esses dados de pessoa especialmente úteis é sua relevância em relação a um usuário do Microsoft Graph. A relevância é observada nos resultados retornados que são ordenados do mais relevante para o menos relevante. Você pode usar as seguintes APIs do Microsoft Graph para pesquisar pessoas dentro de uma organização.

Usar o ponto de extremidade /search

Incentivamos os desenvolvedores a usar o /search ponto de extremidade ao criar seus produtos; o /people ponto de extremidade está no modo de manutenção. Veja a seguir os motivos para considerar o uso do /search ponto de extremidade:

  • Todos os investimentos futuros na pesquisa de pessoas serão disponibilizados por meio /searchde ; por exemplo, pesquisa de linguagem natural como "John, o contador em Nairóbi".
  • A correspondência da pesquisa de atributos em atributos diferentes de nome e email está disponível.
  • Melhores resultados de /search relevância dão melhores resultados devido ao uso de inteligência artificial, melhores modelos de dados e correção ortográfica sofisticada.
  • Menor custo de mercadorias ao usar /search, mas especificamente latência menor.

Procurar pessoas pela relevância

Você pode procurar pessoas que estão relacionadas ao usuário conectado ou a outro usuário na organização do usuário conectado, desde que você tenha a autorização apropriada. Você obtém um conjunto de objetos person ordenados pela relevância. Você pode personalizar mais a coleção de objetos person retornados na resposta ao especificar os parâmetros de consulta top, skip, orderby, select e filter.

Pesquisas difusas baseadas em critérios de pessoas

A API de Pessoas permite pesquisar por pessoas relevantes para o usuário conectado, desde que o aplicativo tenha permissões desse usuário. (Leia mais em permissões de pessoas.)

Essas pesquisas retornam resultados com base em uma correspondência exata e também em inferências sobre a intenção da pesquisa. Para ilustrar isso, o exemplo a seguir retorna objetos person relevantes para o usuário conectado cujo nome ou endereço de email contém uma palavra que começa com "j".

GET /me/people/?$search=j

Por que integrar com a API do perfil (visualização)?

A API do perfil representa a próxima geração na modelagem e representa as pessoas nos serviços do Microsoft 365. Os dados de perfil podem ser usados em conjunto com os dados das pessoas para criar experiências personalizadas baseado no Microsoft Graph.

Por que configurar cartões de perfil em sua organização?

Os cartões de perfil permitem que os usuários em uma organização confiram informações sobre eles, como nomes e informações de contato. Os administradores podem usar a API de cartão de perfil para personalizar a forma como as informações sobre sua organização surgem dentro das experiências das pessoas do Microsoft 365.

Por que configurar pronomes em sua organização?

Os pronomes servem como substitutos para o nome de uma pessoa em frases, com versões neutras de gênero disponíveis em vários idiomas, por exemplo, em inglês, "ela", "ela, "ele", "ele" e o gênero neutro "eles", "eles". O uso preciso do pronome mostra inclusividade e respeito, evitando suposições com base em nomes ou observações iniciais da pessoa. Em um ambiente híbrido, multicultural ou escolar, o simples ato de usar os pronomes certos pode ajudar a criar confiança e melhorar a comunicação entre si. Os administradores podem usar a API pronomesSettings para configurar as configurações de pronomes em sua organização.

Por que integrar-se a informações baseadas em documentos?

Use inteligência para melhorar a colaboração

Durante um dia de trabalho típico, usuários frequentemente interagem com grandes quantidades de informações armazenadas em muitos documentos e colaboram com outros usuários de muitas maneiras diferentes. É importante que eles sempre possam encontrar o que precisam no momento certo.

Você pode usar a API do Insights, que inclui as APIs trending, shared e used para localizar arquivos no Microsoft 365 com base no contexto e nas necessidades atuais dos seus usuários, tornando os usuários mais produtivos e melhorando a colaboração em sua organização. As organizações podem personalizar as configurações de privacidade para essas informações baseadas em documentos e controlar a disponibilidade dessas informações em experiências específicas do Microsoft 365.

É fácil renderizar os resultados da API do Insights em seu aplicativo. Cada resultado acompanha um conjunto de propriedades de visualização comuns, como uma URL de imagem de visualização ou um texto de visualização.

Tornar o conteúdo relevante visível

No Microsoft 365, o Delve usa informações de tendências para ajudar os usuários a descobrir os documentos que são mais interessantes para eles no momento. Veja a Figura 1.

É possível usar a entidade trending de forma programática na API do Insights para proporcionar uma experiência semelhante aos clientes do seu aplicativo. Use a entidade trending para se conectar aos documentos que mais relevantes para o usuário e mais populares ao seu redor. A opção Listar documentos mais populares retornará arquivos armazenados em sites de equipe do SharePoint ou no OneDrive, classificados por relevância, com os mais importantes primeiro.

Figura 1. Mergulhe no Microsoft 365 mostrando documentos populares para um usuário

Captura de tela do Delve no Microsoft 365 mostrando documentos populares para um usuário

Permitir que os usuários colaborem e voltem ao trabalho

Os novos cartões de pessoas do Microsoft 365 utilizam as informações used e shared para conectar os dados entre pessoas e informações. O cartão de pessoas identifica e exibe documentos relevantes sobre uma pessoa. Os usuários podem ver cartões de pessoas em todo o pacote Office, por exemplo, no Outlook na Web. Veja a Figura 2.

A API do Insights fornece uma com uma funcionalidade semelhante às entidades used e shared entidades. Elas retornam o que um usuário tem visualizado e trabalhado mais recentemente, ou o que colegas compartilharam com o usuário mais recentemente no Microsoft 365.

Figura 2. Outlook na Web mostrando um cartão de pessoas para um usuário

Captura de tela de um cartão de pessoas para um usuário no Outlook na Web, mostrando os arquivos recentes

Por que integrar com Microsoft Viva Insights (versão prévia)?

Microsoft Viva Insights fornece informações sobre como as pessoas passam seu tempo e com quem passam. Esses dados podem ajudar as pessoas a planejar o dia, obter informações sobre seus diferentes padrões de trabalho e ajudar a equilibrar o trabalho e a vida.

A API de análises permite a sincronização ou a integração de dados de análise do usuário com um aplicativo de terceiros personalizado para oferecer suporte a uma ampla variedade de cenários que podem ajudar a melhorar a produtividade e a colaboração do usuário. Por exemplo, você pode integrar Viva Insights dados com atividades de dispositivo móvel para ajudar os usuários a acompanhar todas as atividades de trabalho e sociais e planejar o dia todo em um aplicativo.

Referência da API

Procurando a referência de API para estes serviços?

Próximas etapas