Release

Release es el componente de GitHub que gestiona las versiones publicadas de un repositorio, lo que GitHub llama releases: cada una tiene una etiqueta (por ejemplo v1.2.0), un nombre y una descripción con las novedades. Con él puedes publicar una versión nueva, consultar una versión o la lista completa, cambiar su nombre o su descripción y eliminarla.

Es útil cuando la publicación de una versión forma parte de un proceso más amplio, por ejemplo cuando un agente redacta las notas de la versión o cuando quieres avisar a tus clientes de cada novedad.

Cuándo usarlo

Un agente redacta las notas de una versión a partir de las tareas cerradas y quieres publicarlas en GitHub.
Quieres enviar a tus clientes un correo con las novedades cada vez que se publica una versión.
Quieres mantener en una hoja de cálculo el historial de versiones de tus productos.
Necesitas corregir la descripción de una versión ya publicada.

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/app`. También acepta el enlace del repositorio en GitHub.
Operation (obligatorio)	Lo que hace el componente. Ver Operaciones. Por defecto, `Create Release`.
Release Tag (obligatorio)	La etiqueta de la versión, por ejemplo `v1.2.0`. Se usa en todas las operaciones salvo `List All`.
Release Name (obligatorio)	Solo en `Create Release` y `Update Release`. El nombre de la versión. En `Update Release`, si lo dejas vacío se mantiene el actual.
Release Description (obligatorio)	Solo en `Create Release` y `Update Release`. La descripción o las notas de la versión. En `Update Release`, si lo dejas vacío se mantiene la actual.

Operaciones

Operación	Qué hace
`Get Release`	Trae los datos de la versión con esa etiqueta.
`Create Release`	Publica una versión nueva con la etiqueta, el nombre y la descripción indicados.
`Update Release`	Cambia el nombre o la descripción de una versión existente. Tienes que rellenar al menos uno de los dos.
`Delete Release`	Elimina la versión con esa etiqueta.
`List All`	Trae la lista de versiones del repositorio.

Opciones avanzadas

Campo	Qué hace
Limit	Solo en `List All`. Cuántas versiones traer como máximo, hasta 1000. Por defecto, 100.

Resultado

La salida Data depende de la operación:

Get Release y List All: la etiqueta, el nombre, la descripción, el enlace, las fechas de creación y de publicación y si es un borrador o una versión preliminar. Con List All sale un elemento por versión.
Create Release y Update Release: una confirmación con la etiqueta y el enlace de la versión.
Delete Release: una confirmación con la etiqueta eliminada.

Puedes conectar el resultado a un componente de correo o de mensajería para anunciar la versión, o a un agente para que redacte un resumen. El componente también se puede conectar a un Agente como herramienta. Ver Tool Mode.

Ejemplo

Un equipo de producto quiere publicar cada versión con notas redactadas por un agente.

Un agente redacta las notas de la versión a partir de la lista de tareas terminadas.
Añade Release con la operación Create Release y elige el repositorio de la aplicación.
En Release Tag escribe v2.4.0 y en Release Name Versión 2.4.
Conecta la respuesta del agente a Release Description.
Conecta la salida Data a un correo para el equipo comercial con el enlace de la versión.

Buenas prácticas

Usa siempre el mismo formato de etiqueta, por ejemplo v seguido del número de versión: las demás operaciones buscan la versión por esa etiqueta exacta.
Antes de usar Delete Release, comprueba la etiqueta. Eliminar una versión no se puede deshacer desde NappAI.

Componentes relacionados

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