Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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
personAccountmapping aexternalItemuna 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
requisitionIdal posto direqId. - Quando si definisce lo schema, specificare un leggibile
descriptionper ogni proprietà personalizzata. Le descrizioni delle proprietà conperson*etichette vengono ignorate. - Per proprietà personalizzate complesse, usare testo libero, Markdown o
YAMLal posto diJSON.
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 (
userPrincipalNameoexternalDirectoryObjectId) 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,personAlternateContactsepersonEmergencyContacts. - Il connettore
principalCopilot eprincipalCollectioni tipi di proprietà dello schema non sono attualmente supportati. Usa lacolleaguesraccolta dell'entitàworkPositionper 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.