Linear y Jira
Convierte una incidencia en un ticket de Linear o Jira Cloud y mantén ambos sincronizados hasta que el bug se corrija.
Cuando las ejecuciones encuentran un problema en tu producto, Autonomy lo guarda como una incidencia del proyecto y vincula a esa misma incidencia cada ejecución que lo vuelve a ver. Linear y Jira Cloud convierten esa incidencia en un ticket de tu gestor y mantienen ambos al día durante toda la vida del bug.
Qué obtienes
| Evento | Qué pasa |
|---|---|
| Pulsas Create in Linear o Create in Jira en una incidencia (o la creación automática está activada) | Se crea un ticket con el título de la incidencia, los detalles, el resultado esperado y el real, el entorno y enlaces a la incidencia y a cada ejecución que la mostró. |
| Una ejecución posterior ve la misma incidencia | Un comentario en el ticket: "Seen again. Seen in N runs now." Nunca un segundo ticket. |
| Una ejecución ve la incidencia después de que se resolviera | La incidencia se reabre y el ticket recibe "Seen again after being resolved. Seen in N runs now." |
| Cierras o cancelas el ticket | La incidencia pasa a Resolved. |
| Reabres el ticket | La incidencia vuelve a Open. |
| Eliminas el ticket | La incidencia se desvincula, conserva su estado y se puede volver a crear un ticket. |
Solo vuelve el estado. El responsable asignado, la prioridad, las etiquetas y el título se quedan en el gestor. El gestor nunca cambia las incidencias Ignored, y un ticket nunca cambia una ejecución ni su resultado.
Un ticket muestra lo que muestra la página de la incidencia. Nunca contiene prompts, detalles del modelo de IA, costes, árboles de página en bruto ni credenciales.
Conectar
Cada gestor se conecta una sola vez para la organización. Solo propietarios y administradores.
Linear
- Abre Organization → Integrations → Linear e inicia sesión en Linear. Los tickets y comentarios los publica la app de Autonomy, no la persona que la conectó.
- Elige los equipos que quieres compartir y después elige el equipo de cada proyecto.
La sincronización del estado desde Linear funciona sola. No hay que añadir nada en Linear.
Jira Cloud
- Abre Organization → Integrations → Jira e inicia sesión en Jira. Elige el sitio.
- Elige los proyectos de Jira que quieres compartir y después elige el proyecto de Jira de cada proyecto. Los tickets usan el tipo de incidencia Bug del proyecto de Jira, o su primer tipo de incidencia si no tiene Bug.
- Configura la sincronización del estado. En la fila Status sync, "Add a webhook in Jira so ticket status changes come back to issues.", pulsa Show setup. Muestra una URL y un secreto, y Open Jira abre la página de webhooks de tu sitio.
- En Jira, crea un webhook con esa URL y ese secreto, marca Issue: updated e Issue: deleted, y guarda. Esto requiere un administrador de Jira.
Sin el paso 4, la creación de tickets y comentarios sigue funcionando; solo dejan de volver los cambios de estado hechos en Jira. Al volver a conectar Jira se conserva el mismo secreto, así que el webhook sigue funcionando.
Elegir adónde van los tickets
Los tickets van al destino del proyecto de la incidencia:
- Linear: un equipo.
- Jira: un proyecto de Jira.
Elígelo en cualquiera de estos dos sitios:
- Organization → Integrations → Linear o Jira: una tabla con cada proyecto y su equipo o proyecto de Jira. Elige Not used para un proyecto que no deba crear tickets allí.
- Settings → Integrations del proyecto: las filas Linear y Jira.
Elegir un destino requiere ser propietario o administrador. Si un entorno tenía su propio equipo o proyecto de Jira antes de que existieran los proyectos, lo conserva: los tickets de las incidencias de ese entorno siguen yendo allí.
Crear un ticket desde una incidencia
- Abre la incidencia en la página Issues del proyecto.
- En Linked tickets, pulsa Create in Linear · TEAM o Create in Jira · KEY.
El ticket aparece en Linked tickets con su estado. Si el proyecto todavía no tiene destino, la fila lo indica y los administradores ven un enlace para elegirlo en los ajustes del proyecto.
También puedes pegar el enlace de un ticket existente con Link a ticket. Un enlace pegado solo sirve como referencia: oculta el botón Create de ese gestor y su estado no se sincroniza.
Crear tickets automáticamente
Por defecto no se crea nada hasta que alguien pulsa Create. Para crear tickets sin que nadie pulse nada:
- Abre Settings → Integrations del proyecto.
- Activa File tickets for new bugs automatically, debajo de la fila de Jira.
"When a run finds a new bug, a ticket is created in the team or project above. Off by default: otherwise someone creates it from the issue." El interruptor necesita antes un equipo de Linear o un proyecto de Jira ("Choose a Linear team or Jira project above first."), y solo los propietarios y administradores pueden cambiarlo.
Con el interruptor activado, cada Bug nuevo que encuentra una ejecución se convierte en un ticket en cada gestor conectado para el que el proyecto tiene destino. Los riesgos nunca generan tickets automáticamente. Una ejecución que vuelve a ver un bug existente solo añade un comentario. Si lo desactivas, las ejecuciones siguen encontrando incidencias; simplemente no se crean tickets.
Si solo algunos entornos crean tickets automáticamente, por ejemplo por una configuración anterior, la fila dice "On for Production and Staging only. Switch it off and on again to use it in every environment."
Solución de problemas
El gestor vuelve a mostrar Connect
El gestor revocó o dejó caducar el acceso de Autonomy, por ejemplo porque la persona que lo conectó se fue o porque se desinstaló la app. Un administrador vuelve a conectarlo; los enlaces a tickets existentes siguen funcionando.
La conexión falla
"Couldn't connect Linear: access wasn't allowed." significa que se rechazó el inicio de sesión: inténtalo de nuevo y elige Allow. Si no, vuelve a intentarlo o pide ayuda a un administrador de tu espacio de Linear o Jira.
No hay botón Create en una incidencia
El proyecto no tiene equipo ni proyecto de Jira para ese gestor, o la incidencia ya tiene un ticket en él, creado o pegado. Elige un destino o elimina el enlace pegado.
Cerrar el ticket de Jira no resuelve la incidencia
Revisa el webhook en Jira: debe usar exactamente la URL y el secreto de Status sync, con Issue: updated marcado.
La incidencia siguió ignorada después de reabrir el ticket
Es intencionado. Una incidencia Ignored es conocida y aceptada, y el gestor nunca la cambia.
¿No lo encontraste?