Review

Review es el componente de GitHub que trabaja con las pull requests de un repositorio, las propuestas de cambio en el código que el equipo revisa antes de aceptarlas. Con él puedes consultar una pull request o la lista de pull requests, añadir un comentario, consultar sus revisiones y crear una revisión que comente, apruebe o pida cambios.

Es útil para automatizar la parte repetitiva de la revisión de código: avisar al equipo de las propuestas pendientes, dejar un comentario con el resultado de una comprobación o permitir que un agente de IA revise una propuesta y deje su opinión.

Cuándo usarlo

Cada mañana quieres enviar al equipo la lista de pull requests abiertas.
Un agente de IA revisa una propuesta de cambio y deja su revisión en GitHub.
Quieres dejar un comentario automático en una pull request cuando termina una comprobación en otro sistema.
Quieres saber quién ha revisado una pull request y con qué resultado antes de seguir con un proceso.

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, `List PRs`.
Pull Request Number (obligatorio)	El número de la pull request, el que aparece junto a su título en GitHub. Se usa en todas las operaciones salvo `List PRs`.
Review ID (obligatorio)	Solo en `Get Review`. El identificador de la revisión que quieres consultar. Lo obtienes con `List Reviews`.
Comment Body (obligatorio)	Solo en `Create PR Comment`. El texto del comentario.
Review Body	Solo en `Create Review`. El texto de la revisión. Es obligatorio si Review Event es `COMMENT` o `REQUEST_CHANGES`.

Operaciones

Operación	Qué hace
`Get PR`	Trae los datos de una pull request.
`List PRs`	Trae la lista de pull requests del repositorio.
`Create PR Comment`	Añade un comentario sencillo a una pull request, sin aprobarla ni pedir cambios.
`Get Review`	Trae los datos de una revisión concreta de una pull request.
`List Reviews`	Trae todas las revisiones de una pull request.
`Create Review`	Crea una revisión formal que comenta, aprueba o pide cambios, según Review Event.

Opciones avanzadas

Campo	Qué hace
Review Event	Solo en `Create Review`. El tipo de revisión: `COMMENT` (solo comentario), `APPROVE` (aprueba la propuesta) o `REQUEST_CHANGES` (pide cambios). Por defecto, `COMMENT`.
PR State	Solo en `List PRs`. `all`, `open` o `closed`, para filtrar por estado. Por defecto, `open`.
Limit	Solo en `List PRs` y `List Reviews`. Cuántos elementos traer como máximo, hasta 1000. Por defecto, 100.

Resultado

La salida Data depende de la operación:

Get PR: el número, el título, la descripción, el estado, el autor, las fechas, si se ha fusionado y si se puede fusionar, el enlace, la rama de origen y la de destino, y el número de cambios confirmados (commits), de líneas añadidas y eliminadas y de archivos cambiados.
List PRs: un elemento por pull request con su número, título, estado, autor, fechas, enlace y ramas.
Create PR Comment: una confirmación con el identificador del comentario y su enlace.
Get Review y List Reviews: el identificador de la revisión, quién la hizo, su resultado, su texto, la fecha y el enlace.
Create Review: una confirmación con el identificador de la revisión, su tipo y su enlace.

Puedes conectar el resultado a un componente de mensajería para avisar al equipo o a un agente para que lo analice. El componente también se puede conectar a un Agente como herramienta, para que el agente consulte pull requests y deje sus revisiones. Ver Tool Mode.

Ejemplo

Un equipo de desarrollo quiere un aviso diario con las propuestas pendientes de revisar.

Añade Review con la operación List PRs y elige el repositorio del equipo.
Deja PR State (opciones avanzadas) en open.
Conecta la salida Data a un agente que prepare un resumen con el título, el autor y el enlace de cada propuesta.
Envía el resumen al canal del equipo y programa el flujo para que se ejecute cada mañana.

Componentes relacionados

Issue: gestionar las issues de un repositorio.
Repository: lista los repositorios de tu cuenta.
File: leer y escribir archivos de un repositorio.
Release: gestionar las versiones publicadas.