Compartir a través de

Implementación del conector de Confluence Cloud Copilot en el Centro de administración de Microsoft 365

El conector de Confluence Cloud Microsoft 365 Copilot integra contenido de Confluence en Microsoft 365, lo que permite a Copilot, Copilot Search y Microsoft Search exponer páginas wiki y blogs relevantes directamente dentro de aplicaciones como Teams, Outlook y SharePoint.

En este artículo se describen los pasos para implementar, personalizar y solucionar problemas del conector de Copilot en la nube de Confluence. Para obtener información general sobre la implementación del conector de Copilot, consulte Configuración de conectores de Copilot en el Centro de administración de Microsoft 365.

Para obtener información de configuración avanzada de Confluence Cloud, consulte Configuración del servicio en la nube de Confluence para la ingesta de conectores.

Requisitos previos

Antes de implementar el conector de Confluence Cloud, asegúrese de que el entorno de Confluence está configurado en su organización. En la tabla siguiente se resumen los pasos para configurar el entorno de Confluence e implementar el conector.

Tarea Role
Configurar el entorno Administrador de Confluence
Configuración de requisitos previos Administrador de confluencia/administrador de red
Implementar el conector en el Centro de administración de Microsoft 365 Administrador de Microsoft 365
Personalización de la configuración del conector (opcional) Administrador de Microsoft 365

Para implementar el conector, debe cumplir los siguientes requisitos previos:

  • Debe ser administrador del inquilino de Microsoft 365 de su organización y del sitio de Confluence de su organización.
  • Debe tener credenciales de autenticación con el acceso correcto.

Implementación del conector

Para agregar el conector de Confluence Cloud 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 Confluence Cloud.

Establecer el nombre para mostrar

El nombre para mostrar se usa para identificar referencias en las respuestas de Copilot para ayudar a los usuarios a reconocer el archivo o elemento asociado. El nombre para mostrar también significa contenido de confianza y se usa como filtro de origen de contenido.

Puede aceptar el nombre para mostrar predeterminado de Confluence Cloud o personalizar el valor para usar un nombre para mostrar que reconozcan los usuarios de su organización.

Para obtener más información sobre los nombres para mostrar y las descripciones de los conectores, consulte Mejora de la detección de Copilot con contenido de conectores Microsoft 365 Copilot.

Establecimiento de la dirección URL de la instancia

Para conectarse al sitio de Confluence, use la dirección URL del sitio, que suele ser la siguiente: https://<organization_name>.atlassian.net.

El <organization_name> valor es el identificador único del sitio de Confluence Cloud.

Elegir tipo de autenticación

Para autenticar y sincronizar contenido desde Confluence, elija uno de los siguientes tipos de autenticación:

  • Autenticación básica : para autenticarse mediante la autenticación básica, escriba el nombre de usuario (normalmente su dirección de correo electrónico) y el token de API. Para generar un token de API, consulte Administración de tokens de API para la cuenta de Atlassian.

  • OAuth 2.0 (recomendado): registre una aplicación en Confluence Cloud para que Microsoft Search y Microsoft 365 Copilot puedan acceder a la instancia. Para obtener más información, consulte Habilitación de OAuth 2.0 (3LO).

    Para registrar la aplicación:

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

    2. Elija Crear y seleccione Integración de OAuth 2.0.

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

    4. En el panel izquierdo, elija Permisos y, junto a Confluence API, elija Agregar.

    5. Elija Configurar>editar ámbitos y seleccione los ámbitos enumerados en la tabla siguiente.

      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 Acceso a permisos de grupo de contenido.
      Ver los detalles del usuario read:user:confluence Acceda a los detalles de usuario individuales para admitir permisos.
      Visualización de registros de auditoría read:audit-log:confluence Acceda a los registros de auditoría de eventos de Confluence para admitir permisos.
      Ver páginas read:page:confluence Acceda a los detalles del contenido de la página para admitir permisos.
      Ver espacios read:space:confluence Obtener acceso a los detalles del espacio para admitir permisos.
      Ver restricciones de contenido y permisos de espacio read:permission:confluence Ver las restricciones de contenido y los permisos de espacio.
      Ver resúmenes de contenido read:content.metadata:confluence Obtenga acceso a información sobre el contenido para admitir permisos.
      Ver comentarios read:comment:confluence Ver comentarios en páginas o entradas de blog.
      Visualización y descarga de datos adjuntos de contenido read:attachment:confluence Vea y descargue los datos adjuntos de una página o entrada de blog a la que tenga acceso.

    6. Seleccione Guardar.

    7. En el panel izquierdo, vaya a Autorización. Agregue la dirección URL de devolución de llamada para Microsoft 365, como se indica a continuación:

      • Microsoft 365 Enterprise :https://gcs.office.com/v1.0/admin/oauth/callback
      • Microsoft 365 Government: https://gcsgcc.office.com/v1.0/admin/oauth/callback 

    8. Seleccione Guardar.

    9. En el panel izquierdo, vaya a Configuración. Copie el identificador de cliente y el secreto. Complete el paso de configuración de conexión mediante el identificador de cliente y el secreto.

Sugerencia

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

Implementación

Implemente la conexión a un conjunto limitado de usuarios para validarla en Copilot y en otras superficies de búsqueda antes de implementarla en un público más amplio. Para obtener más información, consulte Lanzamiento provisional para conectores de Microsoft 365 Copilot.

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 implementar el conector, elija Crear en el Centro de administración de Microsoft 365. El conector de Confluence Cloud Copilot inicia la indexación de páginas desde la cuenta de Confluence de inmediato.

En la tabla siguiente se enumeran los valores predeterminados que se establecen. Estos valores funcionan mejor con los datos de Confluence.

Categoría Configuración Valor predeterminado
Usuarios Permisos de acceso Solo las personas con acceso al contenido del origen de datos.
Usuarios Asignar identidades Identidades de origen de datos asignadas mediante identificadores de Microsoft Entra.
Contenido Incluir o excluir espacio todas
Contenido Administrar propiedades Para ver las propiedades y esquemas predeterminados, vea Administrar propiedades.
Sincronizar Rastreo incremental Frecuencia: cada 15 minutos
Sincronizar Rastreo completo Frecuencia: todos los días

Para personalizar estos valores, 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 Confluence Cloud. 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

El conector de Confluence Cloud admite los siguientes permisos de búsqueda de usuarios:

  • Todos
  • Solo las personas con acceso a este origen de datos (valor predeterminado)

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 se especifica ninguna restricción de página, el conector comprueba los permisos de nivel de espacio y aplica lo siguiente:

  • Si el espacio tiene habilitado el acceso de usuarios anónimos , el contenido es visible para todos los usuarios del inquilino.
  • Si el espacio no tiene habilitado el acceso anónimo , se respetan los permisos de nivel de espacio.
  • Si no se definen los permisos de nivel de espacio, el contenido no es visible para ningún usuario del inquilino.

Importante

Los permisos solo se administran en el nivel de espacio y página. No se aplican permisos de página primarios.

Si elige Solo personas con acceso a este origen de datos, también debe elegir si el sitio de Confluence tiene Microsoft Entra ID usuarios aprovisionados o usuarios que no son usuarios de id. de entra:

  • Elija la opción Microsoft Entra ID si el identificador de correo electrónico de los usuarios de Confluence es el mismo que el nombre principal de usuario (UPN) en Microsoft Entra ID.
  • Elija la opción non-Entra ID si el identificador de correo electrónico de los usuarios de Confluence es diferente del UPN de Microsoft Entra ID.

Nota:

  • Si elige Microsoft Entra ID como origen de identidad, el conector asigna los identificadores de correo electrónico de usuario de Confluence a la propiedad UPN de Microsoft Entra ID.
  • Si elige non-Entra ID como origen de identidad, proporcione una expresión regular para asignar el identificador de correo electrónico a UPN. Para obtener más información, consulte Asignación de identidades de id. que no son de entra.
  • Novedades a los usuarios o grupos que rigen los permisos de acceso solo se sincronizan en rastreos completos. Los rastreos incrementales no admiten actualmente el procesamiento de actualizaciones de permisos.

Personalización de la configuración de contenido

Puede personalizar qué datos se incluyen y excluyen y personalizar las propiedades predeterminadas del conector.

Incluir o excluir datos

De forma predeterminada, el conector de Confluence Cloud indexa todos los blogs y páginas. Puede incluir o excluir los datos que desea indexar. Puede usar una cadena del Lenguaje de consulta de confluencia (CQL) para especificar condiciones para sincronizar páginas. Por ejemplo, puede optar por indexar solo las páginas modificadas en los dos últimos años. Para obtener más información, vea Búsqueda avanzada mediante CQL.

Sugerencia

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

Elija 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 del conector de Confluence Cloud, 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 Description
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.
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.

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

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 Confluence Cloud. Los conectores de Copilot usan dos tipos de intervalos de actualización:

  • Rastreo completo : realiza una sincronización completa de todo el contenido. Los rastreos completos detectan elementos eliminados y sincronizan los cambios de la lista de control de acceso (ACL). De forma predeterminada, los rastreos completos se ejecutan cada 24 horas.
  • Rastreo incremental : sincroniza el contenido nuevo y modificado. Los rastreos incrementales no recogen cambios de ACL ni elementos eliminados. De forma predeterminada, los rastreos incrementales se ejecutan 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

  • Last updated on