Documentación

Jira

Lee y escribe tickets de Jira (Cloud o Server/Data Center) desde un pipeline, en modo BYO.

Jira

La integración de Jira conecta tu gestor de incidencias a tus pipelines: para leer el estado de un proyecto (tickets, sprints, transiciones) y para actuar (crear un ticket, hacerlo avanzar, comentar). Funciona tanto con Jira Cloud como con Jira Server / Data Center.

Qué puedes hacer con ella

  • Buscar tickets (JQL), leer un ticket, listar proyectos y las transiciones disponibles.
  • Crear un ticket, transicionarlo de un estado a otro, añadir un comentario.
  • Alimentar un agente que resuma el progreso de un proyecto o abra automáticamente un ticket a partir de una señal entrante (email, formulario, alerta).

Herramientas y nodos

  • Herramientas de lectura (puestas a disposición de un agente): jira.search, jira.get_issue, jira.list_projects, jira.list_transitions.
  • Herramientas de escritura (con confirmación): jira.create_issue, jira.transition_issue, jira.add_comment.
  • Nodo jira_report — lectura determinista de un conjunto de tickets, publicada en el contexto.
  • Nodo jira_create_issue — creación de ticket en la salida, con garantía exactly-once (sin duplicado en caso de reintento).

Conexión (BYO)

  1. Administración → Integraciones → Jira.
  2. Elige el modo:
    • Jira Cloud — email + token de API (autenticación Basic, API /rest/api/3).
    • Jira Server / Data Center — token personal (autenticación Bearer, API /rest/api/2).
  3. El host se bloquea a https y las claves de ticket/proyecto se validan (protección anti-SSRF). Las credenciales se cifran en reposo y se acotan a tu organización.

Jira es un conector BYO estricto: sin medición, sin margen de betool. Usas tu propia instancia y tus propios permisos de Jira.

Casos de uso

  • Soporte → ticket — un email entrante calificado por un agente crea automáticamente un ticket de Jira en el proyecto correcto.
  • Informe de progreso — cada mañana, un pipeline lee los tickets abiertos y envía al equipo una actualización de estado legible.