Este artículo explica cómo un miembro de tu organización puede ejecutar una sesión de Devin.Devin ayuda a tu organización con distintas tareas. Para maximizar su eficacia, empieza por tareas más pequeñas y proporciona instrucciones detalladas, igual que lo harías con un ingeniero junior.
Una empresa se compone de varias organizaciones, cada una de las cuales requiere acceso a repositorios específicos.Debes instalar los repositorios para cada organización que necesite acceso. Instalar un repositorio permite que el espacio de trabajo de Devin complete tareas, ya que Devin está correctamente configurado para compilar, ejecutar lint y probar el código.Antes de usar Devin, un miembro de cada organización debe completar la siguiente configuración.
Paso de incorporación 1 - Conectar Git
Paso de incorporación 2 - Conectar Slack
Si tu empresa no usa Slack, utilizarás la aplicación web.
Paso de incorporación 3 - Seleccionar un repositorio
Puedes añadir repositorios adicionales más adelante.
Paso de incorporación 4 - Configurar el espacio de trabajo de Devin
Paso de incorporación 5 - Configurar dependencias del repositorio
Por ejemplo, podría ser algo como apt-get {your-package}
Una vez instalado, Devin puede operar en el repositorio configurado. Se pueden agregar repositorios adicionales más adelante. No hay límites en la cantidad ni en el tamaño de los repositorios.
Las sesiones de Devin están aisladas: distintas sesiones simultáneas de miembros no se afectan entre sí.
Para observar el flujo de trabajo de Devin, usa la pestaña “Follow”. El video de ejemplo de sesión a continuación muestra las capacidades de Devin.Nota: Este video se aceleró con fines de demostración.
Agregar un nuevo endpoint de la API
a new API endpoint
Copiar
Preguntar a la IA
Crea un nuevo endpoint /users/stats que devuelva un objeto JSON con el número de usuarios y la edad promedio al registrarse.Usa nuestra tabla existente de users en PostgreSQL.Puedes tomar como referencia el endpoint /orders/stats en statsController.js para ver cómo estructuramos las respuestas.Asegúrate de que el nuevo endpoint esté cubierto por el conjunto de pruebas StatsController.test.js.
Pequeñas funciones de frontend
Copiar
Preguntar a la IA
Pequeñas mejoras de frontendEn UserProfileComponent, agrega un menú desplegable que muestre una lista de roles de usuario (admin, editor, viewer).Usa los estilos de DropdownBase.Cuando se seleccione un rol, llama a la API existente para establecer el rol del usuario.Valida comprobando que la selección actualiza el rol del usuario en la DB. Consulta tu Knowledge para saber cómo probarlo correctamente.
Escribir pruebas unitarias
unit tests
Copiar
Preguntar a la IA
Agrega pruebas de Jest para los métodos de AuthService: login y logout.Asegúrate de que la cobertura de pruebas para estas dos funciones sea de al menos el 80%.Usa UserService.test.js como ejemplo.Después de la implementación, ejecuta `npm test -- --coverage` y verifica que el informe de cobertura muestre >80% para ambas funciones.Confirma también que las pruebas pasen tanto con credenciales válidas como inválidas y que logout limpie correctamente los datos de sesión.
Migrar o refactorizar código existente
or refactoring existing code
Copiar
Preguntar a la IA
Migra el archivo logger.js de JavaScript a TypeScript.Ya contamos con un tsconfig.json y una suite de pruebas LoggerTest.test.js para validación.Asegúrate de que compile sin errores y de no modificar la configuración existente.Después de la migración, verifica:1) ejecutando `tsc` para confirmar que no haya errores de tipo2) ejecutando la suite de pruebas con `npm test LoggerTest.test.js` para asegurar que todas las pruebas pasen3) comprobando que todas las llamadas existentes a los métodos del logger en todo el código sigan funcionando sin errores de tipo.
Actualizar las API o las consultas de base de datos
unit tests
Copiar
Preguntar a la IA
Estamos pasando de pg a Sequelize (consulta https://sequelize.org/api/v6/identifiers).Actualiza las consultas de UserModel para usar los métodos de Sequelize.Revisa OrderModel para ver cómo lo hacemos en este código.Después de la implementación, verifica lo siguiente:1) ejecuta `npm run test:integration UserModel.test.js` para comprobar que pasan todas las pruebas de integración2) confirma que el rendimiento de las consultas no se ha degradado comprobando el tiempo de ejecución en un conjunto de datos de prueba de 1000 usuarios3) valida que todas las operaciones CRUD siguen manteniendo la integridad de los datos ejecutando `npm run test:e2e user-flows.test.js`
Crea una PR rápida (te recomendamos usar este prompt en un Playbook)
PR rápido
Copiar
Preguntar a la IA
## Descripción generalLa tarea consiste en hacer un pull request rápido a un repositorio.Como se trata de un PR "rápido", no necesitarás ejecutar código ni probar nada; simplemente crea el PR y el usuario se encargará de las pruebas. Tu única responsabilidad es leer y escribir código.## Qué se necesita del usuario- El repositorio al que se debe crear el pull request## Procedimiento### Prepara tu espacio de trabajo1. Navega al repositorio correspondiente en tu máquina (acláralo con el usuario si no puedes averiguarlo). - Haz checkout a la rama principal y toma nota del nombre de la rama principal. - Haz checkout a una nueva rama, ya que vas a crear un pull request. El nombre de la rama debe tener el formato `devin/<your-branch-name>/X` donde X es un número aleatorio. Por ejemplo, `devin/fix-popup/3234`. Ejecuta `git remote -v && git pull && git checkout -b devin/{branch-name}/$RANDOM` y reemplaza `{branch-name}` por el nombre de la rama que quieras crear.2. Estudia la petición, el código base y planifica los cambios - Revisa los archivos y secciones de código más relevantes, identificando los fragmentos importantes. - Informa al usuario de tu plan.### Trabaja en el PR3. Realiza los cambios de código - No cambies nada que el usuario no haya solicitado específicamente.4. Crea el PR - Haz commit y push de los cambios e informa al usuario. - Consulta la sección de consejos para ver el comando exacto para crear el PR. - Crea un pull request y revísalo para asegurarte de que se ve bien. - Asegúrate de que todas las GitHub Actions se ejecutan correctamente y haz los cambios necesarios hasta que lo hagan. - Envía al usuario el enlace del PR y resume lo que has cambiado.5. Atiende cualquier comentario de la revisión; envía de nuevo el enlace del PR cada vez que hagas cambios - Si necesitas hacer actualizaciones, simplemente haz push de más commits a la misma rama; no crees una nueva.## Especificación de la tarea- El enlace del PR está incluido en tus mensajes al usuario.- El PR fue revisado después de su creación.- El PR no incluye cambios ajenos a la tarea.- El PR no cambia nada que el usuario no haya solicitado específicamente.- La descripción del PR debe incluir un resumen de los cambios, formateado como una checklist.- La descripción del PR debe mencionar que el código se escribió sin pruebas e incluir `- [ ] Test the changes` como un ítem.- La descripción del PR debe incluir el siguiente pie de página: "This PR was written by [Devin](https://devin.ai/) :angel:"- La descripción del PR debe incluir cualquier metadato que haya proporcionado el usuario (por ejemplo, etiquetas de tickets de Linear con la sintaxis adecuada).- La descripción del PR no debe estar mal formateada (usa `--body-file` en lugar de `--body` si los saltos de línea se corrompen).## Acciones prohibidas- NO intentes acceder a github.com mediante el navegador; no estarás autenticado.- NUNCA hagas force push en ramas. Prefiere hacer merge en lugar de rebase para no perder trabajo.- NO hagas push directamente a la rama principal.## Consejos y recomendaciones- Verifica dos veces el nombre de la rama principal (podría ser `main` o `master`) usando `git branch`.- Para repos con CI/CD en GitHub Actions, puedes revisar los logs de compilación usando la CLI de `gh`. Si te piden corregir un fallo de build o de lint, deberías empezar consultando los logs de builds recientes.- Revisa `git status` antes de hacer commit o añadir archivos.- Usa `git diff` para ver qué cambios has hecho antes de hacer commit.- Si estás actualizando un repositorio existente, usa la CLI de `gh` para crear pull requests.- Envía al usuario el enlace del PR cada vez que lo actualices y pídele que lo revise de nuevo para que le resulte cómodo.- Deberías estar ya autorizado para acceder a cualquier repositorio que el usuario te indique. Si no es así, pídele acceso al usuario.
Si quieres profundizar en ejemplos más detallados de lo que Devin puede hacer (y cómo lo hace), revisa nuestros tutoriales introductorios a continuación.
Puedes invitar a Devin a trabajar en muchas de las herramientas o aplicaciones que usas: basta con darle a Devin las credenciales necesarias, API keys o tokens para que pueda operar dentro de esos servicios a través de Secrets Manager o cuando se te solicite compartir la credencial de forma segura en el chat.Estas son algunas de las herramientas más comunes que Devin ha usado con nuestros primeros usuarios:
Para más detalles sobre las integraciones de Devin, consulta nuestras guías de integración para GitHub y Slack:
Para flujos de trabajo automatizados e integraciones con tus herramientas existentes, también puedes aprovechar nuestra Referencia de la API para crear sesiones de forma programática y obtener resultados estructurados.