Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Los conectores de Microsoft 365 Copilot para datos de personas le permiten ingerir datos de personas y conocimientos de los sistemas de origen (por ejemplo, recursos humanos, administración de talento u otros sistemas de personas) en Microsoft Graph. Al agregar datos de personas a Microsoft Graph, estará disponible para las experiencias de Microsoft 365 Copilot y contactos, como la tarjeta de perfil y la búsqueda de personas. Cuando ingiere datos, Copilot puede razonar sobre los datos y usarlos para responder a las preguntas de los usuarios.
Cree conectores de Microsoft 365 Copilot para datos de personas de la misma manera que crea otros conectores de Copilot, mediante las API de conexiones externas de Microsoft Graph. Para asegurarse de que Microsoft 365 reconoce que su conexión contiene datos de personas, siga los requisitos de configuración y esquema de conexión y registre la conexión como un origen de datos de perfil.
Nota
Para obtener un ejemplo de un conector que proporciona datos de personas, consulte Conector de Microsoft 365 Copilot para muestra de datos de personas.
Requisitos de configuración de conexión
Los conectores de Copilot que contienen datos de personas deben tener el valor people en la contentCategory propiedad de la externalConnections API.
Requisitos del esquema de conexión
Los conectores de Microsoft 365 Copilot para personas admiten el enriquecimiento de datos para las siguientes entidades de perfil de usuario de Microsoft 365.
- El esquema debe tener una propiedad con la
personAccountetiqueta para poder asignar laexternalItema una persona. - Las propiedades sin una etiqueta se consideran propiedades personalizadas.
| Etiqueta de propiedad | Tipo de propiedad | Entidad de perfil | Descripción |
|---|---|---|---|
personAccount |
string |
userAccountInformation |
Indica el usuario de Microsoft Entra ID al que se dirige el elemento. |
personCurrentPosition |
string |
workPosition |
Describe la posición actual de la persona. |
personAddresses |
stringCollection |
itemAddress |
Máximo 3, uno de cada uno de Home, Worky Other. Agrega direcciones al usuario. |
personAnniversaries |
stringCollection |
personAnniversary |
Agrega uno o más aniversarios a la persona. |
personAwards |
stringCollection |
personAward |
Describe los premios que ha ganado el usuario. |
personCertifications |
stringCollection |
personCertification |
Describe las certificaciones que obtuvo el usuario. |
personEducationalActivities |
stringCollection |
educationalActivity |
Describe las actividades educativas del usuario. |
personEmails |
stringCollection |
itemEmail |
Máximo 3. Agrega direcciones de correo electrónico al usuario. |
personInterests |
stringCollection |
personInterest |
Información detallada sobre los intereses del usuario. |
personLanguages |
stringCollection |
languageProficiency |
Información detallada sobre los idiomas que conoce el usuario. |
personName |
string |
personName |
Agrega nombres al usuario. |
personNote |
string |
personAnnotation |
Agrega una nota al usuario. |
personPatents |
stringCollection |
itemPatent |
Describe una patente concedida o presentada con la que el usuario está asociado. |
personPhones |
stringCollection |
itemPhone |
Agrega números de teléfono al usuario. |
personPublications |
stringCollection |
itemPublication |
Describe las publicaciones o artículos a los que está asociado el usuario. |
personProjects |
stringCollection |
projectParticipation |
Describe los proyectos en los que ha participado el usuario. |
personSkills |
stringCollection |
skillProficiency |
Describe las aptitudes en las que el usuario es competente. |
personWebAccounts |
stringCollection |
webAccount |
Describe las cuentas web externas que tiene el usuario. |
personWebSite |
string |
webSite |
Describe un sitio web para el usuario. |
personWorkPositions |
stringCollection |
workPosition |
Describe los puestos de trabajo históricos del usuario. |
Ejemplo de esquema:
{
"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"
}
]
}
Serialización de entidades JSON
Cada propiedad, con una etiqueta, es de tipo string o stringCollection, y es una representación de cadena serializada JSON de la entidad de perfil de Microsoft 365 que se va a enriquecer.
{
...
"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"
}
}
Registro de la conexión como origen de perfil
Después de crear la conexión, regístrela como un origen de datos de perfil y agréguela a la lista de orígenes prioritarios.
Registre la conexión como origen de perfil mediante la API de origen de perfil con sourceId el identificador de conexión del conector y la webUrl propiedad establecida en un vínculo HTTPS al sistema externo o a una página con información adicional sobre el origen.
Después del registro, agregue la conexión a la lista de orígenes de perfiles priorizados mediante la API de configuración de propiedades del perfil. Agregue la dirección URL al origen del perfil, en el formato de https://graph.microsoft.com/v1.0/admin/people/profileSources(sourceId='connectionId'), donde connectionId es el id. de conexión único de la conexión, a la prioritizedSourceUrls matriz. Esta matriz representa el orden en que Microsoft 365 compone la vista de una persona. Si desea que su conexión sea el origen de mayor prioridad, agréguela como primer elemento de la matriz.
Recomendaciones para los conectores de personas
Las siguientes son directrices y recomendaciones para los conectores de Copilot con datos de personas, para mejorar el razonamiento y la calidad en el chat de Microsoft 365 Copilot y la búsqueda de Copilot:
- Reutilice la mayor cantidad posible de las propiedades disponibles en las entidades de perfil, definidas por las etiquetas, en lugar de crear una propiedad personalizada.
- Para las propiedades personalizadas, use un nombre de propiedad que los usuarios y agentes comprendan. Por ejemplo, use
requisitionIden lugar dereqId. - Al definir el esquema, proporcione un elemento legible
descriptionpara cada propiedad personalizada. Las descripciones de las propiedades conperson*etiquetas se omiten. - Para propiedades personalizadas complejas, use texto libre, Markdown o
YAMLen lugar deJSON.
Notas y limitaciones
- Los datos de People proporcionados a través de un conector de Copilot son visibles para todos los usuarios de la organización. Los datos del conector se almacenan en el perfil de Microsoft 365 del usuario. Para obtener más información, consulte Conectores de Microsoft 365 Copilot para datos de personas.
- Debe establecer la lista de control de acceso (ACL) en los elementos ingeridos por el conector para conceder acceso a todos los usuarios.
- Debe proporcionar objetos JSON codificados en cadena válidos para las entidades de perfil. Microsoft Graph omite los valores no válidos.
- Se omiten las cuentas de usuario (
userPrincipalNameoexternalDirectoryObjectId) no coincidentes. - Microsoft Graph omite las cuentas sin buzón de correo de Exchange Online.
- Microsoft Graph trata cualquier propiedad sin una etiqueta como una propiedad personalizada.
- Microsoft 365 puede tardar hasta 6 horas después de crear la conexión antes de que esté disponible en la búsqueda, las experiencias de personas o Copilot.
- Las conexiones con datos de personas no admiten conexiones por etapas.
- Las siguientes etiquetas no se admiten actualmente:
personManager,personAssistants,personColleaguespersonAlternateContacts, ypersonEmergencyContacts. - El conector
principalde Copilot yprincipalCollectionlos tipos de propiedad de esquema no se admiten actualmente. Use lacolleaguescolección de laworkPositionentidad para crear relaciones. - Se omiten los siguientes atributos de esquema del conector de Copilot:
isQueryable,isRefinable,isRetrievable,isSearchable. Todos los datos sobre una persona se indexan de forma predeterminada.