Implementación del conector de GitHub Cloud Knowledge Microsoft 365 Copilot

El conector de Conocimiento en la nube de GitHub permite a las organizaciones indexar los archivos markdown y de texto de 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 GitHub Cloud Knowledge, 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 GitHub Cloud Knowledge, asegúrese de que:

• Es administrador de Microsoft 365 para su organización.
• 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.
• 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 a través del inicio de sesión único (SSO), la cuenta inicia sesión antes de la instalación. El flujo de autenticación de GitHub no admite el inicio de sesión único.

Implementación del conector

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

Establecer el nombre para mostrar

El nombre para mostrar identifica las referencias en las respuestas de Copilot y significa contenido de confianza. Puede aceptar el nombre para mostrar predeterminado de GitHub Cloud Knowledge o elegir un nombre que reconozcan los usuarios de su organización.

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

Establecimiento de la dirección URL de la instancia

Escriba la dirección URL de la organización de GitHub que indexará el conector. Por ejemplo:

https://github.com/<organization-name>

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 de Microsoft 365 Copilot.

Elija Crear para implementar la conexión. El conector de GitHub Cloud Knowledge comienza a indexar contenido de inmediato.

En la tabla siguiente se enumeran los valores predeterminados que se establecen.

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 de GitHub Cloud Knowledge. 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 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.

Elija los repositorios y tipos de archivo (archivos Markdown, documentos de texto) que desea que se puedan buscar.

Administrar propiedades

Puede agregar o quitar propiedades, asignar atributos de esquema y definir etiquetas semánticas. Las propiedades siguientes se indizan de forma predeterminada:

Personalización de intervalos de sincronización

El intervalo de actualización determina la frecuencia con la que se sincronizan los datos. Valores predeterminados:

• Rastreo incremental: cada 15 minutos
• Rastreo completo: diario

Puede cambiar estos valores según sea necesario. Para obtener más información, consulte Directrices para la configuración de sincronización.

Contenido relacionado

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