ユーザー データ用に Microsoft 365 Copilot コネクタを構築する

人データ用の Microsoft 365 Copilot コネクタを使用すると、ソース システム (人事、人事管理、その他の人事システムなど) から Microsoft Graph に人のデータと知識を取り込むことができます。 Microsoft Graph にユーザー データを追加すると、Microsoft 365 Copilot や、プロファイル カードやユーザー検索などのユーザー エクスペリエンスでユーザー データを利用できるようになります。 データを取り込むと、Copilot はデータに基づいて推論し、それを使用してユーザーの質問に答えることができます。

Microsoft 365 Copilot コネクタは、Microsoft Graph の外部接続 API を使用して、他の Copilot コネクタを構築するのと同じ方法で、人物データ用に構築します。 接続にユーザー データが含まれていることを Microsoft 365 が認識するようにするには、 接続構成 と スキーマ の要件に従い、 接続をプロファイル データのソースとして登録します。

注

ユーザー データを提供するコネクタの例については、「ユーザー データ用の Microsoft 365 Copilot コネクタのサンプル」を参照してください。

接続構成の要件

ユーザー データを含む Copilot コネクタには、externalConnections API の contentCategory プロパティでpeople値が必要です。

接続スキーマの要件

ユーザー データ用の Microsoft 365 Copilot コネクタは、次の Microsoft 365 ユーザー プロファイル エンティティのエンリッチメントをサポートします。

  • スキーマには、externalItemをユーザーにマップできるようにするには、personAccount ラベルを持つプロパティが 1 つ必要です。
  • ラベルのないプロパティは、 カスタム プロパティと見なされます。
プロパティ ラベル プロパティの種類 プロファイル エンティティ 説明
personAccount string userAccountInformation アイテムの対象となる Microsoft Entra ID ユーザーを示します。
personCurrentPosition string workPosition ユーザーの現在の位置を表します。
personAddresses stringCollection itemAddress 最大 3 個、 Home、 Work、 Other のそれぞれ 1 つ。 ユーザーにアドレスを追加します。
personAnniversaries stringCollection personAnniversary ユーザーに 1 つ以上の記念日を追加します。
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 ユーザーの Web サイトを記述します。
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"
  }
}

プロフィール ソースとして接続を登録する

接続を作成したら、プロフィール データのソースとして登録し、優先されるソースのリストに追加します。

sourceIdをコネクタの接続 ID に設定し、webUrl プロパティを外部システムまたはソースに関する追加情報を含むページへの HTTPS リンクに設定したプロファイル ソース API を使用して、接続をプロファイル ソースとして登録します。

登録後、 プロファイル プロパティ設定 API を使用して、優先されるプロファイル ソースの一覧に接続を追加します。 プロファイル ソースの URL を https://graph.microsoft.com/v1.0/admin/people/profileSources(sourceId='connectionId') の形式で追加します。ここで、 connectionId は接続の一意の接続 ID を、 prioritizedSourceUrls 配列に追加します。 この配列は、Microsoft 365 がユーザーのビューを構成する順序を表します。 接続を最も優先されるソースにする場合は、配列の最初の項目として追加します。

ユーザー コネクタに関する推奨事項

以下は、Microsoft 365 Copilot チャットと Copilot 検索の推論と品質を向上させるために、人データを使用した Copilot コネクタのガイドラインと推奨事項です:

  • カスタム プロパティを作成するのではなく、ラベルによって定義されたプロファイル エンティティの使用可能なプロパティをできるだけ再利用します。
  • カスタム プロパティの場合は、ユーザーとエージェントが理解できるプロパティ名を使用します。 たとえば、reqId の代わりに requisitionId を使用します。
  • スキーマを定義するときは、各カスタム プロパティに人間が判読できる description を指定します。 person*ラベルが付いたプロパティの説明は無視されます。
  • 複雑なカスタム プロパティの場合は、JSON の代わりにフリー テキスト、Markdown、または YAML を使用します。

注意事項と制限事項

  • 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、 personAssistants、 personColleagues、 personAlternateContacts、 personEmergencyContacts のラベルはサポートされていません。
  • Copilot コネクタ principal と principalCollection スキーマ プロパティの種類は現在サポートされていません。 リレーションシップを作成するには、workPosition エンティティの colleagues コレクションを使用します。
  • Copilot コネクタ スキーマの属性 ( isQueryable、 isRefinable、 isRetrievable、 isSearchable) は無視されます。 既定で、ユーザーに関するすべてのデータにインデックスが作成されます。