Issue

Issue es el componente de GitHub que gestiona las issues de un repositorio, las fichas donde un equipo apunta errores, tareas y peticiones. Con él puedes consultar una issue o la lista de issues, crear una nueva, cambiar su título, descripción, estado o etiquetas, añadirle un comentario, bloquear o desbloquear su conversación y cerrarla.

Es útil cuando las incidencias nacen fuera de GitHub, por ejemplo en un formulario de soporte o en un correo de un cliente, y quieres que lleguen al equipo técnico sin copiarlas a mano.

Cuándo usarlo

Un cliente informa de un error por el formulario de soporte y quieres abrir una issue con su descripción.
Cada mañana quieres un resumen de las issues abiertas con una etiqueta concreta, por ejemplo urgente.
Un agente de IA atiende consultas técnicas y necesita consultar si un error ya está registrado y comentar en la issue.
Cuando se resuelve un caso en tu herramienta de soporte, quieres cerrar la issue correspondiente en GitHub.

Configuración

Necesitas una credencial GitHub API con un token de acceso personal de GitHub (Personal Access Token) con permiso sobre el repositorio. Consulta Credenciales.

Campo	Qué hace
Credential (obligatorio)	La credencial GitHub API con la que se accede a tu cuenta.
Repository Input Type	Cómo indicas el repositorio. `Select` lo eliges de una lista; `Manual` lo escribes. Por defecto, `Select`.
Repository (obligatorio)	Con `Select`. El repositorio con el que trabajar. La lista se carga al elegir la credencial y muestra hasta 100 repositorios de tu cuenta; si el tuyo no aparece, usa `Manual`.
Repository ID (obligatorio)	Con `Manual`. El repositorio en el formato `dueño/repositorio`, por ejemplo `mi-empresa/web`.
Operation (obligatorio)	Lo que hace el componente. Ver Operaciones. Por defecto, `List`.
Issue Number	El número de la issue, el que aparece junto a su título en GitHub. Obligatorio en todas las operaciones salvo `List` y `Create`.
Issue Title	El título de la issue. Obligatorio en `Create`; en `Edit`, solo si quieres cambiarlo.
Issue Body	Solo en `Create` y `Edit`. La descripción de la issue.
Comment Body (obligatorio)	Solo en `Create Comment`. El texto del comentario.

Operaciones

Operación	Qué hace
`Get`	Trae los datos de una issue: título, estado, descripción y número de comentarios.
`List`	Trae la lista de issues del repositorio, con los filtros de estado y etiquetas que elijas.
`Create`	Crea una issue nueva y devuelve su número y su enlace.
`Edit`	Cambia el título, la descripción, el estado o las etiquetas de una issue.
`Create Comment`	Añade un comentario a una issue.
`Lock`	Bloquea la conversación de una issue, marcada como resuelta, para que no se puedan añadir más comentarios.
`Unlock`	Vuelve a abrir la conversación de una issue bloqueada.
`Delete`	Cierra la issue. La issue no se borra: queda en GitHub con el estado cerrado.

Opciones avanzadas

Campo	Qué hace
Labels	Solo en `List`, `Create` y `Edit`. Etiquetas separadas por comas. En `List` filtra las issues que las tienen; en `Create` y `Edit` se asignan a la issue.
State	Solo en `List` y `Edit`. `all`, `open` o `closed`. En `List` filtra por estado; en `Edit`, `open` reabre la issue y `closed` la cierra (con `all` no cambia). Por defecto, `all`.
Limit	Solo en `List`. Cuántas issues traer como máximo, hasta 1000. Por defecto, 100.

Resultado

La salida Data depende de la operación:

Get: el número, el título, el estado, la descripción y el número de comentarios de la issue.
List: un elemento por issue con su descripción como texto y su enlace, título, autor, fecha de creación, número de comentarios, estado, etiquetas, persona asignada y si está bloqueada. GitHub incluye también las pull requests en esta lista; cada elemento indica si lo es.
Create y Edit: una confirmación con el número de la issue y su enlace.
Create Comment: una confirmación con el identificador del comentario.
Lock, Unlock y Delete: una confirmación con el número de la issue.

Puedes conectar el resultado a un componente de mensajería para avisar al equipo o a un agente para que resuma las issues. El componente también se puede conectar a un Agente como herramienta, para que el agente decida cuándo consultar, crear o comentar issues. Ver Tool Mode.

Ejemplo

Una empresa de software quiere que cada error enviado por el formulario de soporte llegue a GitHub.

El formulario llega al flujo con el asunto y la descripción que escribe el cliente.
Añade Issue con la operación Create y elige el repositorio del producto en Repository.
Conecta el asunto a Issue Title y la descripción a Issue Body.
En Labels (opciones avanzadas) escribe soporte.
Conecta la salida Data a un correo que responda al cliente con el enlace de la issue.

Buenas prácticas

En Edit, escribe siempre la descripción completa en Issue Body: lo que pongas sustituye a la descripción actual y, si lo dejas vacío, la issue se queda sin descripción.
Guarda el número de la issue cuando la crees, por ejemplo en tu herramienta de soporte: lo necesitas para comentarla, cambiarla o cerrarla después.
Las etiquetas que uses deben escribirse igual que en GitHub para que el filtro de List las encuentre.

Componentes relacionados

Repository: lista los repositorios de tu cuenta.
Review: trabajar con pull requests y sus revisiones.
File: leer y escribir archivos de un repositorio.
Release: gestionar las versiones publicadas.