Integración de Devin con Jira

Hay dos maneras de conectar Jira Cloud con Devin. Ambas permiten asignar elementos de trabajo de Jira a Devin y recibir pull requests a cambio, pero se instalan y se activan de forma distinta.

​

¿Qué opción debo usar?

• Las funciones de agentes de Jira Cloud están habilitadas en tu workspace → usa el agente de Rovo. Devin aparece en el selector de personas asignadas y en las @menciones como cualquier otro agente, e informa de su trabajo en la card del agente del elemento de trabajo. Además, al vincular el sitio, sus eventos de elementos de trabajo de Jira quedan disponibles como triggers para las automatizaciones de Devin.
• Rovo está desactivado en tu workspace de Jira → usa un usuario de servicio. Devin actúa a través de una cuenta de servicio de Jira que tú creas e informa de su trabajo mediante comentarios y enlaces remotos.

Ambas opciones ejecutan sesiones de Devin normales, funcionan con las automatizaciones de Devin, tienen los mismos requisitos y se facturan de la misma manera.

​

Automatizaciones de Devin

Las automatizaciones de Devin son la forma de iniciar Devin automáticamente desde Jira, y funcionan con ambas opciones. Una vez conectado un sitio de Jira (ya sea vinculado mediante la aplicación Devin for Jira o conectado con una cuenta de Admin), sus eventos de elementos de trabajo quedan disponibles como triggers de Jira. Elige uno al crear la automatización:

• Issue created: se crea un elemento de trabajo.
• Issue updated: cambia cualquier campo de un elemento de trabajo; los campos modificados están disponibles en las condiciones de la automatización.
• Label added: se agrega una etiqueta a un elemento de trabajo; se genera un evento por cada etiqueta.
• Status changed: cambia el estado de un elemento de trabajo, o se crea un elemento de trabajo con un estado.
• Assigned: se crea un elemento de trabajo con una persona asignada, o cambia la persona asignada.
• Comment created: se crea un comentario en un elemento de trabajo. Los comentarios que publica el propio Devin no lo activan.

Las condiciones pueden filtrar por proyecto, etiqueta, estado, persona asignada, épica (el elemento padre del elemento de trabajo) y resumen. Cuando finaliza la sesión de la automatización, su mensaje final se publica como comentario en el elemento de trabajo: desde la aplicación de Devin si el sitio está vinculado mediante la aplicación, o a través de la conexión de usuario de servicio si el sitio está conectado con una cuenta de Admin. Si un sitio tiene ambas conexiones, cada evento se entrega una sola vez, a través de la conexión de usuario de servicio.

​

Opción 1: agente de Rovo Devin en Jira

Devin for Jira es una aplicación de Atlassian Forge basada en el conector de agentes de Rovo. Una vez instalada y vinculada, Devin pasa a ser un agente en tu sitio de Jira Cloud: asigna un elemento de trabajo a Devin o menciona a @Devin en un comentario, y Devin planificará el trabajo, escribirá el código, abrirá un pull request e informará de los resultados en el propio elemento de trabajo.

​

Configuración

La configuración consta de dos partes: primero se instala la app en tu sitio de Jira y, después, un admin de Devin vincula ese sitio a una cuenta de Devin.

​

1. Instala la app en tu sitio

1. Un admin de Jira abre Devin en Atlassian Marketplace y la instala en tu sitio de Jira Cloud (your-site.atlassian.net).
2. El admin de Jira revisa los permisos que solicita la app y los acepta. La app lee y escribe elementos de trabajo y comentarios, lee los usuarios de Jira y sus direcciones de correo electrónico (para asociarlos con usuarios de Devin) y comprueba los permisos de los proyectos.

Una vez instalada la app, Devin aparece como agente en el sitio, pero no puede aceptar trabajo hasta que el sitio esté vinculado a una cuenta de Devin.

​

2. Vincula el sitio de Jira a tu cuenta de Devin

1. En Jira, ve a Settings > Apps y abre la página Devin que agrega la app. Verás el mensaje “This site is not connected to a Devin account yet.”
2. Haz clic en Connect to Devin. Se abrirá una página de Devin en una nueva pestaña. Inicia sesión en Devin si se te solicita.
3. Comprueba que el sitio de Jira que aparece sea el tuyo, elige la cuenta de Devin a la que quieres vincularlo y haz clic en Link site.
4. De vuelta en Jira, haz clic en Check again. La página mostrará ahora la cuenta de Devin a la que está conectado el sitio.

El sitio vinculado aparece en Devin en Settings > Connections > Jira como Devin app for Jira · installed from Jira, con un distintivo Linked. Para desconectarlo, abre allí el menú Actions del sitio, elige Unlink site… y confirma con Unlink site: Devin dejará de aceptar de inmediato nuevas tareas de ese sitio de Jira, aunque las sesiones que ya se estén ejecutando en Devin no se detendrán. Para volver a vincularlo, un admin de Jira debe hacer clic de nuevo en Connect to Devin en Jira.

​

Triggers

Para iniciar Devin automáticamente a partir de eventos de elementos de trabajo, usa las automatizaciones de Devin. Además, hay dos formas de iniciar manualmente una sesión de Devin desde un elemento de trabajo con el agente de Rovo.

​

Asignar el elemento de trabajo a Devin

Selecciona Devin en el campo de persona asignada del elemento de trabajo. Devin inicia una sesión y trabaja en el elemento de trabajo, usando su resumen y su descripción como tarea.

• Si la misma persona lo asigna varias veces en un plazo de cinco minutos, las asignaciones se consideran duplicadas mientras la tarea siga activa. Si se vuelve a asignar el elemento de trabajo más tarde, o si lo asigna otra persona, puede iniciarse otra sesión aunque la primera siga en ejecución.
• Si vuelves a asignárselo a Devin una vez que haya terminado, se inicia una nueva sesión.

​

Menciona a Devin con @ en un comentario

Menciona a @Devin en un comentario con instrucciones específicas. Devin inicia una sesión en la que toma tu comentario como la tarea y la descripción del elemento de trabajo como contexto. Cuando Devin termina o se detiene para hacerte una pregunta, publica su último mensaje como comentario en el elemento de trabajo, dirigido a ti. Cada comentario que menciona a Devin inicia una sesión independiente. Para continuar una sesión que ya está en ejecución, responde en el panel del agente.

​

El panel del agente

Mientras Devin trabaja, su progreso aparece en el panel del agente de Jira dentro del elemento de trabajo:

• Estado en tiempo real: El panel del agente muestra el progreso de Devin en tiempo real.
• Enlace a la sesión: El primer mensaje de Devin es un enlace a la sesión de Devin en la web app, para que puedas seguir su avance o tomar el control desde allí.
• Mensajes de Devin: Las respuestas de Devin se conservan en la card con formato y enlaces en los que se puede hacer clic.
• Preguntas: Si Devin necesita tu intervención, la card muestra su pregunta. Responde a través del chat de la tarea en el panel del agente de Jira; tu respuesta llega a la misma sesión de Devin.
• Cancelar: Al cancelar la tarea desde Jira, Devin se detiene y la sesión pasa a dormir.

Solo el usuario de Jira que inició una tarea de Devin puede enviarle mensajes o cancelarla desde Jira. Si Devin no puede aceptar un elemento de trabajo, la card indica el motivo; por ejemplo, que el sitio de Jira aún no esté vinculado a una cuenta de Devin, que no se haya podido asociar tu cuenta de Atlassian con un usuario de Devin o que la organización o tu usuario no puedan consumir más Agent Compute Units (ACU) en este momento. Soluciona la causa y vuelve a asignar el elemento de trabajo a Devin.

​

Enlaces a pull requests

Las respuestas de Devin en el panel del agente de Jira incluyen enlaces a pull requests, y cualquier pull request que Devin haya abierto sin mencionarlo aparece en Pull requests al final de la respuesta. En las sesiones iniciadas con una @mención, el mensaje final de Devin también se publica como comentario en el elemento de trabajo; ese comentario solo incluye el enlace al pull request si Devin lo añadió.

​

Opción 2: usuario de servicio en Jira

Con esta opción, Devin se conecta a tu sitio de Jira mediante OAuth y actúa a través de una cuenta de servicio de Jira. No se instala nada en Jira: un Admin de Jira autoriza a Devin desde la configuración de Devin y tú creas en Atlassian una cuenta de servicio que se convierte en la identidad de Devin en Jira, es decir, el usuario al que asignas elementos de trabajo y el autor de los comentarios de Devin. Usa esta opción cuando Rovo esté desactivado en tu workspace de Jira.

​

Configuración

​

1. Conectar con una cuenta de Admin

1. En Devin, ve a Settings > Connections > Jira, haz clic en Connect account y elige Connect with an Admin account.
2. Inicia sesión en Atlassian como Admin de Jira y concede acceso. Devin registra sus webhooks en el sitio a través de esta cuenta.

Hasta que agregues una cuenta de servicio, los comentarios de Devin se publicarán con la cuenta de Admin que conectó Jira y no podrás asignar elementos de trabajo a Devin.

​

2. Agregar una cuenta de servicio

1. Configura una cuenta de servicio de Atlassian con una credencial OAuth 2.0 y los siguientes ámbitos:
   • read:me
   • read:jira-user
   • read:jira-work
   • write:jira-work
2. Concede a la cuenta de servicio acceso a la aplicación Jira y permisos para explorar los proyectos correspondientes, agregar comentarios, editar y eliminar sus propios comentarios y vincular problemas. Al guardar las credenciales, Devin las valida e indica qué permisos faltan.
3. En Settings > Connections > Jira, abre el menú de la conexión, elige Add service-account credentials e introduce el client ID y el client secret.

A partir de ese momento, los comentarios de Devin aparecerán a nombre de la cuenta de servicio, y al asignarle un elemento de trabajo se iniciará una sesión. Si reemplazas o eliminas las credenciales, tus webhooks se conservan. Normalmente, Devin publica a través de la cuenta de servicio configurada. Si no se puede obtener su token de acceso, Devin puede recurrir al token OAuth del admin que conectó Jira, por lo que los comentarios podrían aparecer a nombre de ese admin.

​

3. Crea una automatización

Para que Devin se inicie automáticamente a partir de eventos de elementos de trabajo, crea una automatización de Devin con un trigger de Jira. Consulta Automatizaciones de Devin.

​

Triggers

Para iniciar Devin automáticamente cuando se crean o modifican elementos de trabajo, usa las automatizaciones de Devin. También puedes iniciar Devin manualmente en un elemento de trabajo:

• Asigna el elemento de trabajo a la cuenta de servicio. Devin inicia una sesión en el elemento de trabajo. Requiere una cuenta de servicio.
• Agrega la etiqueta devin. Cuando agregas la etiqueta a un elemento de trabajo existente, la coincidencia no distingue entre mayúsculas y minúsculas y se hace por palabras completas: Devin, devin-workshop y devin-task activan el trigger, pero devinworkshop y devin_workshop no. Si el elemento de trabajo se crea con etiquetas ya asignadas, el trigger de etiqueta solo se activa con una etiqueta exactamente igual a devin (sin distinguir mayúsculas y minúsculas); devin-workshop no cuenta.
• @menciona la cuenta de servicio en un comentario. Devin inicia una sesión en el elemento de trabajo y agrega el texto de tu comentario a la tarea. Si Devin ya tiene una sesión activa para ese elemento de trabajo, tu comentario se reenvía a esa sesión en lugar de iniciar una nueva.

Mientras Devin tenga una sesión para un elemento de trabajo, se ignoran las nuevas asignaciones y etiquetas en ese elemento, y las @menciones se envían a esa sesión. Este vínculo dura 30 días o hasta que una @mención detecte que la sesión ha finalizado o ha dado error.

​

Con qué usuario se ejecuta la sesión

Devin asocia al usuario de Jira que lo activó con un miembro de la cuenta de Devin conectada:

1. Primero, mediante una cuenta de Atlassian vinculada. Los miembros pueden vincular la suya en Settings > Connections > Atlassian, lo que permite a Devin leer Jira en nombre de esa persona.
2. Si no, por dirección de correo electrónico: si el correo de un usuario de Jira coincide exactamente con un único miembro de la cuenta, se asocian, y la asociación queda guardada.

La sesión se ejecuta como el usuario de Devin asociado: aparece en su lista de sesiones y está sujeta a sus permisos. Si ningún miembro coincide, o si el miembro asociado no tiene permiso para usar sesiones de Devin en la organización, la sesión se ejecuta con el usuario bot compartido de Devin para Jira. Si Devin no puede elegir una organización para el elemento de trabajo, lo indica en un comentario.

​

Comentarios y enlaces a pull requests

Cuando se inicia una sesión, Devin publica el comentario “Devin is working on your request” y agrega un enlace a la sesión. Cuando Devin crea un pull request, su URL se agrega como enlace remoto en el elemento de trabajo y se publica como comentario, junto con el enlace a la sesión de Devin.

​

Requisitos

Para ambas opciones:

• Jira Cloud. Devin for Jira es una app de Forge y la conexión OAuth usa Atlassian Cloud OAuth, por lo que ambas requieren un sitio de Jira Cloud. Para Jira autohospedado, consulta conectar un sistema de tickets personalizado a través de la API.
• Un admin de Jira que instale la app o autorice la conexión OAuth, y un admin de Devin (alguien que pueda gestionar las integraciones de la cuenta de Devin) que vincule el sitio o configure la conexión.
• Un sitio de Jira por cuenta de Devin. Un sitio de Jira solo puede vincularse a una cuenta de Devin, y una cuenta de Devin solo puede estar vinculada a un sitio de Jira a la vez. Desvincula el sitio actual antes de vincular otro.
• Repositorios conectados, para que Devin pueda subir ramas y abrir pull requests. Devin solo puede abrir pull requests en los repositorios a los que tiene acceso; primero conecta tu proveedor de código fuente, por ejemplo, mediante la integración con GitHub.

Para el agente de Rovo:

• La app Devin for Jira instalada desde Atlassian Marketplace, con las funciones de agentes de Jira Cloud habilitadas en el workspace. Consulta la Opción 1.
• Un plan Devin Core, Team o Enterprise, con permiso para gestionar integraciones, y con permiso y uso disponible para iniciar sesiones.
• Cada persona que active a Devin necesita un usuario de Devin. Devin asocia el usuario de Jira con un miembro de la cuenta de Devin vinculada a través de su cuenta de Atlassian vinculada o de su dirección de correo electrónico. Si no hay coincidencia, esa persona puede vincular su cuenta en Settings > Connections > Atlassian. Si aun así no se asocia, un admin debe comprobar que la persona pertenece a la cuenta de Devin vinculada y que su correo electrónico verificado coincide. Los elementos de trabajo de usuarios de Jira que no se puedan asociar se rechazan.
• Permiso para iniciar sesiones. El usuario de Devin asociado debe tener permiso para usar sesiones de Devin en su organización. Si la persona pertenece a más de una organización, Devin usa primero su organización de trabajo predeterminada, que puede elegirse en Settings > Preferences. Si Devin no puede seleccionar una organización, le pide a la persona que establezca una predeterminada.

Para el usuario de servicio:

• Una cuenta de servicio de Jira con los ámbitos y el acceso de aplicación indicados en Agregar una cuenta de servicio, para poder asignar elementos de trabajo a Devin y que los comentarios de Devin se publiquen como el bot.
• Una cuenta de admin de Jira para autorizar la conexión. Si se reconecta más adelante, se actualiza la autorización sin perder las credenciales de la cuenta de servicio ni los webhooks.

​

Facturación

Las sesiones iniciadas desde Jira son sesiones de Devin normales. Consumen ACUs de la organización de Devin en la que se ejecutan, al mismo ritmo que las sesiones iniciadas desde la web app o cualquier otra integración, y se contabilizan en los límites de uso de esa organización. Si la organización no puede iniciar nuevas sesiones porque ha alcanzado su límite de uso, Devin rechaza el elemento de trabajo en Jira: en su card, en el caso del agente de Rovo, o en un comentario, en el caso del usuario de servicio. La instalación de la app es gratuita. El uso de Devin se factura según tu plan de Devin, y Devin procesa el contenido de Jira fuera de Atlassian.