Implementación del conector de problemas en la nube de GitHub Microsoft 365 Copilot

El conector de problemas en la nube de GitHub Microsoft 365 Copilot permite a su organización indexar los problemas de GitHub para que se puedan exponer en Microsoft 365 Copilot y experiencias de Búsqueda de Microsoft. En este artículo se describen los pasos para implementar y personalizar el conector 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 Problemas en la nube de GitHub, asegúrese de que el entorno de GitHub Cloud está configurado en su organización. En la tabla siguiente se resumen los pasos para configurar el entorno e implementar el conector.

Antes de implementar el conector de Problemas en la nube de GitHub, asegúrese de que:

• Es administrador de Microsoft 365.
• El entorno de GitHub está configurado y es accesible a través de la API.
• Se crea una aplicación de GitHub para la autenticación con los permisos necesarios.
• Los usuarios que acceden a datos indexados de GitHub tienen identidades de Microsoft Entra ID correspondientes para la asignación de permisos.
• Para los usuarios administrados por la empresa que se autentican mediante el inicio de sesión único (SSO), las cuentas inician sesión antes de la instalación. El flujo de autenticación de GitHub no admite el inicio de sesión único durante la configuración.

Implementación del conector

Para agregar el conector de Problemas en la nube de GitHub 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 Problemas en la nube de GitHub.

Establecer el nombre para mostrar

El nombre para mostrar identifica las referencias en las respuestas de Copilot y ayuda a los usuarios a reconocer el origen de contenido asociado. Puede aceptar el nombre para mostrar de GitHub Cloud Issues predeterminado o personalizarlo.

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

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 un público limitado, elija el botón de alternancia situado junto a Lanzamiento a audiencia limitada y especifique los usuarios y grupos. Para obtener más información, consulte Lanzamiento provisional para conectores copilot.

Elija Crear para implementar la conexión. El conector de Problemas en la nube de GitHub comienza a indexar contenido inmediatamente.

En la tabla siguiente se enumeran los valores predeterminados que se establecen al implementar el conector.

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, revise 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 Problemas 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

Especifique qué usuarios y grupos tienen acceso al contenido indexado de GitHub.

Asignación de identidades

Para asegurarse de que los permisos se aplican correctamente, asigne identidades de usuario de GitHub a Microsoft Entra ID. Elija una de las siguientes opciones para la asignación:

• 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]+. Para obtener más información, consulte Asignación de identidades de Microsoft Entra.

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 contenido

Puede configurar un filtro de intervalo de tiempo para el conector. La configuración predeterminada es de 365 días.

Administrar propiedades

Puede agregar o quitar propiedades disponibles del origen de datos, asignar un esquema a la propiedad (que se puede buscar, consultar, recuperar o refinar), cambiar la etiqueta semántica y agregar un alias a la propiedad . El conector indexa las siguientes propiedades de forma predeterminada.

Personalización de intervalos de sincronización

Configure los intervalos de sincronización de rastreo completo e incremental. Los siguientes son los valores predeterminados:

• Rastreo incremental: Cada 15 minutos
• Rastreo completo: Diario

Puede ajustar estos intervalos para satisfacer las necesidades de su organización. Para obtener más información, consulte Directrices para la configuración de sincronización.

Contenido relacionado

• Introducción al conector de problemas en la nube de GitHub
• Solución de problemas con el conector de problemas en la nube de GitHub
• Configuración de conectores de Copilot en el Centro de administración de Microsoft 365