Implementación del conector de Microsoft 365 Copilot de recursos de Adobe Experience Manager

El conector Copilot assets de Adobe Experience Manager (AEM) integra contenido de AEM Assets en el ecosistema de Microsoft 365, lo que permite a Copilot y Microsoft Search exponer los recursos publicados. En este artículo se describen los pasos para implementar y personalizar el conector.

Requisitos previos

Antes de implementar el conector de recursos de Adobe Experience Manager, asegúrese de cumplir los siguientes requisitos previos:

• Debe ser el administrador de búsqueda del inquilino de Microsoft 365 de su organización.
• Tiene la dirección URL del entorno de creación de instancias de Adobe Experience Cloud de su organización y la dirección URL del entorno de publicación:
  • Formato de dirección URL de autor: https://author-p<PROGRAM_ID>-e<ENVIRONMENT_ID>.<REGION>.adobeaemcloud.com
  • Formato de dirección URL de publicación: https://publish-p<PROGRAM_ID>-e<ENVIRONMENT_ID>.<REGION>.adobeaemcloud.com
• Tiene una cuenta técnica para los recursos de Adobe Experience Manager con credenciales para acceder a los recursos y metadatos publicados. Esta cuenta es una cuenta segura basada en servicios para el acceso externo. Para obtener más información, consulte Generación de tokens de acceso para las API del lado servidor.

Implementación del conector

Para agregar el conector de recursos de Adobe Experience Manager para su organización:

1. En el Centro de administración de Microsoft 365, en el panel izquierdo, elija Conectores de Copilot>.
2. Vaya a la pestaña Conectores y, en el panel izquierdo, elija Galería.
3. En la lista de conectores disponibles, elija Recursos de Adobe Experience Manager.

Establecer el nombre para mostrar

El nombre para mostrar identifica las referencias en las respuestas de Copilot y actúa como filtro de origen de contenido. Puede aceptar el nombre para mostrar predeterminado o personalizarlo en un nombre que los usuarios de su organización reconozcan.

Para obtener más información, consulte Mejora de la detección de copilot del contenido del conector.

Establecimiento de la dirección URL de la instancia

Proporcione las direcciones URL del entorno de creación y publicación para la instancia de Recursos de Adobe Experience Manager.

Elegir tipo de autenticación

El conector admite la autenticación de cuentas técnicas para Adobe Experience Cloud. Configure la cuenta técnica como se describe en Generación de tokens de acceso para las API del lado servidor.

Implementación

Para validar el conector antes de la implementación, use un lanzamiento preconfigurado. Para implementarse en una audiencia limitada, elija el botón de alternancia situado junto a Lanzamiento a audiencia limitada y especifique los usuarios y grupos a los que se va a implementar el conector. Para obtener más información, consulte Lanzamiento provisional para conectores copilot.

Elija Crear para implementar la conexión. El conector comienza a indexar los recursos publicados inmediatamente.

En la tabla siguiente se enumeran los valores predeterminados que se establecen.

Para personalizar estos valores, elija Configuración personalizada. Para obtener más información, consulte Personalización de la configuración.

Después de crear la conexión, puede revisar el estado en la sección Conectores de la Centro de administración de Microsoft 365.

Personalización de la configuración (opcional)

Puede personalizar los valores predeterminados para la configuración del conector de recursos de Adobe Experience Manager. Para personalizar la configuración, en la página del conector del Centro de administración, elija Configuración personalizada. 

Personalización de la configuración de usuario

Permisos de acceso

Actualmente, solo se indexa los recursos publicados de los recursos de AEM. Todos los datos indexados mediante el conector Copilot de activos de Adobe Experience Manager son visibles para todos los usuarios de Microsoft 365 de su inquilino, desde Microsoft Search o Copilot.

Asignación de identidad de usuario

El conector asigna cuentas de usuario de Adobe Experience Cloud a identidades de Microsoft 365 (Microsoft Entra ID). Si los correos electrónicos de los usuarios de Adobe Experience Cloud coinciden con sus nombres principales de usuario (UPN) de Entra ID, esta asignación es automática. Si difieren, puede proporcionar una regla de asignación para asignar identidades en Adobe Experience Cloud a identidades de Microsoft 365. Las reglas de asignación garantizan que el sistema proporcione la señal de actividad adecuada al contenido de Adobe Experience Cloud en las respuestas.

Personalización de la configuración de contenido

Filtros de ingesta de contenido

Los filtros de ingesta de contenido permiten controlar qué recursos se indizan mediante la definición de reglas de inclusión y exclusión basadas en rutas de acceso y propiedades de metadatos.

Puede elegir incluir o excluir determinadas rutas de acceso de contenido.

Rutas de acceso de contenido que se deben capturar Solo se admiten rutas de acceso exactas. Una ruta de acceso de contenido válida debe contener al menos dos niveles, con /content como ruta de acceso raíz.

Rutas de acceso de contenido que no se deben capturar Solo admite la expresión regular de Java de entrada para las rutas de acceso. Las rutas de acceso excluidas tienen prioridad sobre las rutas de acceso incluidas.

También puede establecer filtros de ingesta en función del valor de las propiedades de metadatos, incluidas las propiedades de metadatos estándar y personalizadas:

1. Escriba la ruta de acceso JSON de la propiedad .
2. Seleccione un operador en la lista desplegable (=, !=, In, Not In).
3. Escriba el valor de destino.

Para buscar y comprobar la ruta de acceso de la propiedad, consulte API del generador de consultas.

1. Abra el depurador del generador de consultas en http://<host>:<port>/libs/cq/search/content/querydebug.html.

2. Escriba la siguiente consulta.

   p.limit=10  
   p.guessTotal=true  
   p.hits=full  
   type=dam:Asset  
   p.nodedepth=2  
   property=jcr:content/cq:lastReplicationAction  
   property.value=Activate
   

3. Elija buscar.

4. Una vez devueltos los resultados, elija el vínculo generador de consultas JSON para ver el contenido JSON con todas las propiedades.

   

5. Busque la propiedad y la ruta de acceso JSON de la propiedad. Por ejemplo, la ruta de acceso JSON de la propiedad dc:format es hits.jcr:content.metadata.dc:format.

   

Operadores
El operador define el tipo de comparación aplicado a una propiedad durante el filtrado de contenido. Los operadores admitidos son:

• =:Iguales
• !=: no es igual a
• In: coincide con cualquier valor de una lista
• Not In: excluye cualquier valor de una lista

Valores de destino
Los valores de destino especifican lo que debe coincidir la propiedad.

Administrar propiedades

Para comprobar las propiedades estándar disponibles de los recursos de Adobe Experience Manager, asigne un esquema a la propiedad (defina si una propiedad se puede buscar, consultar, recuperar o refinar), cambie la etiqueta semántica y agregue un alias a la propiedad. Las siguientes propiedades estándar se indizan de forma predeterminada.

Para agregar más propiedades personalizadas:

1. Seleccione Agregar propiedad.
2. Rellene los campos siguientes: a. Nombre de propiedad b. Escriba c. Ruta de acceso JSON
3. Defina el esquema (que se puede buscar, consultar, recuperar o refinable).

Personalización de intervalos de sincronización

El intervalo de actualización determina la frecuencia con la que se sincronizan los datos entre el origen de datos y el índice del conector de recursos de Adobe Experience Manager. Los conectores de Copilot usan dos tipos de intervalos de actualización:

• Rastreo completo: el valor predeterminado es cada día.
• Rastreo incremental: el valor predeterminado es cada 15 minutos.

Puede cambiar los valores predeterminados de los intervalos de actualización. Para obtener más información, consulte Directrices para la configuración de sincronización.

Contenido relacionado

• Introducción al conector de recursos de Adobe Experience Manager
• Solución de problemas con el conector de recursos de Adobe Experience Manager