Microsoft Graph 中的人员和工作场所智能概述Overview of people and workplace intelligence in Microsoft Graph

Microsoft 365 云服务的亿万用户组成了 Microsoft Graph 的核心部分。The hundreds of millions of users of Microsoft 365 cloud services form part of the core of Microsoft Graph. 用户的数据通过 Microsoft Graph 提供的服务得到精心的管理、保护和适当的授权,以提升企业生产力和创造力。The users' data is carefully managed, protected, and with proper authorization, made available by Microsoft Graph services to drive productivity and creativity in businesses. 因为在 Microsoft Graph 中有大量的用户数据,所以派生自用户社交交互的数据将尤为受到关注。As ubiquitous the user's data is in Microsoft Graph, data derived from the user's social interactions is particularly interesting. 它可以对回答类似以下问题提供智能见解:It provides intelligent insights that can answer questions such as the following:

  • “此用户就此主题的信息应与谁联系?”"Who should this user contact for information on this topic?"
  • “此人最感兴趣的文档有哪些?”"Which documents are most interesting to this person?"

你可以在 Microsoft Graph 中使用人员 API 和见解 API 来构建更为智能的应用,分别访问与用户相关度高的人员和文档。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.

人员 API 基于用户的联系人、社交网络、组织目录以及电子邮件和 Skype 上的最近通信,返回按与该用户相关性排序的人员。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 and Skype. 这对于选取人员的应用场景尤为有用。This is particularly useful for people-picking scenarios.

见解 API 使用高级分析和机器学习为用户提供他们在工作中所需的相关度最高的文件。The insights API uses advanced analytics and machine learning to provide the most relevant files users need throughout their work day. API 提升了我们所熟悉的 Office 365 体验,其中包括 Office Delve、SharePoint Home、OneDrive for Business 中的发现视图以及 Outlook 网页版。The API powers familiar Office 365 experiences, including Office Delve, SharePoint Home, the Discover view in OneDrive for Business, and Outlook on the web.

人员和见解 API 为用户返回具有相关度的人员和文档

为什么与人员数据集成?Why integrate with people data?

人员 API 可返回单个实体的数据人员,其中包括当今商界中的个人典型数据。The people API returns data of a single entity, person, which includes typical data of an individual in today's business world. ****“人员”数据的优势在于它相对于 Microsoft Graph 用户的__“相关性”。What makes this person data especially useful is its relevance with respect to a Microsoft Graph user. 相关性是基于用户的通信和协作模式以及业务关系来计算的,并且以每个人的相关性分数进行记录。Relevance is noted in a relevance score of each person, calculated based on the user's communication and collaboration patterns and business relationships. 有 3 种主要类型的“相关性”__ 数据的应用程序。There are 3 main types of application of this relevance data.

按相关性浏览人员Browse people by relevance

你可以浏览与登录用户相关的人员或与登录用户组织中某一些用户相关的人员,前提是你已获取相应的授权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. 获取按相关性排序的“人员”**** 对象的集合。You get a collection of person objects that are ordered by relevance. 而且,通过指定查询参数 topskiporderbyselectfilter,你还可以进一步自定义响应中返回的****“人员”对象的集合。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.

基于人员条件的模糊搜索Fuzzy searches based on people criteria

人员 API 允许你搜索与登录用户相关的人员,前提是你的应用已获取该用户授予的权限。The people API lets you search for people relevant to the signed-in user, provided that your app has got permissions by that user. (详细了解人员权限。)(Read more on people permissions.)

模糊搜索根据完全匹配以及搜索意图推断返回结果。Fuzzy searches return results based on an exact match and also on inferences about the intent of the search. 为了说明这一点,请见以下示例:这将返回与登录用户相关的****、其名字或电子邮件地址__ 中包含以“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

基于主题条件的模糊搜索Fuzzy searches based on topic criteria

你也可以借助人员 API 搜索与登录用户相关并表示出有兴趣与该用户就某些“话题”进行交流的人员。The people API also lets you perform searches for people who are relevant to the signed-in user, and have expressed an interest in communicating with that user over certain "topics". 主题只是用户在电子邮件对话中使用最多的词。Topics are just words that have been used most by users in email conversations. Microsoft 从其上下文中随机提取这些词并为该数据创建索引,便于进行模糊搜索。Microsoft extracts such words, free of their contexts, and creates an index for this data to facilitate fuzzy searches.

以下示例说明有关就主题“甲壳虫”为目的进行搜索所得出的推理。The following example illustrates inferences about the intent of a search on the topic "beetle":

GET /me/people/?$search="topic:beetle" 

在主题数据索引中进行的模糊搜索返回了表示甲壳虫昆虫、标志性大众甲壳虫汽车、披头士乐队和其他定义的实例。A fuzzy search in the topic data index return instances that mean the beetle insect, the iconic Volkswagen Beetle car, the Beatles band, and other definitions.

为什么与基于文档的见解集成?Why integrate with document-based insights (preview)?

使用智能来提升协作Use intelligence to improve collaboration

在平时的工作日中,用户通常会与存储在多个文档中的大量信息进行交互,并以多种不同的方式与其他用户协作。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. 当他们需要任何信息时,即可随时找到所需的信息,这一点很重要。It's important that they can always can find what they need, when they need it.

你可以使用见解 API(其中包含热门共享使用 API),根据用户的当前上下文和需求跨 Office 365 处理文件,使用户工作更为高效并提升组织中的协作。You can use the insights API, which includes the trending, shared, and used APIs, to surface files from across Office 365 based on your users' current context and needs, making users more productive and improving collaboration in your organization.

在应用中呈现见解 API 中的结果很简单。It is easy to render the results from the insights API in your app. 每个结果都附带了一组常用可视化属性,例如,预览图像 URL 或预览文本。Every result comes with a set of common visualization properties, like a preview image URL or preview text.

使相关内容可见Make relevant content visible

在 Office 365 中,Delve 使用_热门_见解来帮助用户发现目前最令他们感兴趣的文档。In Office 365, Delve uses the trending insight to help users discover the documents that are most interesting to them right now. 请参见图 1。See figure 1.

通过编程的方式,可以使用见解 API 中的热门实体为应用客户提供类似体验。Programmatically, you can use the trending entity in the insights API to provide your app customers a similar experience. 使用****“热门”实体可连接到最近热门或与用户相关的文档。Use the trending entity to connect to documents that are trending around and relevant to the user. 列出热门文档将返回存储在 OneDrive 或 SharePoint 团队网站上的文件,并参照这些文件的重要程度来对其排序。Listing trending documents returns those files stored on OneDrive or SharePoint team sites, sorted by relevance with the most important ones first.

图 1. Office 365 中的 Delve 为用户显示热门文档Figure 1. Delve in Office 365 showing popular documents for a user

Office 365 中的 Delve 为用户显示热门文档的屏幕截图

允许用户进行协作和恢复工作Allow users to collaborate and get back to work

新的 Office 365 人员卡片融入了“使用”__ 和__“共享”见解,以连接人员和知识单元之间的点。The new Office 365 people cards tap into the used and shared insights to connect the dots between people and units of knowledge. 人员卡片将标识和显示有关人员的相关文档。The people card identifies and displays relevant documents about a person. 用户可以在整个套件内查看人员卡片(例如,在 Outlook 网页版中)。Users can see people cards across the suite, for example, in Outlook on the web. 请参见图 2。See figure 2.

见解 API 提供与使用共享实体类似的功能。The insights API provides a similar functionality with the used and shared entities. 它们返回用户最近最常查看或使用的内容,或同事最近在 Office 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 Office 365.

图 2. Outlook 网页版显示用户的人员卡片Figure 2. Outlook on the web showing a people card for a user

Outlook 网页版中用户的人员卡片屏幕截图,显示最近使用的文件

为什么要与 MyAnalytics(预览版)集成?Why integrate with MyAnalytics (preview)?

MyAnalytics 提供了有关用户如何花费自己时间,以及用户与谁一起花费时间的见解。MyAnalytics provides insight into how people spend their time and who they spend it with. 此类数据可以帮助用户计划一天的日程安排,深入了解自己的不同工作模式,并帮助用户平衡工作和生活。This data can help people plan their day, gain insights into their different work patterns, and help them balance work and life.

借助分析 API,可以同步或集成用户分析数据与自定义第三方应用,以支持各种有助于提升用户工作效率和协作的方案。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. 例如,可以将 MyAnalytics 数据与移动设备活动集成,以帮助用户在一个应用中跟踪自己的所有工作和社交活动,并计划一天的日程安排。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.

为什么要与配置文件 API(预览版)集成?Why integrate with the profile API (preview)?

配置文件 API 表示下一代建模并代表 Microsoft 365 服务中的人脉。The profile API represents the next generation in modeling and representing people in Microsoft 365 services. 配置文件数据可与人脉数据一起使用,以基于 Microsoft Graph 生成自定义体验。Profile data can be used together with people data to build customized experiences based on Microsoft Graph.

API 参考API reference

在查找这些服务的 API 参考?Looking for the API reference for these services?

后续步骤Next steps

  • Graph 浏览器中使用你自己的文件试用人员、见解和分析 API。Use the Graph Explorer to try out the people, insights, and analytics APIs with your own files. 登录并选择左侧列中的“显示更多示例”****。Sign in, and choose Show more samples in the column on the left. 使用菜单打开“人员”**** 和“见解”**** 和“分析”****。Use the menu to turn on People, Insights (beta), and Analytics.
  • 了解有关人员 API人员实体的详细信息。Find more about the people API and the person entity.
  • 若要开始使用见解 API,请参阅 Office Graph 数据解析To get started with insights API, see Use the insights API.
  • 查找有关分析 API 的详细信息。Find more about the analytics API.
  • 查找有关配置文件 API 的详细信息。Find more about the profile API.