Gestión de proyectos

Conectar Jira a un agente de IA autónomo

Un agente de Atako conectado a Jira puede buscar, crear y hacer avanzar issues en sus workflows, con los mismos derechos que la cuenta que generó el token.

Escrito por los agentes de Atako · Revisado y validado por Romain Laodicina · CTO de Atako

Flujos de trabajo posibles

Triaje y priorización de los tickets entrantes

A partir de una señal recibida por un canal de soporte o un formulario, el agente crea la issue con el tipo y la prioridad correctos (create_issue), la asigna según sus reglas de negocio (assign_issue) y añade el contexto recibido como comentario (add_comment). El equipo se encuentra un ticket ya clasificado, sin haber tenido que leerlo una primera vez para ordenarlo antes de empezar el trabajo real sobre él.

Informe semanal de avance del sprint

El agente consulta las issues del sprint en curso con una consulta JQL (search_issues), obtiene el tiempo registrado en ellas (list_worklogs) y los cambios recientes (get_issue_changelog), y luego publica una síntesis como comentario en el epic o en el ticket padre (add_comment). El informe está disponible cada lunes por la mañana sin necesidad de una reunión de estado previa, con los tickets bloqueados destacados en lugar de perdidos en la lista completa del sprint.

Seguimiento y cierre de los tickets vinculados a un incidente

En cuanto otro canal confirma una corrección, el agente comprueba las transiciones de workflow disponibles (list_transitions), hace avanzar el ticket (transition_issue), lo vincula al incidente de origen (create_issue_link) y avisa a los watchers correspondientes. El ticket conserva un rastro completo del recorrido, útil para un post-mortem escrito sin tener que reconstruir la cronología a posteriori a partir de mensajes de Slack dispersos o de la memoria de cada persona.

Acciones del conector

  • search_issues (lectura, JQL)

    Busca issues con una consulta JQL.

  • get_issue (lectura)

    Obtiene una issue por id o clave.

  • get_issue_changelog (lectura)

    Obtiene el historial de modificaciones de una issue.

  • list_worklogs (lectura)

    Lista el tiempo registrado en una issue.

  • list_transitions (lectura)

    Lista las transiciones de workflow disponibles para una issue.

  • list_projects (lectura)

    Lista los proyectos visibles para la cuenta.

  • create_issue (escritura)

    Crea una issue en un proyecto.

  • update_issue (escritura)

    Actualiza los campos de una issue existente.

  • transition_issue (escritura)

    Hace avanzar una issue en su workflow.

  • add_comment (escritura)

    Añade un comentario a una issue.

  • assign_issue (escritura)

    Asigna una issue a un usuario.

  • add_worklog (escritura)

    Registra el tiempo dedicado a una issue.

  • create_issue_link (escritura)

    Vincula dos issues entre sí (bloquea, afecta a).

Requisitos previos

  • Cuenta de Jira con derechos browse, create y edit sobre los proyectos objetivo (no hace falta ser administrador de Jira).
  • Generar un token de API en id.atlassian.com, sección Security, luego API tokens.
  • Conocer el nombre del sitio de Jira (el yourcompany de yourcompany.atlassian.net).
  • Componer el identificador con el formato email:token para la autenticación.
  • En Atako, un derecho de administración de integraciones para conceder el grant al agente.

Cómo conectar

  1. 1

    Generar un token de API de Atlassian

    En id.atlassian.com, ir a Security y luego a API tokens, crear un token, nombrarlo y copiarlo.

  2. 2

    Componer el identificador de conexión

    Combinar el correo de la cuenta de Jira y el token de API con el formato email:token.

  3. 3

    Conectar Jira en Atako

    En Ajustes, luego Integraciones, indicar el nombre del sitio de Jira y pegar el identificador.

  4. 4

    Conceder el grant al agente

    Desde la página del agente o desde la conexión, seleccionar las acciones precisas autorizadas y su alcance.

Por qué conectar un agente autónomo a Jira

Jira sigue siendo el lugar donde un equipo técnico da seguimiento a sus issues, pero el triaje, el seguimiento y el reporting alrededor de esas issues consumen un tiempo desproporcionado respecto al trabajo real de desarrollo. Un agente de Atako conectado a Jira mediante tool calling puede hacer parte de ese trabajo de forma continua, en su propio entorno, sin esperar a una reunión de estado semanal.

La diferencia con un webhook o un script programado clásico: el agente funciona de forma permanente e interpreta una situación antes de actuar. Puede recibir una señal de otro canal (correo, Slack), consultar Jira con una consulta JQL para recuperar el contexto, y luego decidir crear una issue, comentarla o hacerla avanzar en el workflow, según las acciones que se le hayan concedido.

El conector de Jira cubre 39 acciones según la documentación de Atako (24 de lectura, 15 de escritura), desde la búsqueda JQL hasta el seguimiento de los worklogs. Un uso concreto del lado del producto: el triaje de incidentes de CI/CD, donde el agente correlaciona un fallo de pipeline con los commits recientes antes de abrir un ticket de Jira ya documentado.

Límites y buenas prácticas

Atlassian está evolucionando sus límites de tasa en la API de Jira Cloud hacia un modelo de puntos, donde cada solicitud consume un coste variable según su complejidad, con un tope en ráfaga por segundo además del tope por hora. Un agente que consulta muchas issues de golpe debe por tanto paginar sus llamadas en lugar de cargarlo todo en una sola solicitud.

El token de API hereda estrictamente los permisos de la cuenta de Jira que lo creó: si esa cuenta no tiene acceso a un proyecto, el agente tampoco lo tendrá, sea cual sea el grant configurado del lado de Atako.

Como con cualquier integración, la conexión por sí sola no da ningún acceso: hace falta un grant preciso (agente, acción, alcance). Consulte el modelo de permisos y los planes antes de conectar el agente a sus proyectos de Jira.

Casos de uso relacionados

Integraciones complementarias

Preguntas frecuentes

¿Puede el agente cerrar un ticket de Jira por sí solo?

Sí, si dispone de la acción transition_issue con alcance de escritura y el workflow del proyecto permite la transición solicitada. Sin ese grant explícito, el agente puede leer y comentar pero no hacer avanzar el estado de una issue.

¿Hace falta ser administrador de Jira para conectar el agente?

No. El token de API hereda los derechos de la cuenta que lo generó: basta con una cuenta con acceso browse, create y edit sobre los proyectos objetivo, no es necesaria la administración completa de Jira.

¿Cómo se revoca el acceso del agente a Jira?

Elimine el token de API desde id.atlassian.com, o revoque la conexión del lado de Atako. En ambos casos, todos los agentes que usan esa conexión pierden el acceso de inmediato.

¿Puede el agente eliminar una issue de Jira de forma definitiva?

La acción delete_issue existe en el conector, incluida la eliminación de las subtareas asociadas, pero solo está disponible si el grant del agente la autoriza explícitamente con alcance de escritura.

Qué leer a continuación

Fuentes

Romain Laodicina

CTO de Atako

Este contenido fue redactado por los agentes de IA de Atako, y luego revisado, corregido y validado por Romain Laodicina, CTO de Atako.

Despliegue sus primeros agentes IA

Cree su cuenta gratis y active un agente en minutos, sin código.

Manténgase a la vanguardia de la IA.

Reciba las novedades de producto, los nuevos agentes y nuestros análisis de IA directamente en su correo. Sin spam, cancele la suscripción cuando quiera.