Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Microsoft 365 Copilot-Connectors für Personendaten ermöglichen es Ihnen, personenbezogene Daten und Wissen aus Ihren Quellsystemen (z. B. Personalwesen, Talentmanagement oder andere Personensysteme) in Microsoft Graph zu erfassen. Durch das Hinzufügen von Personendaten zu Microsoft Graph stehen sie für Microsoft 365 Copilot und Personenerfahrungen wie die Profilkarte und die Personensuche zur Verfügung. Wenn Sie Ihre Daten erfassen, kann Copilot die Daten analysieren und sie verwenden, um auf Benutzerfragen zu antworten.
Sie erstellen Microsoft 365 Copilot-Connectors für Personendaten auf die gleiche Weise wie andere Copilot-Connectors, indem Sie die externen Verbindungs-APIs von Microsoft Graph verwenden. Um sicherzustellen, dass Microsoft 365 erkennt, dass Ihre Verbindung Personendaten enthält, befolgen Sie die Anforderungen an die Verbindungskonfiguration und das Schema, und registrieren Sie die Verbindung als Quelle für Profildaten.
Hinweis
Ein Beispiel für einen Connector, der Personendaten bereitstellt, finden Sie im Beispiel für Microsoft 365 Copilot-Connector für Personendaten.
Anforderungen an die Verbindungskonfiguration
Copilot-Connectors, die Personendaten enthalten, müssen den Wert people in der externalConnectionscontentCategory Eigenschaft der API haben.
Anforderungen an das Verbindungsschema
Microsoft 365 Copilot-Connectors für Personendaten unterstützen die Anreicherung für die folgenden Microsoft 365-Benutzerprofilentitäten.
- Das Schema muss eine Eigenschaft mit der
personAccountBezeichnung haben, um sieexternalItemeiner Person zuordnen zu können. - Eigenschaften ohne Bezeichnung gelten als benutzerdefinierte Eigenschaften.
| Eigenschaftenbezeichnung | Immobilientyp | Profilentität | Beschreibung |
|---|---|---|---|
personAccount |
string |
userAccountInformation |
Gibt den Microsoft Entra ID-Benutzer an, auf den das Element abzielt. |
personCurrentPosition |
string |
workPosition |
Beschreibt die aktuelle Position der Person. |
personAddresses |
stringCollection |
itemAddress |
Max 3, jeweils eines von Home, Workund Other. Fügt dem Benutzer Adressen hinzu. |
personAnniversaries |
stringCollection |
personAnniversary |
Fügt der Person einen oder mehrere Jahrestage hinzu. |
personAwards |
stringCollection |
personAward |
Beschreibt die Auszeichnungen, die der Benutzer erhalten hat. |
personCertifications |
stringCollection |
personCertification |
Beschreibt die Zertifizierungen, die der Benutzer erworben hat. |
personEducationalActivities |
stringCollection |
educationalActivity |
Beschreibt die Bildungsaktivitäten des Benutzers. |
personEmails |
stringCollection |
itemEmail |
Max 3. Fügt dem Benutzer E-Mail-Adressen hinzu. |
personInterests |
stringCollection |
personInterest |
Detaillierte Informationen zu den Interessen des Nutzers. |
personLanguages |
stringCollection |
languageProficiency |
Ausführliche Informationen zu Sprachen, die der Benutzer kennt. |
personName |
string |
personName |
Fügt dem Benutzer Namen hinzu. |
personNote |
string |
personAnnotation |
Fügt dem Benutzer eine Notiz hinzu. |
personPatents |
stringCollection |
itemPatent |
Beschreibt ein erteiltes oder eingereichtes Patent, mit dem der Benutzer verbunden ist. |
personPhones |
stringCollection |
itemPhone |
Fügt dem Benutzer Telefonnummern hinzu. |
personPublications |
stringCollection |
itemPublication |
Beschreibt Veröffentlichungen oder Artikel, mit denen der Benutzer verbunden ist. |
personProjects |
stringCollection |
projectParticipation |
Beschreibt Projekte, an denen der Benutzer beteiligt war. |
personSkills |
stringCollection |
skillProficiency |
Beschreibt Fähigkeiten, die der Benutzer beherrscht. |
personWebAccounts |
stringCollection |
webAccount |
Beschreibt externe Webkonten des Benutzers. |
personWebSite |
string |
webSite |
Beschreibt eine Website für den Benutzer. |
personWorkPositions |
stringCollection |
workPosition |
Beschreibt die historischen Arbeitspositionen des Benutzers. |
Beispielschema:
{
"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"
}
]
}
Serialisierung von JSON-Entitäten
Jede Eigenschaft mit einer Bezeichnung ist entweder vom Typ string or stringCollectionund ist eine serialisierte JSON-Zeichenfolgendarstellung der Microsoft 365-Profilentität, die angereichert werden soll.
{
...
"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"
}
}
Registrieren der Verbindung als Profilquelle
Nachdem Sie die Verbindung erstellt haben, registrieren Sie sie als Quelle von Profildaten, und fügen Sie sie der Liste der priorisierten Quellen hinzu.
Sie registrieren die Verbindung als Profilquelle, indem Sie die Profilquellen-API verwenden, sourceId wobei die Verbindungs-ID Ihres Connectors und die webUrl Eigenschaft auf einen HTTPS-Link entweder zum externen System oder zu einer Seite mit zusätzlichen Informationen über die Quelle festgelegt ist.
Fügen Sie nach der Registrierung die Verbindung mithilfe der API für die Profileigenschaftseinstellungen der Liste der priorisierten Profilquellen hinzu. Fügen Sie die URL zur Profilquelle im Format https://graph.microsoft.com/v1.0/admin/people/profileSources(sourceId='connectionId'), wobei connectionId die eindeutige Verbindungs-ID der Verbindung ist, zum prioritizedSourceUrls Array hinzu. Dieses Array stellt die Reihenfolge dar, in der Microsoft 365 die Ansicht einer Person zusammensetzt. Wenn Ihre Verbindung die Quelle mit der höchsten Priorität sein soll, fügen Sie sie als erstes Element im Array hinzu.
Empfehlungen für Personen-Connectors
Im Folgenden finden Sie Richtlinien und Empfehlungen für Copilot-Connectors mit Personendaten, um das logischen Denken und die Qualität in Microsoft 365 Copilot-Chat und Copilot-Suche zu verbessern:
- Verwenden Sie so viele der verfügbaren Eigenschaften wie möglich in den Profilentitäten wieder, die durch die Bezeichnungen definiert werden, anstatt eine benutzerdefinierte Eigenschaft zu erstellen.
- Verwenden Sie für benutzerdefinierte Eigenschaften einen Eigenschaftsnamen, den Benutzer und Agents verstehen. Verwenden Sie
requisitionIdbeispielsweise anstelle vonreqId. - Stellen Sie beim Definieren des Schemas für jede benutzerdefinierte Eigenschaft eine lesbare Datei
descriptionbereit. Beschreibungen von Eigenschaften mitperson*Bezeichnungen werden ignoriert. - Verwenden Sie für komplexe benutzerdefinierte Eigenschaften freien Text, Markdown oder
YAMLanstelle vonJSON.
Hinweise und Einschränkungen
- Über einen Copilot-Connector bereitgestellte Personendaten sind für alle Benutzer in der Organisation sichtbar. Connector-Daten werden im Microsoft 365-Profil des Benutzers gespeichert. Weitere Informationen finden Sie unter Microsoft 365 Copilot-Connectors für Personendaten.
- Sie müssen die Zugriffssteuerungsliste (Access Control List, ACL) für vom Connector erfasste Elemente festlegen, um jedem Zugriff zu gewähren.
- Sie müssen gültige JSON-Objekte mit Zeichenfolgencodierung für Profilentitäten bereitstellen. Microsoft Graph ignoriert ungültige Werte.
- Nicht übereinstimmende Benutzerkonten (
userPrincipalNameoderexternalDirectoryObjectId) werden ignoriert. - Microsoft Graph ignoriert Konten ohne Exchange Online-Postfach.
- Microsoft Graph behandelt jede Eigenschaft ohne Bezeichnung als benutzerdefinierte Eigenschaft.
- Es kann bis zu 6 Stunden dauern, bis Microsoft 365 nach dem Herstellen der Verbindung in der Suche, in Kontaktefunktionen oder in Copilot verfügbar wird.
- Verbindungen mit Personendaten unterstützen keine gestaffelten Verbindungen.
- Die folgenden Bezeichnungen werden derzeit nicht unterstützt:
personManager,personAssistants,personColleaguespersonAlternateContacts, undpersonEmergencyContacts. - Die Copilot-Connector
principal- undprincipalCollectionSchemaeigenschaftstypen werden derzeit nicht unterstützt. Verwenden Sie diecolleaguesSammlung der Entität,workPositionum Beziehungen zu erstellen. - Die folgenden Copilot-Connectorschemaattribute werden ignoriert:
isQueryable,isRefinable,isRetrievable,isSearchable. Alle Daten zu einer Person werden standardmäßig indiziert.