Saltar al contenido principal

​
Configurar la integración

  1. En tu cuenta de Devin en app.devin.ai, ve a Settings > Integrations > Jira y haz clic en “Connect”.
  2. Se te redirigirá a Jira para revisar los permisos y conceder acceso a Devin.
  3. Una vez conectada, configura tus etiquetas de playbook y, opcionalmente, configura las activaciones de automatización en la página de Settings.
Después de conectarla, te recomendamos conectar una cuenta de servicio para que los comentarios de Devin aparezcan como enviados por el bot y no desde tu cuenta personal. Consulta Conectar una cuenta de servicio más abajo.

​
Cómo activar Devin desde Jira

Hay cuatro maneras de iniciar una sesión de Devin desde un ticket de Jira:

​
Asigna el ticket a Devin

Asigna el ticket directamente a la cuenta de servicio de Devin en Jira. Devin usará el playbook predeterminado configurado en la configuración de tu integración con Jira para empezar a trabajar en el ticket.

​
Agrega una etiqueta de playbook

Agrega una etiqueta de playbook (p. ej., !plan, !implement, !triage) al ticket. Devin iniciará una sesión con el playbook específico que corresponda a esa etiqueta. Estas etiquetas corresponden a las etiquetas de playbook configuradas en la configuración de tu integración. Debes crear estas etiquetas manualmente en tu proyecto de Jira; copia el nombre de la etiqueta desde la configuración de la integración.

​
Agrega la etiqueta “devin”

Agrega la etiqueta devin a cualquier issue de Jira (es posible que primero tengas que crear esta etiqueta en tu proyecto de Jira). Devin usará el playbook predeterminado para empezar a trabajar en el ticket.
La integración usa coincidencia por límites de palabra (sin distinguir entre mayúsculas y minúsculas), por lo que cualquier etiqueta que contenga devin como palabra independiente la activará; por ejemplo, devin, Devin, devin-workshop o devin-task. Las etiquetas en las que “devin” forme parte de una palabra más larga, como devinworkshop o devin_workshop, no la activarán.

​
Menciona a Devin en un comentario

Menciona a @Devin en un comentario del ticket con instrucciones específicas. Devin iniciará una sesión y tomará tu comentario como instrucción para la tarea, sin aplicar un playbook. Si ya existe una sesión para el ticket, tu mensaje se reenviará a esa sesión.

​
Configuración de la integración

​
Modo de sesión

El interruptor del modo de sesión controla cómo Devin responde a las activaciones de Jira:
  • Creación directa de sesiones (habilitada de forma predeterminada): Devin crea una sesión completa y trabaja en el ticket, publicando actualizaciones en Jira.
  • Solo definición del alcance (deshabilitada): Devin solo analiza el ticket y publica un comentario de definición del alcance con un resumen, un plan de implementación y un nivel de confianza estimado. Después, puedes hacer clic en el enlace proporcionado para iniciar una sesión manualmente.

​
Etiquetas de playbooks

Las etiquetas de playbooks te permiten controlar qué playbooks de Devin están disponibles como etiquetas en Jira. Cuando agregas un playbook, su macro (p. ej., !plan) se convierte en una etiqueta que puedes asignar a incidencias de Jira para activar Devin con ese playbook. Las etiquetas deben crearse manualmente en tu proyecto de Jira; copia el nombre de la etiqueta desde la configuración de la integración.
  • Playbook predeterminado: Un playbook se marca como predeterminado. Cuando una incidencia se activa sin una etiqueta de playbook específica (p. ej., solo con la etiqueta devin o al asignar la incidencia a Devin), Devin usa este playbook predeterminado.
  • Agregar playbooks: Haz clic en “Agregar playbook” para agregar playbooks adicionales. Solo se pueden agregar playbooks que tengan una macro.
  • Eliminar playbooks: Elimina un playbook para dejar de usar su etiqueta como activador.

​
Activaciones de automatización

Las activaciones de automatización permiten que Devin empiece a trabajar automáticamente en tickets cuando coinciden con determinadas condiciones, sin necesidad de asignarlos ni etiquetarlos manualmente. Puedes configurar activaciones según lo siguiente:
  • Projects: Solo se activan para tickets de proyectos específicos de Jira.
  • Labels: Solo se activan cuando un ticket tiene etiquetas específicas.
  • Statuses: Solo se activan cuando un ticket alcanza un estado específico (p. ej., “To Do”, “In Progress”).
  • Playbook: Opcionalmente, especifica qué playbook debe usar Devin para la sesión que se active.
Las activaciones usan detección de transiciones, lo que significa que solo se activan cuando un ticket pasa de no coincidir a coincidir con las condiciones de la activación (p. ej., cuando se agrega una etiqueta o cambia un estado), y no para tickets que ya coinciden.

​
Enterprise: asignación de proyectos de Jira

En despliegues Enterprise con múltiples organizaciones de Devin, los administradores pueden asignar proyectos de Jira a organizaciones específicas de Devin. Esto garantiza que los tickets de cada proyecto de Jira se dirijan a la organización de Devin correcta. Esta asignación es necesaria para que la integración de Jira funcione en entornos Enterprise.

​
Interactuar con Devin en Jira

Una vez que Devin empieza a trabajar en un ticket, se comunica a través de Jira:
  • Enlaces de PR: Cuando Devin crea una pull request, la URL de la PR se agrega automáticamente como enlace remoto en el issue de Jira y se publica en un comentario.
  • Enlace de la sesión: Se proporciona un enlace directo a la sesión de Devin en la aplicación web para que puedas seguir el progreso en tiempo real.
  • Mensajes de seguimiento: Menciona @Devin en un comentario para darle instrucciones adicionales a Devin o hacer preguntas.

​
Conectar una cuenta de servicio

Después de conectar Jira con tu cuenta de administrador, también puedes conectar una cuenta de servicio mediante credenciales de cliente de OAuth 2.0. Esto hace que los comentarios de Devin aparezcan con una identidad de bot dedicada en lugar de tu cuenta personal.
  1. En la configuración de administración de tu organización de Atlassian, crea una cuenta de servicio de OAuth 2.0 con los siguientes ámbitos Classic:
    • read:me
    • read:jira-user
    • read:jira-work
    • write:jira-work
  2. En Settings > Integrations > Jira, haz clic en Conectar cuenta de servicio e introduce el ID de cliente y el secreto de cliente.