Microsoft Graph 中的人员和工作场所智能

  • 项目

Microsoft 365 云服务的亿万用户组成了 Microsoft Graph 的核心部分。 用户的数据通过 Microsoft Graph 提供的服务得到精心的管理、保护和适当的授权，以提升企业生产力和创造力。

通过个人资料 API，你可以作为应用开发人员为 Microsoft 365 服务中的人员建模并代表他们，借助个人资料卡片 API，管理员可以控制组织中用户个人资料卡上显示的信息。

由于用户的数据在 Microsoft Graph 中随处可见，因此派生自用户交互的数据尤其有趣。 它可以对回答类似以下问题提供智能见解：

  • “搜索名称以‘J’开头的人”
  • “此人最感兴趣的文档有哪些？”

你可以在 Microsoft Graph 中使用人员 API 和见解 API 来构建更为智能的应用，分别访问与用户相关度高的人员和文档。

人员 API 根据用户的联系人、组织目录和电子邮件上的最近通信，返回用户相关性排序的人员。 这对于选取人员的应用场景尤为有用。

见解 API 使用高级分析和机器学习为用户提供他们在工作中所需的相关度最高的文件。 API 提升了我们所熟悉的 Microsoft 365 体验，其中包括 Office Delve、SharePoint Home、OneDrive for Business 中的发现视图以及 Outlook 网页版。

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

为什么与人员数据集成？

人员 API 可返回单个实体的数据人员，其中包括当今商界中的个人典型数据。 “人员”数据的优势在于它相对于 Microsoft Graph 用户的“相关性”。 在返回的结果中记录了相关性，这些结果从最相关到最不相关的顺序排序。 可以使用以下 Microsoft Graph API 搜索组织内的人员。

使用 /search 终结点

我们鼓励开发人员在 /search 生成产品时使用该终结点; /people 终结点处于维护模式。 以下是考虑使用 /search 终结点的原因：

  • 所有未来对人员搜索的投资都将通过 /search;例如，自然语言搜索，如“内罗毕的会计师约翰”。
  • 对名称和电子邮件以外的属性进行属性搜索匹配。
  • 由于使用了人工智能、更好的数据模型和复杂的拼写更正，因此提供更好的相关性 /search 结果。
  • 使用 /search时的货物成本较低，但特别要降低延迟。

按相关性浏览人员

你可以浏览与登录用户相关的人员或与登录用户组织中某一些用户相关的人员，前提是你已获取相应的授权。 获取按相关性排序的“人员”对象的集合。 而且，通过指定查询参数 top、skip、orderby、select 和 filter，你还可以进一步自定义响应中返回的“人员”对象的集合。

基于人员条件的模糊搜索

人员 API 允许你搜索与登录用户相关的人员，前提是你的应用已获取该用户授予的权限。 （详细了解人员权限。）

模糊搜索根据完全匹配以及搜索意图推断返回结果。 为了说明这一点，请见以下示例：这将返回与登录用户相关的、其名字或电子邮件地址中包含以“j”开头的单词的人员对象。

GET /me/people/?$search=j

为什么要与配置文件 API（预览版）集成？

配置文件 API 表示下一代建模并代表 Microsoft 365 服务中的人脉。 配置文件数据可与人脉数据一起使用，以基于 Microsoft Graph 生成自定义体验。

为什么要在组织中配置个人资料卡？

个人资料卡让组织中的用户可以查看其他人的信息，如姓名和联系信息。 管理员可以使用个人资料卡 API来定制有关 Microsoft 365 人员体验内的组织外观。

为什么要在组织中配置代词？

代词作为句子中一个人姓名的替代品，具有多种语言的中性版本，例如英语中的“她”、“她”、“他”、“他”和性别中立的“他们”、“他们”。 准确的代词用法显示了包容性和尊重性，避免基于姓名或初始观察结果的假设。 在混合的多元文化工作或学校环境中，使用正确的代词的简单行为可以帮助建立信任和改善彼此之间的沟通。 管理员可以使用 pronounsSettings API 在组织中配置代词设置。

为什么与基于文档的见解集成？

使用智能来提升协作

在平时的工作日中，用户通常会与存储在多个文档中的大量信息进行交互，并以多种不同的方式与其他用户协作。 当他们需要任何信息时，始终可以随时找到所需的信息，这一点非常重要。

你可以使用见解 API（其中包含热门、共享和使用 API），根据用户的当前上下文和需求跨 Microsoft 365 处理文件，使用户工作更为高效并提升组织中的协作。 组织可以为这些基于文档的见解自定义隐私设置，并控制特定 Microsoft 365体验中这些见解的可用性。

在应用中呈现见解 API 中的结果很简单。 每个结果都附带了一组常用可视化属性，例如，预览图像 URL 或预览文本。

使相关内容可见

在 Microsoft 365 中，Delve 使用热门见解来帮助用户发现目前最令他们感兴趣的文档。 请参见图 1。

通过编程的方式，可以使用见解 API 中的热门实体为应用客户提供类似体验。 使用“热门”实体可连接到最近热门或与用户相关的文档。 列出热门文档将返回存储在 OneDrive 或 SharePoint 团队网站上的文件，并参照这些文件的重要程度来对其排序。

图 1. Microsoft 365 中的 Delve 显示用户的热门文档

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

允许用户进行协作和恢复工作

新的 Microsoft 365 人员卡片融入了“使用”和“共享”见解，以连接人员和知识单元之间的点。 人员卡片将标识和显示有关人员的相关文档。 用户可以在整个套件内查看人员卡片（例如，在 Outlook 网页版中）。 请参见图 2。

见解 API 提供与使用和共享实体类似的功能。 它们返回用户最近最常查看或使用的内容，或同事最近在 Microsoft 365 中与用户共享的内容。

图 2. 显示用户卡人员Outlook 网页版

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

为什么要与 Microsoft Viva Insights (预览版) 集成？

Microsoft Viva Insights提供有关人们如何花时间以及与谁共度时间的见解。 此类数据可以帮助用户计划一天的日程安排，深入了解自己的不同工作模式，并帮助用户平衡工作和生活。

借助分析 API，可以同步或集成用户分析数据与自定义第三方应用，以支持各种有助于提升用户工作效率和协作的方案。 例如，你可以将Viva Insights数据与移动设备活动集成，以帮助用户跟踪其所有工作和社交活动，并在一个应用中计划他们的一天。

API 参考

在查找这些服务的 API 参考？

后续步骤