Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
El conector de Microsoft 365 Copilot de solicitudes de incorporación de cambios en la nube de GitHub permite a su organización indexar las solicitudes de incorporación de cambios almacenadas en repositorios de GitHub en experiencias de Microsoft 365 Copilot y Microsoft Search. En este artículo se describen los pasos para implementar y personalizar el conector. 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 GitHub, consulte Configuración del servicio de GitHub para la ingesta de conectores.
Requisitos previos
Antes de implementar el conector de solicitudes de incorporación de cambios en la nube de GitHub, asegúrese de que el entorno de GitHub está configurado en su organización. En la tabla siguiente se resumen los pasos para configurar el entorno de GitHub e implementar el conector.
| Tarea | Role |
|---|---|
| Identificación del nombre de la organización de GitHub | Administrador de GitHub |
| Garantizar el acceso de API a la instancia de GitHub de destino | Administrador de GitHub |
| Implementación del conector | Administrador de Microsoft 365 |
| Personalización de la configuración del conector (opcional) | Administrador de Microsoft 365 |
Antes de implementar el conector, asegúrese de cumplir los siguientes requisitos previos:
- Es administrador de Microsoft 365.
- La instancia de GitHub es accesible a través de la API.
- Se crea y configura una aplicación de GitHub para la autenticación.
- La cuenta usada para la autenticación tiene acceso a los repositorios y las solicitudes de incorporación de cambios que se van a indexar.
- Los usuarios que acceden a datos indexados de GitHub tienen identidades de Microsoft Entra ID correspondientes para la asignación de permisos.
Implementación del conector
Para agregar el conector de solicitudes de incorporación de cambios en la nube de GitHub para su organización:
- En el Centro de administración de Microsoft 365, en el panel izquierdo, elija Conectores de Copilot>.
- Vaya a la pestaña Conectores y, en el panel izquierdo, elija Galería.
- En la lista de conectores disponibles, elija Solicitudes de incorporación de cambios en la nube de GitHub.
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 solicitudes de incorporación de cambios en la nube de GitHub o personalizar el valor para usar un nombre para mostrar que reconocen 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.
Elegir tipo de autenticación
El conector admite los siguientes tipos de autenticación:
OAuth (recomendado): para usar la autenticación de OAuth:
- Instale la aplicación GitHub Issues de GitHub en la organización de GitHub.
- Elija un nombre para mostrar que ayude a los usuarios a reconocer la conexión.
- Escriba el nombre de la organización.
- Elija Autorizar para iniciar sesión y conceder acceso.
Nota:
Este método de autenticación está actualmente en versión preliminar.
Aplicación de GitHub personalizada (en nombre del usuario): escriba el identificador de cliente y el secreto de cliente desde la aplicación de GitHub y autorice el acceso.
Aplicación de GitHub personalizada (instalación): use una clave privada generada a partir de la aplicación de GitHub. Escriba el identificador de cliente y el nombre de la organización y cargue la clave privada.
Para obtener información sobre cómo crear una aplicación de GitHub, consulte Uso de una aplicación de GitHub personalizada para la autenticación.
Implementación
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 Copilot de solicitudes de incorporación de cambios en la nube de GitHub comienza a indexar contenido de inmediato.
En la tabla siguiente se enumeran los valores predeterminados que se establecen.
| Categoría | Valor predeterminado |
|---|---|
| Usuarios | Asignación de identidades basada en el correo electrónico de GitHub |
| Contenido | Metadatos de solicitud de incorporación de cambios (título, descripción, etiquetas, marcas de tiempo) |
| Sincronizar | Rastreo incremental cada 15 minutos; rastreo completo diario |
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 solicitudes de incorporación de cambios en la nube de GitHub. 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
Elija si los datos indexados son visibles para:
- Solo las personas con acceso a este origen de datos (valor predeterminado)
- Todos
Si elige Solo las personas con acceso a este origen de datos, los datos indexados aparecerán en los resultados de búsqueda de los usuarios que tengan acceso a ellos. Si elige Todos, los datos indexados aparecerán en los resultados de búsqueda de todos los usuarios.
Asignación de identidades
Para garantizar la correcta aplicación de permisos, asigne identidades de usuario de GitHub a Microsoft Entra ID. Las opciones disponibles son las siguientes:
- Email: asigna el correo electrónico de GitHub a Microsoft Entra ID propiedades de usuario.
- Iniciar sesión: Asigna inicios de sesión de GitHub con Microsoft Entra ID propiedades de usuario.
- Nombre: Asigna el nombre de GitHub con Microsoft Entra ID propiedades de usuario.
Si se produce un error en la asignación directa, use expresiones regulares (regex) para transformar los datos. Por ejemplo: [a-zA-Z0-9]+
Si el administrador de la organización establece permisos de miembro predeterminados para restringir el acceso al repositorio, el conector respeta esta configuración. Los usuarios no pueden ver repositorios de la organización a menos que se agreguen explícitamente como colaboradores.
Para las empresas que usan el modelo Bring Your Own Key (BYOK) en lugar de Enterprise Managed Users (EMU), cada usuario debe habilitar el permiso para compartir el campo de identidad necesario en la configuración de su cuenta de GitHub. Este paso garantiza una asignación de identidad adecuada entre GitHub y el directorio de su organización.
Personalización de la configuración de 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.
Filtro de intervalo de tiempo
Puede configurar un filtro de intervalo de tiempo. La configuración predeterminada es de 365 días.
Administrar propiedades
Puede agregar o quitar propiedades, asignar atributos de esquema y definir etiquetas semánticas. Las propiedades siguientes se indizan de forma predeterminada.
| Propiedad | Etiqueta semántica | Description | Atributos de esquema |
|---|---|---|---|
| title | Title | Título de la solicitud de incorporación de cambios | Permite la búsqueda |
| description | Contenido | Descripción de la solicitud de incorporación de cambios | Permite la búsqueda |
| Etiquetas | Etiquetas | Etiquetas aplicadas a la solicitud de incorporación de cambios | Permite la búsqueda |
| createdDate | Creados | Fecha de creación de la solicitud de incorporación de cambios | Se puede buscar, ordenar |
Personalización de intervalos de sincronización
El intervalo de actualización determina la frecuencia con la que se sincronizan los datos. Puede personalizar los siguientes valores predeterminados:
- Rastreo incremental: cada 15 minutos
- Rastreo completo: diario
Para obtener más información, consulte Directrices para la configuración de sincronización.
Nota:
La compatibilidad con webhooks ya está disponible en versión preliminar. Asegúrese de establecer los permisos webhooks (lectura y escritura) en los niveles Repositorio y Organización. Los webhooks le permiten aprovechar las ventajas de la automatización mejorada y las actualizaciones en tiempo real para garantizar una experiencia de integración más fluida y con capacidad de respuesta.