Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Les connecteurs Microsoft 365 Copilot pour les données des personnes vous permettent d’ingérer des données et des connaissances de personnes à partir de vos systèmes sources (par exemple, les ressources humaines, la gestion des talents ou d’autres systèmes de gestion des personnes) dans Microsoft Graph. L’ajout de données de personnes à Microsoft Graph les met à la disposition de Microsoft 365 Copilot et des expériences de personnes, telles que la carte de visite et la recherche de personnes. Lorsque vous ingérez vos données, Copilot peut les étudier et les utiliser pour répondre aux questions des utilisateurs.
Vous créez des connecteurs Microsoft 365 Copilot pour les données de personnes de la même façon que vous créez d’autres connecteurs Copilot, à l’aide des API de connexions externes Microsoft Graph. Pour vous assurer que Microsoft 365 reconnaît que votre connexion contient des données de personnes, suivez les exigences de configuration et de schéma de connexion et inscrivez la connexion comme source de données de profil.
Remarque
Pour obtenir un exemple de connecteur qui fournit des données sur les personnes, consultez Connecteur Microsoft 365 Copilot pour l’exemple de données sur les personnes.
Configuration requise pour la connexion
Les connecteurs Copilot qui contiennent des données de personnes doivent avoir la valeur people dans la contentCategory propriété de l’API externalConnections .
Exigences de schéma de connexion
Les connecteurs Microsoft 365 Copilot pour les données de personnes prennent en charge l’enrichissement pour les entités de profil utilisateur Microsoft 365 suivantes.
- Le schéma doit avoir une propriété avec l’étiquette
personAccountpour pouvoir mapper leexternalItemà une personne. - Les propriétés sans étiquette sont considérées comme des propriétés personnalisées.
| Étiquette de propriété | Type de propriété | Entité de profil | Description |
|---|---|---|---|
personAccount |
string |
userAccountInformation |
Indique l’utilisateur Microsoft Entra ID ciblé par l’article. |
personCurrentPosition |
string |
workPosition |
Décrit la position actuelle de la personne. |
personAddresses |
stringCollection |
itemAddress |
Max 3, un de chacun Workdes , Homeet Other. Ajoute des adresses à l’utilisateur. |
personAnniversaries |
stringCollection |
personAnniversary |
Ajoute un ou plusieurs anniversaires à la personne. |
personAwards |
stringCollection |
personAward |
Décrit les récompenses gagnées par l’utilisateur. |
personCertifications |
stringCollection |
personCertification |
Décrit les certifications obtenues par l’utilisateur. |
personEducationalActivities |
stringCollection |
educationalActivity |
Décrit les activités pédagogiques de l’utilisateur. |
personEmails |
stringCollection |
itemEmail |
Max 3. Ajoute des adresses e-mail à l’utilisateur. |
personInterests |
stringCollection |
personInterest |
Informations détaillées sur les intérêts de l’utilisateur. |
personLanguages |
stringCollection |
languageProficiency |
Informations détaillées sur les langues que l’utilisateur connaît. |
personName |
string |
personName |
Ajoute des noms à l’utilisateur. |
personNote |
string |
personAnnotation |
Ajoute une note à l’utilisateur. |
personPatents |
stringCollection |
itemPatent |
Décrit un brevet accordé ou déposé auquel l’utilisateur est associé. |
personPhones |
stringCollection |
itemPhone |
Ajoute des numéros de téléphone à l’utilisateur. |
personPublications |
stringCollection |
itemPublication |
Décrit les publications ou les articles auxquels l’utilisateur est associé. |
personProjects |
stringCollection |
projectParticipation |
Décrit les projets auxquels l’utilisateur a participé. |
personSkills |
stringCollection |
skillProficiency |
Décrit les compétences que l’utilisateur maîtrise. |
personWebAccounts |
stringCollection |
webAccount |
Décrit les comptes web externes dont dispose l’utilisateur. |
personWebSite |
string |
webSite |
Décrit un site web pour l’utilisateur. |
personWorkPositions |
stringCollection |
workPosition |
Décrit les positions de travail historiques de l’utilisateur. |
Exemple de schéma :
{
"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"
}
]
}
Sérialisation des entités JSON
Chaque propriété, avec une étiquette, est de type string ou stringCollection, et est une représentation de chaîne sérialisée JSON de l’entité de profil Microsoft 365 à enrichir.
{
...
"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"
}
}
Enregistrement de la connexion en tant que source de profil
Après avoir créé la connexion, enregistrez-la en tant que source de données de profil et ajoutez-la à la liste des sources prioritaires.
Vous enregistrez la connexion en tant que source de profil à l’aide de l’API source de profil avec sourceId l’ID de connexion de votre connecteur et la webUrl propriété définie sur un lien HTTPS vers le système externe ou une page avec des informations supplémentaires sur la source.
Après l’inscription, ajoutez la connexion à la liste des sources de profil prioritaires à l’aide de l’API de paramètres de propriété Profil. Ajoutez l’URL à la source du profil, au format , https://graph.microsoft.com/v1.0/admin/people/profileSources(sourceId='connectionId')où connectionId est l’ID unique de connexion de la connexion, au prioritizedSourceUrls tableau. Ce tableau représente l’ordre dans lequel Microsoft 365 compose l’affichage d’une personne. Si vous souhaitez que votre connexion soit la source la plus prioritaire, ajoutez-la en tant que premier élément du tableau.
Recommandations pour les connecteurs de personnes
Voici des instructions et des recommandations pour les connecteurs Copilot avec des données de personnes, afin d’améliorer le raisonnement et la qualité dans Microsoft 365 Copilot Chat et Recherche Copilot :
- Réutilisez autant que possible les propriétés disponibles dans les entités de profil, définies par les étiquettes, au lieu de créer une propriété personnalisée.
- Pour les propriétés personnalisées, utilisez un nom de propriété que les utilisateurs et les agents comprennent. Par exemple, utilisez
requisitionIdà la place dereqId. - Lorsque vous définissez le schéma, fournissez un fichier lisible
descriptionpour chaque propriété personnalisée. Les descriptions des propriétés avecperson*des étiquettes sont ignorées. - Pour les propriétés personnalisées complexes, utilisez Texte libre, Markdown ou
YAMLau lieu deJSON.
Remarques et limitations
- Les données des personnes fournies via un connecteur Copilot sont visibles par tous les utilisateurs de l’organisation. Les données du connecteur sont stockées dans le profil Microsoft 365 de l’utilisateur. Pour plus d’informations, consultez Connecteurs Microsoft 365 Copilot pour les données de personnes.
- Vous devez définir la liste de contrôle d’accès (ACL) sur les éléments ingérés par le connecteur pour accorder l’accès à tout le monde.
- Vous devez fournir des objets JSON encodés en chaîne valides pour les entités de profil. Microsoft Graph ignore les valeurs non valides.
- Les comptes d’utilisateur non mis en correspondance (
userPrincipalNameouexternalDirectoryObjectId) sont ignorés. - Microsoft Graph ignore les comptes sans boîte aux lettres Exchange Online.
- Microsoft Graph traite toute propriété sans étiquette comme une propriété personnalisée.
- Microsoft 365 peut prendre jusqu’à 6 heures après la création de la connexion avant qu’elle soit disponible dans la recherche, les expériences utilisateur ou Copilot.
- Les connexions avec des données de personnes ne prennent pas en charge les connexions intermédiaires.
- Les étiquettes suivantes ne sont pas prises en charge actuellement :
personManager, ,personAlternateContactspersonAssistantspersonColleagues, et .personEmergencyContacts - Les types de propriétés de connecteur
principaletprincipalCollectionde schéma Copilot ne sont pas pris en charge actuellement. Utilisez lacolleaguescollection de l’entitéworkPositionpour créer des relations. - Les attributs de schéma de connecteur Copilot suivants sont ignorés :
isQueryable, ,isRefinableisRetrievableisSearchable, , . Toutes les données concernant une personne sont indexées par défaut.