Creare connettori Microsoft 365 Copilot per i dati delle persone

I connettori di Microsoft 365 Copilot per i dati delle persone consentono di inserire dati e conoscenze sulle persone dai sistemi di origine (ad esempio risorse umane, gestione dei talenti o altri sistemi di persone) in Microsoft Graph. L'aggiunta dei dati sulle persone a Microsoft Graph li rende disponibili per Microsoft 365 Copilot e per le esperienze delle persone, come la scheda del profilo e la ricerca delle persone. Quando si acquisiscono i dati, Copilot può analizzarli e usarli per rispondere alle domande degli utenti.

È possibile creare connettori Microsoft 365 Copilot per i dati delle persone nello stesso modo in cui si creano altri connettori Copilot, usando le API connessioni esterne di Microsoft Graph. Per assicurarsi che Microsoft 365 riconosca che la connessione contiene dati sulle persone, seguire i requisiti di configurazione e schema della connessione e registrare la connessione come origine dei dati del profilo.

Nota

Per un esempio di connettore che fornisce dati sulle persone, vedere Esempio di dati Microsoft 365 Copilot Connector for People.

Requisiti di configurazione della connessione

I connettori Copilot che contengono dati sulle persone devono avere il valore people nella proprietà dell'API contentCategoryexternalConnections .

Requisiti dello schema di connessione

I connettori di Microsoft 365 Copilot per i dati delle persone supportano l'arricchimento per le entità del profilo utente di Microsoft 365 seguenti.

  • Lo schema deve avere una proprietà con l'etichetta per poter eseguire il personAccount mapping a externalItem una persona.
  • Le proprietà senza etichetta sono considerate proprietà personalizzate.
Etichetta proprietà Tipo di proprietà Entità profilo Descrizione
personAccount string userAccountInformation Indica all'utente di Microsoft Entra ID il target dell'elemento.
personCurrentPosition string workPosition Descrive la posizione attuale della persona.
personAddresses stringCollection itemAddress Max 3, uno ciascuno di Home, Work, e Other. Aggiunge indirizzi all'utente.
personAnniversaries stringCollection personAnniversary Aggiunge uno o più anniversari alla persona.
personAwards stringCollection personAward Descrive i premi ottenuti dall'utente.
personCertifications stringCollection personCertification Descrive le certificazioni ottenute dall'utente.
personEducationalActivities stringCollection educationalActivity Descrive le attività didattiche dell'utente.
personEmails stringCollection itemEmail Max 3. Aggiunge indirizzi di posta elettronica all'utente.
personInterests stringCollection personInterest Informazioni dettagliate sugli interessi dell'utente.
personLanguages stringCollection languageProficiency Informazioni dettagliate sulle lingue conosciute dall'utente.
personName string personName Aggiunge nomi all'utente.
personNote string personAnnotation Aggiunge una nota per l'utente.
personPatents stringCollection itemPatent Descrive un brevetto concesso o depositato a cui l'utente è associato.
personPhones stringCollection itemPhone Aggiunge numeri di telefono all'utente.
personPublications stringCollection itemPublication Descrive pubblicazioni o articoli a cui l'utente è associato.
personProjects stringCollection projectParticipation Descrive i progetti a cui l'utente ha partecipato.
personSkills stringCollection skillProficiency Descrive le competenze in cui l'utente è esperto.
personWebAccounts stringCollection webAccount Descrive gli account Web esterni di cui dispone l'utente.
personWebSite string webSite Descrive un sito Web per l'utente.
personWorkPositions stringCollection workPosition Descrive le posizioni lavorative storiche dell'utente.

Schema di esempio:

{
  "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"
    }
  ]
}

Serializzazione di entità JSON

Ogni proprietà, con un'etichetta, è di tipo string o stringCollectioned è una rappresentazione di stringa serializzata JSON dell'entità del profilo Microsoft 365 da arricchire.

{
  ...
  "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"
  }
}

Registrazione della connessione come origine del profilo

Dopo aver creato la connessione, registrarla come origine dei dati del profilo e aggiungerla all'elenco delle origini prioritarie.

Registrare la connessione come origine del profilo usando l'API di origine del profilo con sourceId l'ID connessione impostato sull'ID connessione del connettore e la webUrl proprietà impostata su un collegamento HTTPS al sistema esterno o a una pagina con informazioni aggiuntive sull'origine.

Dopo la registrazione, aggiungere la connessione all'elenco delle origini dei profili con priorità usando l'API delle impostazioni delle proprietà del profilo. Aggiungere all'array l'URL dell'origine del profilo, nel formato , https://graph.microsoft.com/v1.0/admin/people/profileSources(sourceId='connectionId')dove connectionId si trova l'ID di connessione univoco della connessione prioritizedSourceUrls . Questa matrice rappresenta l'ordine in cui Microsoft 365 compone la visualizzazione di una persona. Se vuoi che la connessione sia l'origine con la priorità più alta, aggiungila come primo elemento nella matrice.

Consigli per i connettori di persone

Di seguito sono riportate le linee guida e i consigli per i connettori Copilot con i dati delle persone, al fine di migliorare il ragionamento e la qualità della chat di Microsoft 365 Copilot e della ricerca di Copilot:

  • Riutilizza il più possibile le proprietà disponibili nelle entità del profilo, definite dalle etichette, invece di creare una proprietà personalizzata.
  • Per le proprietà personalizzate, usa un nome di proprietà comprensibile per utenti e agenti. Ad esempio, usare requisitionId al posto di reqId.
  • Quando si definisce lo schema, specificare un leggibile description per ogni proprietà personalizzata. Le descrizioni delle proprietà con person* etichette vengono ignorate.
  • Per proprietà personalizzate complesse, usare testo libero, Markdown o YAML al posto di JSON.

Note e limitazioni

  • I dati delle persone forniti tramite un connettore Copilot sono visibili a tutti gli utenti dell'organizzazione. I dati del connettore vengono archiviati nel profilo Microsoft 365 dell'utente. Per altre informazioni, vedere Connettori di Microsoft 365 Copilot per i dati sulle persone.
  • È necessario impostare l'elenco di controllo di accesso (ACL) sugli elementi inseriti dal connettore per concedere l'accesso a tutti.
  • È necessario fornire oggetti JSON codificati in stringhe valide per le entità del profilo. Microsoft Graph ignora i valori non validi.
  • Gli account utente non corrispondenti (userPrincipalName o externalDirectoryObjectId) vengono ignorati.
  • Microsoft Graph ignora gli account senza una cassetta postale di Exchange Online.
  • Microsoft Graph considera qualsiasi proprietà priva di etichetta come proprietà personalizzata.
  • Microsoft 365 potrebbe richiedere fino a 6 ore dopo la creazione della connessione prima che diventi disponibile nella ricerca, nelle esperienze degli utenti o in Copilot.
  • Le connessioni con i dati delle persone non supportano le connessioni a fasi.
  • Le etichette seguenti non sono attualmente supportate: personManager, personAssistants, personColleagues, personAlternateContactse personEmergencyContacts.
  • Il connettore principal Copilot e principalCollection i tipi di proprietà dello schema non sono attualmente supportati. Usa la colleagues raccolta dell'entità workPosition per creare relazioni.
  • I seguenti attributi dello schema del connettore Copilot vengono ignorati: isQueryable, isRefinable, isRetrievable, isSearchable. Tutti i dati relativi a una persona sono indicizzati per impostazione predefinita.