人データ用の 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) は無視されます。 既定で、ユーザーに関するすべてのデータにインデックスが作成されます。