Crear conectores de Microsoft 365 Copilot para datos de personas

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 personAccount etiqueta para poder asignar la externalItem a 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 requisitionId en lugar de reqId.
  • Al definir el esquema, proporcione un elemento legible description para cada propiedad personalizada. Las descripciones de las propiedades con person* etiquetas se omiten.
  • Para propiedades personalizadas complejas, use texto libre, Markdown o YAML en lugar de JSON.

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 (userPrincipalName o externalDirectoryObjectId) 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, y personEmergencyContacts.
  • El conector principal de Copilot y principalCollection los tipos de propiedad de esquema no se admiten actualmente. Use la colleagues colección de la workPosition entidad 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.