Conectar un servicio de código fuente

Dale a tu agente acceso al contexto del repositorio, del problema 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 utilizan la página de Acceso a Código (Acceso al Código del Constructor > ), no el asistente de conectores gestionados. 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 debería 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 Tráe-te-tu-propio GitHub App (OAuth y PAT también soportados para github.com) Lee repositorios, números y pull requests entre proyectos y organizaciones; Crear problemas o pull requests con aprobación
Azure DevOps Azure DevOps Identidad gestionada (también soportados por OAuth y PAT) 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, números y solicitudes de fusión; Crea problemas 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: Acceso a Código Abierto

  1. Vaya a sre.azure.com y seleccione el agente.
  2. En la barra lateral izquierda, expande Constructor y luego selecciona Acceso al código.
  3. Selecciona la pestaña de tu servicio (GitHub, Azure DevOps o GitLab).
  4. Seleccione Agregar repositorio.

Paso 2: Autenticar

El cuadro de Añadir repositorios se abre con un asistente de tres pasos: Elige una plataforma → Autenticar → Añadir repositorios. Seleccione Siguiente después de cada paso. El paso final tiene un botón de guardar .

Utiliza Bring your own GitHub App para GitHub Enterprise Cloud o para establecer el acceso por organización o instalación.

  1. En Métodos de Inicio de Sesión, elige Traer tu propia aplicación de GitHub.
  2. Completa los campos de configuración de la app que muestra el asistente.
  3. Seleccione Siguiente.

GitHub Enterprise Cloud (.ghe.com) requiere una conexión de GitHub App. Por github.com ejemplo, también se soportan Tu cuenta (OAuth, si está configurada para tu entorno) o un token de acceso personal, aunque la opción GitHub App es preferida para escenarios de producción para permitir permisos más específicos y visibilidad de auditoría.

Tras conectarse, el agente puede buscar en repositorios, incidencias y pull requests entre proyectos y organizaciones a las que tiene acceso tu app o cuenta.

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

El paso Añadir repositorios muestra una tabla donde especificas qué repositorios indexa el agente. Cada fila es un repositorio.

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

  2. En la columna URL del repositorio , selecciona un repositorio en el desplegable o escribe directamente una URL. Para GitHub y GitLab, el desplegable lista repositorios a los que tus credenciales pueden acceder. Para Azure DevOps, lista los repositorios en el proyecto seleccionado.

  3. En la columna de Nombre de visualización , introduce un nombre corto que el agente utiliza para referirse al repositorio.

  4. Opcionalmente, rellena la columna de Descripción para dar al agente más contexto sobre lo que contiene el repositorio.

  5. Si tu servicio es Azure DevOps y el repositorio es muy grande, activa la casilla de verificación Remote. El agente utiliza búsqueda impulsada por IA en la copia remota en lugar de clonarla localmente. Los repositorios se clonan con un límite de disco de 100 GB; habilitar Remote evita esa restricción.

  6. Para añadir otro repositorio, selecciona Añadir y rellena la siguiente fila.

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

Paso 4: Validar con un escenario

  1. Abre un chat con tu agente.

  2. Haz una pregunta leída, 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 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.
Crear falla con un error de permiso El token o cuenta carece de alcance de escritura Concede el alcance requerido al token o cuenta, o utiliza credenciales que tengan acceso de escritura.
GitHub Enterprise Cloud rechaza la conexión GitHub Enterprise Cloud requiere una conexión de aplicación GitHub En la página de Acceso al Código, desconecta la conexión de GitHub, selecciona Añadir repositorio, elige GitHub, introduce tu .ghe.com host y selecciona Traer tu propia aplicación de GitHub como método de autenticación.

Contenido relacionado

  • Last updated on