Saltar al contenido principal

​
Configuración de la integración

La integración de Devin con GitHub permite que Devin acceda a tus repositorios y cree pull requests. Esto le permite a Devin ser un verdadero colaborador en tu equipo de ingeniería.

​
Crear una cuenta de servicio para Devin

  1. En tu instancia de GitHub Enterprise, crea una nueva cuenta de GitHub para que la utilice Devin. Esto es importante para garantizar que se pueda hacer un seguimiento y una gestión adecuados de todo el acceso y uso que haga Devin.
  2. Agrega la cuenta de servicio recién creada a todas las organizaciones de GitHub pertinentes como Member (Miembro). Verifica que la cuenta tenga acceso a todos los repositorios a los que se espera que Devin acceda.

​
Generar un token de acceso personal para Devin

  1. Con la sesión iniciada en la cuenta de servicio, haz clic en la foto de perfil en la esquina superior derecha y luego haz clic en Settings.
  2. En la barra lateral izquierda, haz clic en Developer settings.
  3. En la barra lateral izquierda, bajo Personal access tokens, haz clic en Fine-grained tokens.
  4. Haz clic en Generate new token.
  5. Añade el Token name y la Expiration.
    Nota: Cuando el token caduque, Devin perderá inmediatamente todo acceso a GitHub y será necesario crear un token nuevo.
  6. En Resource owner, selecciona la organización correcta.
Si no ves la organización correcta en “Resource owner”, asegúrate de que tanto el Enterprise como la organización hayan habilitado el uso de tokens de acceso personal de granularidad fina (fine-grained personal access tokens).

​
Habilitar en la configuración de Enterprise

Solo los administradores de Enterprise podrán actualizar estas configuraciones. Asegúrate de que los tokens de acceso personal también estén habilitados en la configuración de la organización específica.
  1. En la esquina superior derecha de GitHub Enterprise Server, haz clic en tu foto de perfil y luego haz clic en Enterprise settings.
  2. En la parte superior de la página, haz clic en Policies.
  3. En Policies, haz clic en Personal access tokens.
  4. Selecciona la pestaña Fine-grained tokens.
  5. En Fine-grained personal access tokens, habilita el acceso.
  6. Haz clic en Save.

​
Habilitar en la configuración de la organización

Solo los administradores de la organización podrán actualizar estas configuraciones. Asegúrate de que los tokens de acceso personal también estén habilitados en la configuración de Enterprise.
  1. En la esquina superior derecha de GitHub, haz clic en tu foto de perfil y luego haz clic en Organizations.
  2. Junto a la organización, haz clic en Settings.
  3. En la barra lateral izquierda, bajo Personal access tokens, haz clic en Settings.
  4. Selecciona la pestaña Fine-grained tokens.
  5. En Fine-grained personal access tokens, habilita el acceso para tu organización.
  6. Haz clic en Save.
  1. En Repository access, selecciona con qué repositorios quieres que trabaje Devin. Los tokens siempre incluyen acceso de solo lectura a todos los repositorios públicos en GitHub.
  2. Asegúrate de que el token tenga los siguientes permisos, que son necesarios para que Devin funcione correctamente:
PermisoNivel de accesoDescripción
ContentsRead and writePermitir que Devin contribuya a la base de código
IssuesRead and writePermitir que Devin abra nuevos issues
MetadataRead onlyPermitir que Devin vea metadatos cruciales sobre un repositorio, como quién es el propietario
Pull requestsRead and writePermitir que Devin cree nuevas PR
Los permisos adicionales ayudarán a que Devin colabore mejor con tu equipo, según el tipo de trabajo que le estés pidiendo que haga.
  1. Haz clic en Generate Token y guarda el token que se muestre.
    Nota: Es posible que se necesite aprobación de un administrador, según tu configuración de GitHub.
  2. Para validar que el token tiene todo el acceso y los permisos necesarios, crea y haz push de una rama de prueba desde tu máquina local a un repositorio de la organización.
  3. Una vez que el token se haya generado y probado, ponte en contacto con tu punto de contacto en Cognition para terminar el proceso de configuración. Si actualmente no estás trabajando directamente con nuestro equipo, escribe a [email protected].

​
Validando los permisos del PAT localmente

Antes de compartir el token con Cognition, comprueba que tiene los permisos correctos realizando un push de una rama de prueba: 
# Autenticar con gh CLI usando tu token
export GH_TOKEN=your_personal_access_token
export GH_HOST=your-github-enterprise-server.com

# Clonar el repositorio
gh repo clone your-organization/your-repository
cd your-repository

# Crear una rama de prueba
git checkout -b test-devin-token-$(date +%s)

# Realizar un pequeño cambio
echo "# Test" >> TEST.md
git add TEST.md
git commit -m "Test: Validate Devin token permissions"

# Subir la rama (prueba el permiso de escritura de contenidos)
git push origin HEAD

# Crear una solicitud de extracción (prueba el permiso de escritura de solicitudes de extracción)
gh pr create --title "Test: Validate Devin token permissions" \
  --body "This is a test PR to validate token permissions." \
  --base main

# Limpiar: cerrar la solicitud de extracción de prueba y eliminar la rama de prueba
gh pr close pr-number --delete-branch
Resultados esperados: El push y la creación del PR deberían realizarse correctamente, sin errores de autenticación. Si el push falla, verifica que el token tenga el permiso “Contents: Read and write”. Si la creación del PR falla, verifica que el token tenga el permiso “Pull requests: Read and write”.

​
Uso de Devin con la integración de GitHub

Ahora que GitHub está integrado, puedes configurar qué suborganizaciones de Devin tienen acceso a cada repositorio (consulta Permisos de repositorio). Una vez que la integración se haya configurado, puedes ir a la aplicación web de Devin y @mencionar cualquier repositorio en tu prompt. Si estás utilizando un repositorio por primera vez, te recomendamos seguir el proceso de configuración del entorno de desarrollo en el flujo de incorporación para garantizar que Devin tenga la información más precisa y actualizada sobre cómo trabajar con tu base de código.
Devin responderá automáticamente a cualquier comentario en un PR siempre que la sesión no se haya archivado.

​
Consideraciones de seguridad

Información adicional sobre los permisos de Devin en GitHub:
  • Recomendamos habilitar protecciones de ramas en master para asegurarte de que se ejecuten las comprobaciones antes de que Devin pueda fusionar cualquier cambio.
  • Si Devin está conectado a la cuenta de GitHub de tu organización, tendrá los mismos permisos que cualquier usuario con acceso tanto a la organización de GitHub como a la de Devin.
  • Devin no reflejará los permisos del usuario que esté ejecutando una sesión con Devin; conservará los permisos concedidos a nivel de organización.
  • Devin no puede crear nuevos repositorios en tu cuenta de GitHub.