Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Соединители 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. Все данные о человеке индексируются по умолчанию.