Создание соединителей Microsoft 365 Copilot для данных людей

Соединители Microsoft 365 Copilot для данных о людях позволяют принимать данные и знания людей из исходных систем (например, отдела кадров, управления кадровыми ресурсами или других систем управления персоналом) в Microsoft Graph. Добавление данных о людях в Microsoft Graph делает их доступными для Microsoft 365 Copilot и других интерфейсов, таких как карточка профиля и поиск людей. Когда вы принимаете данные, Copilot может проанализировать их и использовать для ответа на вопросы пользователей.

Соединители Microsoft 365 Copilot для данных "люди" создаются так же, как и другие соединители Copilot, но с помощью API внешних подключений Microsoft Graph. Чтобы убедиться, что Microsoft 365 распознает, что ваше подключение содержит данные пользователей, следуйте требованиям к конфигурации исхеме подключения и зарегистрируйте подключение в качестве источника данных профиля.

Примечание

Пример соединителя, предоставляющего данные о людях, см. в примере соединителя Microsoft 365 Copilot для данных о людях.

Требования к конфигурации подключения

Соединители Copilot, содержащие данные о людях, должны иметь значение people в contentCategory свойстве externalConnections API.

Требования к схеме подключения

Соединители Microsoft 365 Copilot для данных "Люди" поддерживают обогащение для следующих сущностей профилей пользователей Microsoft 365.

  • Схема должна иметь одно свойство с personAccount меткой, чтобы сопоставить его externalItem с пользователем.
  • Свойства без метки считаются настраиваемыми.
Метка свойства Тип свойства Профиль сущности Описание
personAccount string userAccountInformation Указывает пользователя Microsoft Entra ID, на которого нацелен элемент.
personCurrentPosition string workPosition Описывает текущее положение человека.
personAddresses stringCollection itemAddress Макс 3, по одному из Home, Work, и Other. Добавляет адреса пользователю.
personAnniversaries stringCollection personAnniversary Добавляет человеку одну или несколько годовщин рождения.
personAwards stringCollection personAward Описывает награды, полученные пользователем.
personCertifications stringCollection personCertification Описывает сертификаты, полученные пользователем.
personEducationalActivities stringCollection educationalActivity Описывает образовательную деятельность пользователя.
personEmails stringCollection itemEmail Макс 3. Добавляет адреса электронной почты для пользователя.
personInterests stringCollection personInterest Подробная информация об интересах пользователя.
personLanguages stringCollection languageProficiency Подробные сведения о языках, которыми владеет пользователь.
personName string personName Добавляет имена пользователей.
personNote string personAnnotation Добавляет заметку для пользователя.
personPatents stringCollection itemPatent Описывает выданный или поданный патент, с которым связан пользователь.
personPhones stringCollection itemPhone Добавляет номера телефонов для пользователя.
personPublications stringCollection itemPublication Описывает публикации или статьи, с которыми связан пользователь.
personProjects stringCollection projectParticipation Описывает проекты, в которых участвовал пользователь.
personSkills stringCollection skillProficiency Описывает навыки, которыми владеет пользователь.
personWebAccounts stringCollection webAccount Описывает внешние веб-учетные записи пользователя.
personWebSite string webSite Описывает веб-сайт для пользователя.
personWorkPositions stringCollection workPosition Описывает исторические рабочие позиции пользователя.

Пример схемы:

{
  "baseType": "microsoft.graph.externalItem",
  "properties": [
    {
      "name": "accountInformation",
      "type": "string",
      "labels": ["personAccount"]
    },
    {
      "name": "position",
      "type": "string",
      "labels": ["personCurrentPosition"]
    },
    {
      "name": "skills",
      "type": "stringCollection",
      "labels": ["personSkills"]
    },
    {
      "name": "requisitionId",
      "type": "string",
      "description": "The user's requisition ID"
    }
  ]
}

Сериализация объектов JSON

Каждое свойство с меткой имеет либо тип string , либо stringCollection, и представляет собой сериализованное строковое представление JSON объекта профиля Microsoft 365, который нужно обогатить.

{
  ...
  "properties": {
    "accountInformation": "{\"userPrincipalName\": \"adelev@contoso.com\"}",
    "position": "{\"detail\":{\"jobTitle\":\"ProductManager\"}}",
    "skills@odata.type": "Collection(String)",
    "skills": [
      "{\"displayName\":\"Product requirements\"}",
      "{\"displayName\":\"Customer research\"}"
    ],
    "requisitionId": "REQ-12345678"
  }
}

Регистрация подключения в качестве источника профиля

После создания подключения зарегистрируйте его в качестве источника данных профиля и добавьте его в список приоритетных источников.

Подключение регистрируется в качестве источника профиля с помощью API источника профиля с sourceId ИД подключения соединителя, а свойство webUrl — HTTPS-ссылка на внешнюю систему или страницу с дополнительной информацией об источнике.

После регистрации добавьте подключение в список приоритетных источников профилей с помощью API настроек свойств профиля. Добавьте URL-адрес источника профиля в формате https://graph.microsoft.com/v1.0/admin/people/profileSources(sourceId='connectionId'), где connectionId — уникальный идентификатор подключения подключения, в массиве prioritizedSourceUrls . Этот массив представляет порядок, в котором Microsoft 365 составляет представление пользователя. Если вы хотите, чтобы ваше подключение было источником с наивысшим приоритетом, добавьте его первым элементом в массиве.

Рекомендации по соединителям людей

Ниже приведены рекомендации и рекомендации для соединителей Copilot с данными о людях для улучшения рассуждений и повышения качества работы в чате Copilot и Поиске Copilot в Microsoft 365:

  • Повторно используйте как можно больше доступных свойств в объектах профиля, определенных метками, вместо создания пользовательского свойства.
  • Для настраиваемых свойств используйте имя свойства, понятное пользователям и агентам. Например, используйте requisitionId вместо reqId.
  • При определении схемы предоставьте удобочитаемое description значение для каждого настраиваемого свойства. Описания свойств с person* подписями игнорируются.
  • Для сложных пользовательских свойств используйте свободный текст, Markdown или YAML вместо JSON.

Примечания и ограничения

  • Данные о людях, предоставляемые через соединитель Copilot, видны всем пользователям в организации. Данные соединителя хранятся в профиле пользователя Microsoft 365. Дополнительные сведения см. в статье Соединители Microsoft 365 Copilot для данных о людях.
  • Вы должны настроить список управления доступом (ACL) для элементов, принимаемых соединителем, чтобы предоставить доступ всем.
  • Для объектов профиля необходимо предоставить допустимые объекты JSON в строковом кодировании. Microsoft Graph игнорирует недопустимые значения.
  • Несовпадающие учетные записи пользователей (userPrincipalNameexternalDirectoryObjectIdили ) игнорируются.
  • Microsoft Graph игнорирует учетные записи без почтового ящика Exchange Online.
  • Microsoft Graph рассматривает любое свойство без метки как настраиваемое свойство.
  • Microsoft 365 может пройти до 6 часов после создания подключения, прежде чем оно станет доступным в поиске, взаимодействии с пользователями или Copilot.
  • Подключения с данными о людях не поддерживают поэтапные подключения.
  • В настоящее время не поддерживаются следующие метки: personManager, personAssistants, personColleaguespersonAlternateContactsи personEmergencyContacts.
  • Типы свойств Copilot "Соединитель principal " и principalCollection "Схема" в настоящее время не поддерживаются. Используйте colleagues коллекцию сущности workPosition для создания связей.
  • Следующие атрибуты схемы соединителя Copilot игнорируются: isQueryable, isRefinable, , isRetrievableisSearchable. Все данные о человеке индексируются по умолчанию.