Partilhar via

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

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 utilizador são omnipresentes no Microsoft Graph, os dados derivados das interações do utilizador 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 devolve pessoas ordenadas por relevância para um utilizador, com base nos contactos desse utilizador, no diretório da organização e nas comunicações recentes por e-mail. 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. A API suporta experiências familiares do Microsoft 365, incluindo o SharePoint Home, a vista Descobrir no OneDrive for Business e 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 é notada nos resultados devolvidos que são ordenados dos mais relevantes para os menos relevantes. Pode utilizar as seguintes APIs do Microsoft Graph para procurar pessoas dentro de uma organização.

Utilizar o ponto final /search

Incentivamos os programadores a utilizar o /search ponto final ao criar os seus produtos; o /people ponto final está no modo de manutenção. Seguem-se razões para considerar a utilização do /search ponto final:

  • Todos os investimentos futuros na pesquisa de pessoas serão disponibilizados através /searchdo ; por exemplo, pesquisa em linguagem natural como "João, o contabilista em Nairobi".
  • A pesquisa de atributos correspondente a atributos que não o nome e o e-mail está disponível.
  • Os melhores resultados por relevância dão /search melhores resultados devido à utilização de inteligência artificial, melhores modelos de dados e correção ortográfica sofisticada.
  • Menor custo dos bens ao utilizar /search, mas especificamente menor latência.

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.

Porquê configurar cartões de perfil na 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.

Porquê configurar pronomes na sua organização?

Os pronomes servem como substitutos do nome de uma pessoa em frases, com versões neutras em termos de género disponíveis em vários idiomas, por exemplo, em inglês, "ela", "ela", "ele", "ele" e o "eles" neutros em termos de género, "eles". A utilização precisa do pronome mostra inclusividade e respeito, evitando pressupostos com base em nomes ou observações iniciais da pessoa. Num ambiente híbrido, multicultural de trabalho ou escolar, o simples ato de utilizar os pronomes certos pode ajudar a criar confiança e melhorar a comunicação entre si. Os administradores podem utilizar a API pronounsSettings para configurar as definições de pronomes na sua organização.

Porquê configurar origens de perfil na sua organização?

A configuração da origem de perfil permite que os utilizadores numa organização identifiquem a origem dos dados de perfil mostrados nas experiências do Microsoft 365. Os administradores podem personalizar o aspeto das propriedades displayName e webUrl numa origem de perfil através de um conjunto de traduções alternativas para os idiomas suportados na organização.

Porquê configurar a precedência da origem do perfil na sua organização?

A precedência da origem de perfil permite que os administradores controlem a forma como os dados de perfil são apresentados nas experiências do Microsoft 365. Quando várias origens fornecem dados sobrepostos, os administradores podem definir a origem autoritativa dos dados de perfil ao configurar a ordem da prioridade da origem de dados com a API profilePropertySetting . Para obter mais informações, veja Gerir definições de precedência de origem de perfil para uma organização com o Microsoft API do Graph (pré-visualizaçã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.

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 a mostrar um card de pessoas para um utilizador

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

Porquê integrar com Microsoft Viva Insights (pré-visualização)?

Microsoft Viva Insights fornece informações sobre como as pessoas passam o seu tempo e com quem o 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, pode integrar Viva Insights dados com atividades de dispositivos móveis para ajudar os utilizadores a controlar todo o trabalho e atividades sociais e planear o dia todo numa aplicação.

Referência da API

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

Próximas etapas

  • Last updated on