針對人員資料建置 Microsoft 365 Copilot 連接器

人員資料的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、 。 根據預設,有關人員的所有資料都會編製索引。