Compartir a través de


Conector de Confluence Cloud Microsoft 365 Copilot

El conector de confluence Cloud Microsoft 365 Copilot permite a su organización indexar el contenido de Confluence. Después de configurar el conector y los datos de índice desde el sitio de Confluence, los usuarios finales pueden buscar ese contenido en Microsoft Search y Microsoft 365 Copilot.

Este artículo está destinado a los administradores de Microsoft 365 que son responsables de configurar, ejecutar y supervisar el conector de Copilot en la nube de Confluence. Complementa las instrucciones generales proporcionadas en la configuración de conectores de Microsoft Copilot en el Centro de administración de Microsoft 365.

Capacidades

  • Los usuarios pueden formular preguntas en lenguaje natural sobre el contenido wiki en Copilot, como resumir el documento de arquitectura o obtener acceso a un portal.
  • Los usuarios pueden realizar consultas de lenguaje natural para obtener respuestas precisas.

Requisitos previos

  • Debe ser el administrador del inquilino de Microsoft 365 de su organización y el administrador del sitio de Confluence de la organización.
  • Asegúrese de que tiene credenciales de autenticación con el acceso correcto.

Importante

  • En enero de 2024, Atlassian desusó un conjunto de API en la nube de Confluence (versión 1) y lanzó nuevas API (versión 2). Para obtener más información, consulte actualizaciones de registro de cambios y actualizaciones generales. Algunas de estas API v1 en desuso las usa el conector solo para las conexiones de OAuth . Por lo tanto, después de este cambio, las conexiones de Confluence existentes pueden dejar de funcionar.
  • En diciembre de 2023, se lanzó un nuevo conjunto de API v2 a todos los clientes. Después de la versión, las conexiones existentes necesitaban volver a autenticarse. Las nuevas API v2 también requieren algunos ámbitos más (en comparación con las API v1 anteriores), que deben proporcionarse durante la nueva autenticación. Se requiere un nuevo conjunto de ámbitos (lista completa): read:group:confluence, read:user:confluence, , Read:space:confluenceread:content-details:confluence, Read:permission:confluence, , read:audit-log:confluenceread:content.metadata:confluence y read:page:confluence.
  • A partir de julio de 2025, el conector de Confluence Cloud admite la indexación de comentarios y la asignación en las páginas. Para aprovechar esta nueva funcionalidad, las conexiones existentes necesitaban volver a autenticarse y se deben agregar dos ámbitos más ( read:comment:confluence, read:attachment:confluence) a la aplicación de incorporación de OAuth 2.

Introducción

1. Nombre para mostrar

Un nombre para mostrar se usa para identificar cada referencia en Copilot, lo que ayuda a los usuarios a reconocer fácilmente el archivo o elemento asociado. El nombre para mostrar también significa contenido de confianza. El nombre para mostrar también se usa como filtro de origen de contenido. Hay un valor predeterminado para este campo, pero puede personalizarlo para un nombre que los usuarios de su organización reconozcan.

2. Dirección URL de Confluence Cloud

Para conectarse al sitio de Confluence, use la dirección URL del sitio. Normalmente, una dirección URL del sitio en la nube de Confluence se parece a https://< organization_name.atlassian.net/>.

3. Tipo de autenticación

Para autenticar y sincronizar contenido desde Confluence On-prem, elija uno de los dos métodos admitidos:

Sugerencia

Asegúrese de que la cuenta de servicio tiene acceso de vista al contenido de Confluence que desea indexar.

a. Autenticación básica
Para autenticarse mediante la autenticación básica, escriba el nombre de usuario (normalmente el correo electrónico) y el token de API. Para ayudar a generar un token de API, consulte la guía de Atlassian.

b. OAuth 2.0 (recomendado)
Registre una aplicación en Confluence Cloud para que la aplicación Microsoft Search y Microsoft 365 Copilot puedan acceder a la instancia. Para más información, consulte la documentación de soporte técnico de Atlassian sobre cómo habilitar OAuth 2.0.

En los pasos siguientes se proporcionan instrucciones sobre cómo registrar la aplicación:

  1. Inicie sesión en la consola de Atlassian Developer con su cuenta de administrador de Atlassian Confluence.

  2. Haga clic en Crear y seleccione OAuth 2.0 integration.

  3. Proporcione un nombre adecuado para la aplicación y cree la nueva aplicación.

  4. Vaya a Permissions desde el panel de navegación de la izquierda. Haga clic en Agregar para Confluence API. Una vez agregado, haga clic en Configurar y Editar ámbitos y seleccione los siguientes ámbitos.

    Nombre de ámbito Código Descripción
    Ver los detalles del contenido read:content-details:confluence Rastreo de contenido que cumple los criterios.
    Ver grupos read:group:confluence Para acceder a los permisos de grupo de contenido.
    Ver los detalles del usuario read:user:confluence Para acceder a los detalles de usuario individuales para admitir permisos.
    Visualización de registros de auditoría read:audit-log:confluence Para acceder a los registros de auditoría de eventos de Confluence para admitir permisos.
    Ver páginas read:page:confluence Para acceder a los detalles del contenido de la página para admitir permisos.
    Ver espacios read:space:confluence Para acceder a los detalles del espacio para admitir permisos.
    Ver resúmenes de contenido read:content.metadata:confluence Para acceder a información sobre el contenido para admitir permisos.
    Ver restricciones de contenido y permisos de espacio read:permission:confluence Para acceder a restricciones de contenido y detalles de permisos de espacio para admitir permisos.
    Ver comentarios read:comment:confluence Ver comentarios en páginas o blogs.
    Visualización y descarga de datos adjuntos de contenido read:attachment:confluence Vea y descargue los datos adjuntos de una página o blog a la que tiene acceso.
  5. Haga clic en Guardar.

  6. Vaya a Authorization desde el panel de navegación de la izquierda. Agregue la dirección URL de devolución de llamada, para Microsoft 365 Enterprise: https://gcs.office.com/v1.0/admin/oauth/callback, para Microsoft 365 Government: https://gcsgcc.office.com/v1.0/admin/oauth/callback y guarde los cambios.

  7. Vaya a Configuración desde el panel de navegación de la izquierda. Obtendrá el id. de cliente y el secreto de esta página.

Complete el paso de configuración de conexión mediante el id. de cliente y el secreto.

6. Lanzamiento a un público limitado

Implemente esta conexión en una base de usuarios limitada si desea validarla en Copilot y en otras superficies de búsqueda antes de expandir el lanzamiento a una audiencia más amplia. Para más información sobre el lanzamiento limitado, haga clic aquí.

En este momento, está listo para crear la conexión para Confluence Knowledge. Puede hacer clic en el botón "Crear" y el conector de Microsoft Graph en la nube de Confluence inicia la página de indexación desde la cuenta de Confluence.

Para otras configuraciones, como permisos de acceso, reglas de inclusión de datos, esquema, frecuencia de rastreo, etc., establecemos valores predeterminados en función de lo que funciona mejor con los datos de Confluence. Los valores predeterminados son los siguientes:

Usuarios  
Permisos de acceso Solo las personas con acceso al contenido del origen de datos.
Identidades de mapa Identidades de origen de datos asignadas mediante identificadores de Microsoft Entra.
Contenido  
Incluir o excluir espacio Todo
Administrar propiedades Para comprobar las propiedades predeterminadas y su esquema, haga clic aquí.
Sincronizar  
Rastreo incremental Frecuencia: Cada 15 minutos
Rastreo completo Frecuencia: todos los días

Si desea editar cualquiera de estos valores, debe elegir la Custom Setup opción .

Configuración personalizada

En la configuración personalizada, puede editar cualquiera de los valores predeterminados para los usuarios, el contenido y la sincronización.

Usuarios

Permisos de acceso

El conector de Confluence Cloud Copilot admite permisos de búsqueda visibles para todos o solo personas con acceso a este origen de datos. Si elige Todos, los datos indexados aparecerán en los resultados de búsqueda de todos los usuarios. Si elige Solo las personas con acceso a este origen de datos, los datos indexados aparecerán en los resultados de la búsqueda para los usuarios que tengan acceso a él. En Confluence Cloud, los permisos de seguridad para usuarios y grupos se definen mediante permisos de espacio y restricciones de página. Las restricciones de nivel de página, si están presentes, tienen prioridad sobre los permisos de espacio.

Si no hay restricciones de página, el conector comprueba si hay permisos de nivel de espacio:

  • En caso de que el espacio tenga habilitado el acceso de "usuarios anónimos", el contenido es visible para todos los usuarios del inquilino.
  • En caso de que no se habilite el "acceso anónimo", se respetan los permisos de nivel de espacio.
  • En caso de que no se definan permisos de nivel de espacio, el contenido no es visible para ningún usuario del inquilino.

Importante

Los permisos se administran solo en el nivel de espacio y página, y no se tienen en cuenta los permisos de página primaria.

Si elige Solo personas con acceso a este origen de datos, debe elegir aún más si el sitio de Confluence tiene Microsoft Entra ID usuarios aprovisionados o usuarios que no son de AAD.

Para identificar qué opción es adecuada para su organización:

  1. Elija la opción Microsoft Entra ID si el identificador de correo electrónico de los usuarios de Confluence es el mismo que el userprincipalName (UPN) de los usuarios de Microsoft Entra ID.
  2. Elija la opción que no es de AAD si el identificador de correo electrónico de los usuarios de Confluence es diferente del userprincipalName (UPN) de los usuarios de Microsoft Entra ID.

Nota:

  • Si elige Microsoft Entra ID como el tipo de origen de identidad, el conector asigna los identificadores de correo electrónico de los usuarios obtenidos de Confluence directamente a la propiedad UPN de Microsoft Entra ID.
  • Si eligió "No AAD" para el tipo de identidad, consulte Asignación de identidades que no son de Azure AD para obtener instrucciones sobre cómo asignar las identidades. Puede usar esta opción para proporcionar la expresión regular de asignación del identificador de correo electrónico a UPN.
  • Novedades a usuarios o grupos que rigen los permisos de acceso solo se sincronizan en rastreos completos. Actualmente, los rastreos incrementales no admiten el procesamiento de actualizaciones de permisos.

Contenido

Inclusión o exclusión de datos que desea indexar

Con una cadena de Lenguaje de consulta de confluencia (CQL), puede especificar condiciones para sincronizar páginas. Es como una cláusula Where en una instrucción SELECT de SQL . Por ejemplo, puede optar por indexar solo las páginas modificadas en los dos últimos años. Para obtener información sobre cómo crear su propia cadena de consulta, consulte Búsqueda avanzada mediante CQL. El conector indexa todos los blogs y páginas de forma predeterminada.

Sugerencia

Puede usar el filtro CQL para indexar el contenido modificado después de un tiempo determinado mediante lastModified >= "2018/12/31"

Use el botón vista previa de los resultados para comprobar los valores de ejemplo de las propiedades seleccionadas y la cadena de CQL.

Administrar propiedades

Para agregar o quitar propiedades disponibles de Aha!, 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 propiedades siguientes se indizan de forma predeterminada.

Propiedad predeterminada Etiqueta Descripción
Autores authors Nombre de las personas que participaron o colaboraron en el elemento del origen de datos.
CreatedByName createdBy Nombre de la persona que más recientemente editó el elemento en el origen de datos.
CreatedOn createdDateTime Fecha y hora en que se creó el elemento en el origen de datos.
IconUrl iconUrl Dirección URL del icono asociado del elemento.
Title title El título del elemento que desea que se muestre en la búsqueda y en otras experiencias.
UpdatedByName lastModifiedBy Nombre de la persona que más recientemente editó el elemento en el origen de datos.
UpdatedOn lastModifiedDateTime Fecha y hora en que el elemento se modificó por última vez en el origen de datos.
Url url Dirección URL de destino del elemento en el origen de datos.

Vista previa de datos

Use el botón vista previa de los resultados para comprobar las propiedades y los filtros seleccionados.

Sincronizar

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 Confluence Cloud Copilot. Hay dos tipos de intervalos de actualización: rastreo completo y rastreo incremental. Para obtener más información, haga clic aquí. Puede cambiar los valores predeterminados del intervalo de actualización desde aquí si lo desea.

Revisión y prueba de la conexión

Para Microsoft Search, si necesita personalizar la página de resultados de la búsqueda. Para obtener información sobre cómo personalizar los resultados de la búsqueda, vea Personalizar la página de resultados de búsqueda.

Si tiene problemas o quiere proporcionar comentarios, póngase en contacto con Microsoft Graph | Soporte técnico.