Visão geral da inteligência pessoal e de local de trabalho no Microsoft GraphOverview of people and workplace intelligence in 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.The hundreds of millions of users of Microsoft 365 cloud services form part of the core of 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.The users' data is carefully managed, protected, and with proper authorization, made available by Microsoft Graph services to drive productivity and creativity in businesses.

A API de perfil permite que você, como desenvolvedor de aplicativos, modele e represente pessoas nos serviços do Microsoft 365, e a API de cartão de perfil, permite que os administradores controlem as informações mostradas nos cartões de perfil dos usuários na organização.The profile API lets you, as app developers, model and represent people in Microsoft 365 services, and the profile card API lets administrators control the information showing on users' profile cards in the organization.

Mesmo os dados do usuário sendo onipresentes no Microsoft Graph, os dados derivados das interações do usuário são especialmente interessantes.As ubiquitous the user's data is in Microsoft Graph, data derived from the user's social interactions is particularly interesting. Eles fornece informações inteligentes que podem responder a perguntas como:It provides intelligent insights that can answer questions such as the following:

  • "Pesquisar Pessoas cujo nome comece com ‘J’""Search for People who’s name starts with ‘J’"
  • "Quais documentos são interessantes para essa pessoa?""Which documents are most interesting to this person?"

Você pode usar a API de Pessoas e a API do Insights no Microsoft Graph para criar aplicativos mais inteligentes que podem, respectivamente, acessar as pessoas e os documentos relevantes para um usuário.You can use the people API and insights API in Microsoft Graph to build smarter apps that can, respectively, access the relevant people and documents for a user.

A API de Pessoas retorna pessoas ordenadas por relevância para um usuário, com base nos contatos do usuário, redes sociais, diretório da organização e comunicações recentes por email.The people API returns people ordered by relevance to a user, based on that user's contacts, social networks, organization directory, and recent communications on email. Isso é particularmente útil para cenários de seleção de pessoas.This is particularly useful for people-picking scenarios.

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.The insights API uses advanced analytics and machine learning to provide the most relevant files users need throughout their work day. 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.The API powers familiar Microsoft 365 experiences, including Office Delve, SharePoint Home, the Discover view in OneDrive for Business, and Outlook on the 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?Why integrate with people data?

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.The people API returns data of a single entity, person, which includes typical data of an individual in today's business world. O que torna esses dados de pessoa especialmente úteis é sua relevância em relação a um usuário do Microsoft Graph.What makes this person data especially useful is its relevance with respect to a Microsoft Graph user. A relevância é identificada por meio de uma pontuação para cada pessoa, que é calculada com base nos padrões de colaboração e comunicação e nas relações de negócios do usuário.Relevance is noted in a relevance score of each person, calculated based on the user's communication and collaboration patterns and business relationships. Há 3 tipos principais de aplicações para esses dados de relevância .There are 3 main types of application of this relevance data.

Procurar pessoas pela relevânciaBrowse people by relevance

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.You can browse people who are related to the signed-in user or to some other user in the signed-in user's organization, provided you have got the appropriate authorization. Você obtém um conjunto de objetos person ordenados pela relevância.You get a collection of person objects that are ordered by relevance. 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.You can further customize the collection of person objects that is returned in the response by specifying the query parameters top, skip, orderby, select, and filter.

Pesquisas difusas baseadas em critérios de pessoasFuzzy searches based on people criteria

A API de Pessoas permite pesquisar por pessoas relevantes para o usuário conectado, desde que o aplicativo tenha permissões desse usuário.The people API lets you search for people relevant to the signed-in user, provided that your app has got permissions by that user. (Leia mais em permissões de pessoas.)(Read more on people permissions.)

Essas pesquisas retornam resultados com base em uma correspondência exata e também em inferências sobre a intenção da pesquisa.Fuzzy searches return results based on an exact match and also on inferences about the intent of the search. 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".To illustrate this, the following example returns person objects relevant to the signed-in user whose name, or email address , contains a word that starts with 'j'.

GET /me/people/?$search=j

Por que integrar com a API do perfil (visualização)?Why integrate with the profile API (preview)?

A API do perfil representa a próxima geração na modelagem e representa as pessoas nos serviços do Microsoft 365.The profile API represents the next generation in modeling and representing people in Microsoft 365 services. Os dados de perfil podem ser usados em conjunto com os dados das pessoas para criar experiências personalizadas baseado no Microsoft Graph.Profile data can be used together with people data to build customized experiences based on Microsoft Graph.

Por que configurar cartões de perfil em sua organização (visualização)?Why configure profile cards in your organization (preview)?

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.Profile cards let users in an organization see information about one another, such as their names and contact information. 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. Administrators can use the profile card API to customize how information about their organization surfaces within Microsoft 365 people experiences.

Por que integrar-se a informações baseadas em documentos?Why integrate with document-based insights?

Use inteligência para melhorar a colaboraçãoUse intelligence to improve collaboration

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.During a typical work day, users often interact with large amounts of information stored across many documents and collaborate with other users in many different ways. É importante que eles sempre possam encontrar o precisam no momento certo.It's important that they can always can find what they need, when they need it.

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.You can use the insights API, which includes the trending, shared, and used APIs, to surface files from across Microsoft 365 based on your users' current context and needs, making users more productive and improving collaboration in your organization. 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.Organizations can customize privacy settings for these document-based insights, and control the availability of these insights in specific Microsoft 365 experiences.

É fácil renderizar os resultados da API do Insights em seu aplicativo.It is easy to render the results from the insights API in your app. 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.Every result comes with a set of common visualization properties, like a preview image URL or preview text.

Tornar o conteúdo relevante visívelMake relevant content visible

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.In Microsoft 365, Delve uses the trending insight to help users discover the documents that are most interesting to them right now. Veja a Figura 1.See figure 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.Programmatically, you can use the trending entity in the insights API to provide your app customers a similar experience. Use a entidade trending para se conectar aos documentos que mais relevantes para o usuário e mais populares ao seu redor.Use the trending entity to connect to documents that are trending around and relevant to the user. 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.Listing trending documents returns those files stored on OneDrive or SharePoint team sites, sorted by relevance with the most important ones first.

Figura 1. Delve no Microsoft 365 mostrando documentos populares para um usuárioFigure 1. Delve in Microsoft 365 showing popular documents for a user

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

Permitir que os usuários colaborem e voltem ao trabalhoAllow users to collaborate and get back to work

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.The new Microsoft 365 people cards tap into the used and shared insights to connect the dots between people and units of knowledge. O cartão de pessoas identifica e exibe documentos relevantes sobre uma pessoa.The people card identifies and displays relevant documents about a person. Os usuários podem ver cartões de pessoas em todo o pacote Office, por exemplo, no Outlook na Web.Users can see people cards across the suite, for example, in Outlook on the web. Veja a Figura 2.See figure 2.

A API do Insights fornece uma com uma funcionalidade semelhante às entidades used e shared entidades.The insights API provides a similar functionality with the used and shared entities. 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.They return what a user has been viewing or working on most recently, or what colleagues have shared with the user most recently in Microsoft 365.

Figura 2. Outlook na Web, mostrando um cartão de pessoas para um usuárioFigure 2. Outlook on the web showing a people card for a user

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

Por que integrar o MyAnalytics (visualização)?Why integrate with MyAnalytics (preview)?

O myAnalytics fornece uma visão geral de como e com quem as pessoas passam o tempo.MyAnalytics provides insight into how people spend their time and who they spend it with. 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.This data can help people plan their day, gain insights into their different work patterns, and help them balance work and life.

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.The analytics API enables you to synchronize or integrate user analytics data with a custom, third-party app to support a wide range of scenarios that can help improve user productivity and collaboration. Por exemplo, você poderia integrar dados do myAnalytics com atividades de dispositivos móveis para ajudar os usuários a acompanhar todas as atividades de trabalho e social e planejar o seu dia dentro de um aplicativo.For example, you could integrate MyAnalytics data with mobile device activities to help users keep track of all their work and social activities and plan their day all within one app.

Referência da APIAPI reference

Procurando a referência de API para estes serviços?Looking for the API reference for these services?

Próximas etapasNext steps