사람 데이터용 Microsoft 365 Copilot 커넥터 빌드

사람 데이터용 Microsoft 365 Copilot 커넥터를 사용하면 원본 시스템(예: 인사, 인재 관리 또는 기타 사람 시스템)에서 Microsoft Graph로 사람 데이터와 지식을 수집할 수 있습니다. Microsoft Graph에 사용자 데이터를 추가하면 Microsoft 365 Copilot 및 프로필 카드 및 사용자 검색과 같은 사용자 환경에서 사용할 수 있습니다. 데이터를 수집하면 Copilot은 데이터를 추론하고 이를 사용하여 사용자 질문에 응답할 수 있습니다.

Microsoft Graph 외부 연결 API를 사용하여 다른 Microsoft 365 Copilot 커넥터를 빌드하는 것과 동일한 방식으로 사람 데이터에 대한 Microsoft 365 Copilot 커넥터를 빌드합니다. Microsoft 365에서 연결에 사용자 데이터가 포함되어 있음을 인식하도록 하려면 연결 구성 및 스키마 요구 사항을 따르고 연결을 프로필 데이터의 원본으로 등록합니다.

참고

사람 데이터를 제공하는 커넥터의 예는 사람 데이터용 Microsoft 365 Copilot 커넥터 샘플을 참조하세요.

연결 구성 요구 사항

사용자 데이터가 포함된 Copilot 커넥터에는 API 속성 externalConnections 의 contentCategory 값이 people 있어야 합니다.

연결 스키마 요구 사항

사람 데이터용 Microsoft 365 Copilot 커넥터는 다음 Microsoft 365 사용자 프로필 엔터티에 대한 보강을 지원합니다.

  • 스키마에는 사용자에게 매핑 externalItem 할 수 있는 레이블이 있는 personAccount 속성이 하나 있어야 합니다.
  • 레이블이 없는 속성은 사용자 지정 속성으로 간주됩니다.
속성 레이블 속성 유형 프로필 엔터티 설명
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 사용자가 가지고 있는 외부 웹 계정을 설명합니다.
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"
  }
}

연결을 프로필 원본으로 등록

연결을 만든 후 프로필 데이터의 소스로 등록하고 우선 순위가 지정된 소스 목록에 추가합니다.

커넥터의 연결 ID로 설정된 프로필 소스 APIsourceId 와 webUrl 소스에 대한 추가 정보가 있는 외부 시스템 또는 페이지에 대한 HTTPS 링크로 설정된 속성을 사용하여 연결을 프로필 소스로 등록합니다.

등록 후 프로필 속성 설정 API를 사용하여 우선 순위가 지정된 프로필 원본 목록에 연결을 추가합니다. 의 형식으로 https://graph.microsoft.com/v1.0/admin/people/profileSources(sourceId='connectionId')connectionId 프로필 원본에 URL을 추가합니다. 여기서 는 연결의 고유한 연결 ID를 배열에 prioritizedSourceUrls 추가합니다. 이 배열은 Microsoft 365에서 사용자의 보기를 구성하는 순서를 나타냅니다. 연결을 가장 높은 우선 순위 원본으로 하려면 배열의 첫 번째 항목으로 추가합니다.

사용자 커넥터에 대한 권장 사항

다음은 Microsoft 365 Copilot 채팅 및 Copilot Search의 추론과 품질을 개선하기 위해 사람 데이터를 사용하는 Copilot 커넥터에 대한 지침과 권장 사항입니다.

  • 사용자 지정 속성을 만드는 대신 레이블로 정의된 프로필 엔터티에서 사용 가능한 속성을 최대한 많이 재사용합니다.
  • 사용자 지정 속성의 경우 사용자와 에이전트가 이해하는 속성 이름을 사용합니다. 예를 들어 requisitionIdreqId대신 .
  • 스키마를 정의할 때 각 사용자 지정 속성에 대해 사람이 읽을 수 있는 description 설정을 제공합니다. 레이블이 있는 person* 속성에 대한 설명은 무시됩니다.
  • 복잡한 사용자 지정 속성의 경우 자유 텍스트, Markdown 또는 YAMLJSON대신 .

참고 사항 및 제한 사항

  • Copilot 커넥터를 통해 제공되는 People 데이터는 organization의 모든 사용자에게 표시됩니다. 커넥터 데이터는 사용자의 Microsoft 365 프로필에 저장됩니다. 자세한 내용은 사람 데이터용 Microsoft 365 Copilot 커넥터를 참조하세요.
  • 모든 사용자에게 액세스 권한을 부여하려면 커넥터에서 수집한 항목에 ACL(액세스 제어 목록)을 설정해야 합니다.
  • 프로필 엔터티에 대해 유효한 문자열로 인코딩된 JSON 개체를 제공해야 합니다. Microsoft Graph는 잘못된 값을 무시합니다.
  • 일치하지 않는 사용자 계정(userPrincipalName 또는 externalDirectoryObjectId)은 무시됩니다.
  • Microsoft Graph는 Exchange Online 사서함이 없는 계정을 무시합니다.
  • Microsoft Graph는 레이블이 없는 모든 속성을 사용자 지정 속성으로 처리합니다.
  • Microsoft 365는 연결을 만든 후 검색, 피플 환경 또는 Copilot에서 사용할 수 있게 되기까지 최대 6시간이 걸릴 수 있습니다.
  • 사용자 데이터와의 연결은 준비된 연결을 지원하지 않습니다.
  • 다음 레이블은 현재 지원되지 않습니다. personManager, , personColleagues, personAlternateContacts, 및 personEmergencyContacts. personAssistants
  • Copilot 커넥터 principal 및 principalCollection 스키마 속성 유형은 현재 지원되지 않습니다. 엔터티의 workPosition 컬렉션을 colleagues 사용하여 관계를 만듭니다.
  • 다음 Copilot 커넥터 스키마 특성은 무시됩니다. isQueryableisRefinable, , isRetrievable, isSearchable, . 개인에 대한 모든 데이터는 기본적으로 인덱싱됩니다.