Conectar un servicio de código fuente

Dale a tu agente acceso al contexto del repositorio, del issue y de las pull requests para las investigaciones. Puede leer cambios recientes, encontrar problemas relacionados y abrir un issue o pull request en el repositorio o proyecto adecuado cuando la credencial que proporciones lo permita.

Este tutorial cubre GitHub, Azure DevOps y GitLab. Las conexiones de código fuente usan la página Code Access (Build + setup > Context > Code access), no el asistente del conector administrado. Este artículo se centra en los detalles del código fuente: cómo se autentica cada servicio y cómo validar la conexión.

Prerequisites

  • Un agente SRE en funcionamiento y acceso a sre.azure.com.
  • Permiso para configurar el agente.
  • Una cuenta en el servicio con acceso a los repositorios o proyectos que el agente deba leer.

Para servicios de notificación, consulta Conectar un servicio de notificación.

Conectores de código fuente

Conector Service Authentication Uso típico
GitHub GitHub y GitHub Enterprise Cloud Usa tu propia GitHub App (OAuth y PAT también compatibles con github.com) Leer repositorios, incidencias y solicitudes de incorporación de cambios entre proyectos y organizaciones; crear incidencias o solicitudes de incorporación de cambios con aprobación
Azure DevOps Azure DevOps Identidad administrada (OAuth y PAT también admitidos) Leer repositorios y pull requests entre proyectos; Crea pull requests o elementos de trabajo con aprobación
GitLab GitLab Un token de acceso personal (PAT) Leer repositorios, incidencias y solicitudes de combinación; crear incidencias y comentarios con aprobación

GitHub y Azure DevOps presentan las opciones de autenticación como botones de opción. GitLab utiliza un token de acceso personal.

Paso 1: Abrir acceso al código

  1. Vaya a sre.azure.com y seleccione el agente.
  2. En la barra lateral izquierda, seleccione Build + setup>Context>Code access.
  3. Selecciona la pestaña de tu servicio (GitHub, Azure DevOps o GitLab).
  4. Seleccione Agregar repositorio.

Paso 2: autenticarse

El diálogo Añadir repositorios tiene dos pasos: Conexión y Añadir repositorios. En Connection, elige la plataforma e introduce la URL del repositorio u organización antes de configurar la autenticación. Selecciona Siguiente tras conectar, y Guardar en el paso final.

Selecciona Usar tu aplicación de GitHub para GitHub Enterprise Cloud o para definir el acceso por organización o instalación.

  1. Introduce una URL completa del Repositorio, como https://github.com/owner/repo.
  2. Si existe una credencial coincidente, selecciona Conexión existente para reutilizarla o Nueva conexión para configurar otra.
  3. En Método de conexión, elige Usar tu aplicación de GitHub.
  4. Completa los campos de configuración de la app que muestra el asistente para la configuración.
  5. Selecciona Conectar y confirma que la conexión ha funcionado.
  6. Seleccione Siguiente.

GitHub Enterprise Cloud (.ghe.com) requiere una conexión de GitHub App. Para github.com, también se soportan OAuth y el token de acceso personal (PAT). La autenticación de GitHub App requiere un URI de clave de RSA Key Vault (/keys/), no un URI de secreto. Vea Configurar GitHub BYO App.

Después de conectarse, el agente puede buscar repositorios, incidencias y solicitudes de incorporación de cambios entre los proyectos y las organizaciones a los que su aplicación o cuenta tenga acceso.

El servicio detecta la identidad que autorizó la conexión. Los problemas, comentarios y actividades de pull requests que crea el agente aparecen bajo esa cuenta.

Paso 3: Añadir repositorios

Revisa los repositorios para añadir. Para GitHub, amplía cada repositorio para editar su nombre de visualización y descripción. Para Azure DevOps y GitLab, edita estos campos directamente en la tabla.

  1. Si tu servicio es Azure DevOps, primero selecciona un proyecto en el menú desplegable de Azure DevOps Project. La columna URL del Repositorio se llena con los repositorios de ese proyecto.

  2. Revisa la URL del repositorio inicial. Para ver más elementos, selecciona un repositorio en el desplegable o escribe directamente una URL. Para Azure DevOps, selecciona primero el proyecto.

  3. Introduce un nombre de visualización corto que el agente usa para referirse al repositorio. Para GitHub, amplía la entrada para encontrar este campo.

  4. Opcionalmente, introduce una Descripción para dar al agente más contexto sobre el repositorio. Para GitHub, primero selecciona Añadir descripción.

  5. Si tu entorno Azure DevOps ofrece una opción Remote, puedes usarla para búsquedas impulsadas por IA sin clonar todo el repositorio. Esta opción no está disponible en todos los entornos.

  6. Para añadir otro repositorio, seleccione Add repository para GitHub o Add en la cuadrícula de Azure DevOps o GitLab. Repositorios adicionales de GitHub en esta conexión utilizan el mismo host y credencial.

  7. Cuando la tabla esté completa, selecciona Guardar.

Paso 4: Validar con un escenario

  1. Abre un chat con tu agente.

  2. Haga una pregunta de lectura, como:

    List the open issues in the payments repository from the last week.
    
  3. Consulta la ficha de herramientas para ver cómo el agente busca en el servicio y devuelve resultados basados en tus datos.

Cuando aparecen resultados que hacen referencia a tu repositorio, la conexión funciona de principio a fin.

Troubleshooting

Problema Causa Corregir
La búsqueda no devuelve ningún resultado La cuenta no tiene acceso al proyecto o repositorio Confirma que la cuenta de conexión puede ver el proyecto o repositorio, y luego vuelve a intentarlo.
La creación falla con un error de permisos Al token o a la cuenta le falta el ámbito de escritura Otorga el ámbito requerido al token o la cuenta, o utiliza credenciales que tengan permiso de escritura.
GitHub Enterprise Cloud rechaza la conexión GitHub Enterprise Cloud requiere una conexión de GitHub App En la página de Acceso al Código, desvincula la conexión con GitHub, selecciona Añadir repositorio, elige GitHub, introduce tu .ghe.com host y selecciona Bring your own GitHub App como método de autenticación.