Compartir a través de

Conector de Microsoft 365 Copilot de solicitud de incorporación de cambios bitbucket (versión preliminar)

El conector de Microsoft 365 Copilot de solicitud de incorporación de cambios de Bitbucket permite a su organización indexar solicitudes de incorporación de cambios y documentación (archivos .txt y .md) almacenadas en Bitbucket. Después de configurar el conector y el contenido de Bitbucket de índice, los usuarios pueden buscar y recuperar información a través de Microsoft Search y Microsoft 365 Copilot.

Este artículo está pensado para administradores de Microsoft 365 o cualquier persona que configure, ejecute o supervise el conector bitbucket Copilot.

Capacidades

  • Indexar repositorios de Bitbucket, solicitudes de incorporación de cambios y documentación.
  • Habilite Microsoft Search y Microsoft 365 Copilot para recuperar datos de Bitbucket de forma eficaz.
  • Mantenga las ACL de Bitbucket y los permisos de usuario.
  • Permitir a los administradores personalizar la frecuencia de rastreo y las preferencias de indexación.

Limitaciones

  • El conector no admite la indexación de canalizaciones de CI/CD de Bitbucket más allá de la indexación de estado.
  • Solo se indizan repositorios, solicitudes de incorporación de cambios, archivos .md y .txt.
  • Actualmente no se admiten instancias de Bitbucket locales o autohospedadas.
  • El conector puede dejar el campo LastModifiedBy en blanco en los casos en los que los cambios de Git no se asignan a una cuenta de Bitbucket. Esto ocurre cuando una configuración manual que vincula los cambios de Git a las cuentas de usuario de Bitbucket no se completa antes de un rastreo incremental.

Requisitos previos

  1. La instancia de Bitbucket es accesible a través de la API.
  2. La cuenta de usuario que se usa para la autenticación tiene acceso a los repositorios, las solicitudes de incorporación de cambios y los archivos de conocimiento que se van a indexar.
  3. Los usuarios que acceden a datos bitbucket indexados tienen identidades de Microsoft Entra ID correspondientes para la asignación de permisos.
  4. Configuración de un consumidor de OAuth en Bitbucket
    1. Vaya a la página del área de trabajo en Bitbucket.
    2. Haga clic en el icono de engranaje de la esquina superior derecha y seleccione Configuración del área de trabajo.
    3. En el panel de navegación izquierdo, seleccione Consumidores de OAuth que se encuentran en la sección Flujos de trabajo.
    4. Haga clic en Agregar consumidor y rellene según las siguientes direcciones URL de redireccionamiento:
    • Para Microsoft 365 Enterprise, usehttps://gcs.office.com/v1.0/admin/oauth/callback
    • Para Microsoft 365 Government, use https://gcsgcc.office.com/v1.0/admin/oauth/callback
    1. Habilite la clave para que tenga los siguientes permisos configurados para leer problemas:
    • Cuenta
    • Repositorios
    • Solicitudes de incorporación de cambios
    1. Guarde la configuración y copie los valores de clave y secreto.

Se recomienda usar cuentas de usuario independientes para la autenticación de OAuth con cada conexión, ya que el límite de velocidad de Bitbucket se calcula individualmente por usuario.

Introducción

Elección del nombre para mostrar

Elija un nombre para mostrar que ayude a los usuarios a reconocer solicitudes de combinación o documentación en una respuesta de Copilot.

Dirección URL de instancia de Bitbucket

Escriba la dirección URL de la instancia de Bitbucket (por ejemplo, https://bitbucket.org/testinstance).

Tipo de autenticación

  1. Escriba el identificador de cliente mediante la clave del consumidor de OAuth bitbucket y el secreto de cliente mediante el secreto de consumidor de OAuth correspondiente.
  2. Elija Autorizar para iniciar sesión y conceder acceso.
  3. Haga clic en Autorizar para iniciar sesión y conceder los permisos de acceso necesarios.

Implementación a un público limitado

Antes de implementar el conector, pruebe la conexión con una base de usuarios limitada en Copilot y Microsoft Search.

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

Asignación de identidades

De forma predeterminada, debido a la limitación de bitbucket API, el conector asigna correos electrónicos en Microsoft Entra ID mediante nombres públicos de Bitbucket. Si esta asignación no se alinea con la configuración, personalice la asignación de identidades.

Para garantizar la correcta aplicación de permisos, asigne las identidades de usuario de Bitbucket a Microsoft Entra ID. Las opciones disponibles son las siguientes:

  • Nombre completo: Coincide con los nombres completos de Bitbucket para Microsoft Entra ID propiedades de usuario.
  • Nombre público: Asigna nombres públicos de Bitbucket con Microsoft Entra ID propiedades de usuario.

Si se produce un error en la asignación directa, use expresiones regulares (regex) para la transformación. Por ejemplo:

  1. Seleccione Mail (Correo) como la propiedad de usuario Microsoft Entra.
  2. Seleccione Full Name (Nombre completo) como la propiedad de usuario que no es Microsoft Entra.
  3. Use una expresión regular como ([^@]+) para capturar una secuencia de uno o varios caracteres que están antes del @ símbolo.
  4. Cree una fórmula para completar la asignación, como {0}@<your-domain>.

Contenido

En la pestaña Contenido , puede comprobar las asignaciones de propiedades en los datos de ejemplo para metadatos como contenido, etiquetas, descripción y marcas de tiempo.

Sincronizar

Puede configurar rastreos incrementales y completos . Los siguientes son los valores predeterminados:

  • El rastreo incremental se ejecuta cada 15 minutos de forma predeterminada.
  • El rastreo completo se ejecuta diariamente para garantizar la indexación actualizada.

Pasos siguientes

  • Revise el estado de la conexión en el Centro de Administración de Microsoft 365.

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

  • Last updated on