Docs de Autonomy
Integraciones

Linear y Jira

Convierte un bug detectado en un único ticket en Linear o Jira Cloud y mantenlo sincronizado hasta que el bug desaparezca.

Cuando una ejecución falla porque el producto está roto, Autonomy abre una nota de bug en el entorno y vincula a ella cada ejecución que encuentra el mismo fallo. Linear y Jira Cloud convierten esa nota en un único ticket en tu tracker — y mantienen ambos sincronizados durante toda la vida del bug.

Qué obtienes

EventoQué ocurre en el tracker
Pulsas Create in Linear / Create in Jira en una nota de bug (o el registro automático está activado)Se crea un issue con el resumen, el paso que falla, el número de ocurrencias y un enlace a cada ejecución y a la nota.
Una ejecución posterior encuentra el mismo bugUn comentario: "Seen again. N occurrences now." Nunca un segundo ticket.
Cierras el issue en el trackerLa nota de bug pasa a Resolved.
Una ejecución vuelve a encontrar el bug después de cerrarloLa nota se reabre y el issue recibe un comentario "Seen again after being resolved".
Reabres el issue en el trackerLa nota se reabre.
Eliminas el issue en el trackerLa nota se desvincula para que pueda registrarse de nuevo.

Solo el estado vuelve a Autonomy. El asignado, la prioridad, las etiquetas y el título nunca se copian a la nota, y un enlace de issue pegado a mano se queda solo como referencia.

El cuerpo del ticket tiene calidad de evidencia: qué vio el usuario, qué paso, con qué frecuencia y enlaces. Nunca contiene prompts, nombres de modelos, árboles de UI en bruto ni credenciales.

Conectar

Ambos trackers se conectan una vez por workspace en Settings → Integrations. Conectar requiere un administrador del workspace.

Linear

  1. Settings → Integrations → Linear → Connect Linear y autoriza en Linear. Los issues y comentarios se atribuyen a la app de Autonomy, no a la persona que la conectó.
  2. Eso es todo — la sincronización de estado desde Linear viene incorporada.

Jira Cloud

  1. Settings → Integrations → Jira → Connect Jira, elige el sitio de Jira y acepta.
  2. Pulsa Webhook setup en la tarjeta de Jira. Muestra una URL y un secreto, y enlaza a la página de webhooks de tu sitio.
  3. En Jira: Settings → System → Webhooks → Create a webhook. Pega la URL y el secreto, marca Issue: updated e Issue: deleted, y guarda.

Sin el paso 3, crear issues y comentarios sigue funcionando; solo el cierre en Jira no llegará a la nota.

Elegir a dónde van los tickets

El destino se define por entorno, la primera vez que creas un ticket desde una de sus notas de bug:

  • Linear — un equipo.
  • Jira — un proyecto y un tipo de issue.

Abre una nota de bug en Environment → Notes y la sección Linked issues muestra un selector. Una vez elegido, cada nota posterior de ese entorno tiene un botón de un clic Create in Linear · TEAM o Create in Jira · KEY / Type. Cámbialo en cualquier momento con change team / change project. Elegir un destino requiere un administrador del workspace.

Registrar automáticamente los bugs nuevos

Por defecto no se registra nada hasta que una persona pulsa el botón. Para registrar automáticamente, abre Environment → Settings → Issue trackers y activa Auto-file new bugs. El interruptor está disponible cuando el entorno tiene al menos un destino.

Con él activado, cada bug nuevo que Autonomy detecta en ese entorno se convierte en un ticket en cada tracker conectado con destino — sin que nadie haga clic. Las ejecuciones posteriores del mismo bug siguen añadiendo solo un comentario. Desactívalo y la detección sigue abriendo notas; simplemente deja de registrarlas.

Solución de problemas

La tarjeta vuelve a decir "Connect" después de haberse conectado

El tracker revocó el token o este caducó (por ejemplo, se eliminó al usuario que hizo la conexión o se desinstaló la app). Pulsa Connect de nuevo; los vínculos existentes siguen funcionando tras reconectar.

El botón Create muestra un selector de equipo/proyecto cada vez

El destino se guarda en el entorno. Si sigue preguntando, la persona que elige no es administrador del workspace — pide a un administrador que elija una vez.

Cerrar el issue de Jira no resuelve la nota

Comprueba el webhook en Jira: debe apuntar a la URL exacta de Webhook setup, usar ese secreto y tener Issue: updated marcado. Reconectar Jira conserva el mismo secreto, así que un webhook existente sigue funcionando.

Vinculé un issue a mano y Create ha desaparecido

Cualquier issue vinculado a un tracker oculta el botón Create de ese tracker — la nota ya tiene un destino. Desvincúlalo para registrar un ticket nuevo.

On this page