人員資料的Microsoft 365 Copilot連接器可讓您從來源系統擷取人員資料和知識,例如人力資源、人才管理,或) 到 (Microsoft Graph 的其他人員系統。 將人員資料新增至 Microsoft Graph 可讓 Microsoft 365 Copilot 和人員體驗使用,例如設定檔卡片和人員搜尋。 當您擷取資料時,Copilot 可以推理資料,並用來回應使用者的問題。
您可以使用 Microsoft Graph 外部連線 API,以與建置其他 Copilot 連接器相同的方式,為人員資料建置 Microsoft 365 Copilot 連接器。 若要確定 Microsoft 365 可識別您的連線包含人員資料,請遵循 連線設定 和 結構描述 需求,並將 連線註冊為設定檔資料來源。
注意
如需提供人員資料的連接器範例,請參閱適用於人員資料的 Microsoft 365 Copilot 連接器範例。
連線設定需求
包含人員資料的 Copilot 連接器必須具有 API 屬性externalConnections中的contentCategory值people。
連線結構描述需求
適用於人員資料的 Microsoft 365 Copilot 連接器支援下列 Microsoft 365 使用者設定檔實體的擴充。
- 架構必須具有一個具有標籤的
personAccount屬性,才能將 對externalItem應至人員。 - 沒有標籤的屬性會被視為 自訂屬性。
| 屬性標籤 | 屬性類型 | 設定檔實體 | 描述 |
|---|---|---|---|
personAccount |
string |
userAccountInformation |
指出項目目標的 Microsoft Entra ID 使用者。 |
personCurrentPosition |
string |
workPosition |
描述人員目前的位置。 |
personAddresses |
stringCollection |
itemAddress |
最多 3 個,、 Work和 Other各一個Home。 新增使用者的地址。 |
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 |
描述使用者擁有的外部 Web 帳戶。 |
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,而且是要擴充之 Microsoft 365 設定檔實體的 JSON 序列化字串表示。
{
...
"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"
}
}
將連線註冊為設定檔來源
建立連線後,請將其註冊為設定檔資料來源,並將其新增至優先來源清單。
您可以使用 設定檔來源 APIsourceId 將連線註冊為設定檔來源,並將屬性設定為連接器的連線識別碼, webUrl 並將屬性設定為指向外部系統或包含有關來源之其他資訊的頁面的 HTTPS 連結。
註冊後,使用 設定檔屬性設定 API 將連線新增至優先順序設定檔來源清單。 將 URL 以 的格式https://graph.microsoft.com/v1.0/admin/people/profileSources(sourceId='connectionId')新增至設定檔來源 ,其中 connectionId 是連線的唯一連線 ID。prioritizedSourceUrls 此陣列代表 Microsoft 365 撰寫人員檢視的順序。 如果您希望連線成為最高優先順序的來源,請將其新增為陣列中的第一個項目。
給人員連接器的建議
以下是具有人員資料的 Copilot 連接器的指導方針和建議,以改善 Microsoft 365 Copilot 聊天和 Copilot 搜尋的推理和品質:
- 盡可能重複使用由標籤定義的設定檔實體中的可用屬性,而不是建立自訂屬性。
- 對於自訂屬性,請使用使用者和代理程式了解的屬性名稱。 例如,使用
requisitionId代替reqId。 - 當您定義架構時,請為每個自訂屬性提供人類可讀
description的屬性。 具有標籤的person*屬性描述會被忽略。 - 對於複雜的自訂屬性,請使用自由文字、Markdown 或
YAMLJSON。
注意事項和限制
- 組織中的所有使用者都能看到透過 Copilot 連接器提供的 People 資料。 連接器資料會儲存在使用者的 Microsoft 365 設定檔中。 如需詳細資訊,請參閱適用於人員資料的 Microsoft 365 Copilot 連接器。
- 您必須在連接器擷取的項目上設定存取控制清單 (ACL) ,才能授與所有人存取權。
- 您必須為設定檔實體提供有效的字串編碼JSON物件。 Microsoft Graph 忽略無效值。
- 將忽略不相符的使用者帳戶 (
userPrincipalName或externalDirectoryObjectId) 。 - Microsoft Graph 會忽略沒有 Exchange Online 信箱的帳戶。
- Microsoft Graph 會將沒有標籤的任何屬性視為自訂屬性。
- 建立連線之後,Microsoft 365 最多可能需要 6 小時的時間,才會在搜尋、人員體驗或 Copilot 中提供。
- 具有人員資料的連線不支援 分段連線。
- 目前不支援下列標籤:
personManager、personAssistants、personColleagues、personAlternateContacts、和personEmergencyContacts。 - 目前不支援 Copilot 連接器
principal和principalCollection結構描述屬性類型。 使用colleagues實體的workPosition集合來建立關聯性。 - 系統會忽略下列 Copilot 連接器結構描述屬性:
isQueryable、isRefinable、isRetrievableisSearchable、 。 根據預設,有關人員的所有資料都會編製索引。