Jira Reader
Jira Reader conecta tu flujo con tu Jira Cloud para leer información sin modificar nada: buscar incidencias, traer una incidencia concreta con sus datos, descargar un archivo adjunto o consultar los proyectos, usuarios, tipos de incidencia, prioridades, estados y tipos de vínculo disponibles.
Es útil para preparar informes, para que un agente de IA responda preguntas sobre el estado de los proyectos o para obtener los datos que otro componente necesita, como la clave de un proyecto o el identificador de un usuario.
Cuándo usarlo
- Cada lunes quieres un resumen de las incidencias abiertas de un proyecto.
- Un agente de IA atiende al equipo y necesita consultar en qué estado está una incidencia.
- Quieres descargar los archivos adjuntos de una incidencia para procesarlos en el flujo.
- Necesitas el identificador de cuenta de un usuario para asignarle una incidencia con Jira Issue Handler.
Configuración
Necesitas una credencial Jira API con la dirección de tu Jira Cloud, el correo de tu cuenta de Atlassian y un token de API. Consulta Credenciales.
| Campo | Qué hace |
|---|---|
| Credential (obligatorio) | La credencial Jira API con la que se accede a tu Jira. |
| Operation (obligatorio) | Lo que hace el componente. Ver Operaciones. Por defecto, List Issues. |
| Project Key | El proyecto de Jira. Al elegir la credencial, la lista muestra tus proyectos. En List Issues (opcional: si lo dejas vacío, se buscan incidencias de todos los proyectos), List Users, List Issue Types, List Priorities y List Statuses. |
| Issue Key | La clave de la incidencia, por ejemplo PROJ-123. En Get Issue, List Attachments y List Watchers. |
| Attachment ID | El identificador del adjunto que quieres descargar. Lo obtienes con List Attachments. Solo en Get Attachment. |
| JQL Filter | Un filtro en el lenguaje de búsqueda de Jira (JQL) que se combina con el proyecto elegido, por ejemplo status = "In Progress" o priority = High AND status = "To Do". Opcional. Solo en List Issues. |
| Max Results | Cuántas incidencias traer como máximo. Por defecto, 50. Solo en List Issues. |
| Issue Type | El tipo de incidencia (Task, Bug…) cuyas prioridades quieres consultar. Solo en List Priorities. |
Operaciones
| Operación | Qué hace |
|---|---|
Get Issue | Trae una incidencia por su clave. |
Get Attachment | Descarga un archivo adjunto. |
List Issues | Busca incidencias, con el proyecto y el filtro JQL que indiques. |
List Users | Trae los usuarios a los que se pueden asignar incidencias en un proyecto. |
List Projects | Trae todos los proyectos a los que tienes acceso. |
List Issue Types | Trae los tipos de incidencia de un proyecto. |
List Priorities | Trae las prioridades disponibles en un proyecto. |
List Statuses | Trae los estados del flujo de trabajo de un proyecto. |
List Attachments | Trae la lista de adjuntos de una incidencia. |
List Watchers | Trae las personas que siguen una incidencia. |
List Link Types | Trae los tipos de vínculo entre incidencias (Blocks, Duplicates…). |
Resultado
La salida Jira Response devuelve un elemento por cada resultado. En List Issues, cada incidencia lleva su proyecto, clave, título, descripción en texto, tipo, prioridad, estado, persona asignada, incidencia padre y comentarios. En Get Attachment sale el archivo descargado, que puedes conectar a un componente que lea documentos o lo guarde.
Puedes conectar el resultado a un agente para que lo resuma o responda con él. El componente también se puede conectar a un Agente como herramienta, para que el agente decida qué consultar. Ver Tool Mode.
Ejemplo
Un equipo de desarrollo quiere un resumen semanal de las incidencias urgentes.
- Programa el flujo para que se ejecute cada lunes.
- Añade Jira Reader con la operación
List Issues. - Elige el proyecto en Project Key y escribe en JQL Filter
priority IN (High, Highest) AND resolution = Unresolved. - Conecta Jira Response a un agente que redacte el resumen y a un componente de correo que lo envíe al equipo.
Componentes relacionados
- Jira Issue Handler: crea y modifica incidencias, comentarios y adjuntos.
- Jira Webhook: pone en marcha un flujo cuando ocurre algo en Jira.