Créer des connecteurs Microsoft 365 Copilot pour les données de personnes

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 personAccount pour pouvoir mapper le externalItem à 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 de reqId.
  • Lorsque vous définissez le schéma, fournissez un fichier lisible description pour chaque propriété personnalisée. Les descriptions des propriétés avec person* des étiquettes sont ignorées.
  • Pour les propriétés personnalisées complexes, utilisez Texte libre, Markdown ou YAML au lieu de JSON.

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 (userPrincipalName ou externalDirectoryObjectId) 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 principal et principalCollection de schéma Copilot ne sont pas pris en charge actuellement. Utilisez la colleagues collection de l’entité workPosition pour 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.