Remitente de Correos de Revisión de Código de GitHub Impulsado por IA - Flujo de trabajo de n8n

Texto formateado en Markdown:
Equipos de desarrollo de software que requieren feedback inmediato sobre los nuevos 'commits'.
Ingenieros DevOps que buscan integrar puertas de calidad automatizadas en sus pipelines de CI/CD usando n8n.
Usuarios de n8n que necesitan un ejemplo avanzado de combinación de webhooks, código personalizado y modelos de lenguaje grandes.
Líderes técnicos que buscan monitorizar la calidad del código en múltiples repositorios usando un único flujo de trabajo de n8n.

La revisión manual de código puede llevar mucho tiempo y ser propensa al error humano. Este flujo de trabajo de n8n soluciona este problema creando un ciclo de retroalimentación de calidad de código en tiempo real impulsado por IA. Cuando un desarrollador sube código a un repositorio de GitHub monitorizado, el disparador (trigger) de n8n activa la automatización al instante. El flujo obtiene los detalles completos del 'commit' y pasa la diferencia de código formateada a un Agente de IA inteligente usando Groq. El agente analiza problemas funcionales, de estilo, posibles fallos de seguridad y sugiere mejoras, devolviendo un resumen estructurado en HTML. Todo este proceso, gestionado por varios nodos de n8n, asegura una retroalimentación de código rápida y coherente entregada directamente a la bandeja de entrada del revisor vía Gmail, convirtiéndolo en una de las plantillas de n8n más útiles para los equipos modernos.

Este potente flujo de trabajo de n8n comienza su ejecución con el nodo 'Trigger de Github' de n8n. Este disparador de n8n está configurado para escuchar eventos de 'push' en un repositorio específico.

1. Disparador y Análisis de Datos: Cuando ocurre un 'push', el 'Trigger de Github' captura la carga útil ('payload'). El siguiente nodo 'Parser' de n8n extrae metadatos esenciales (nombre del repositorio, propietario, ID del 'commit').


2. Obtención de Detalles del Commit: Un nodo 'Petición HTTP' de n8n utiliza entonces el ID del 'commit' para llamar a la API de GitHub, recuperando la información detallada del 'commit', incluidos los cruciales datos de parche/diff.


3. Formato HTML (Nodo Code): Un nodo especializado 'Code' de n8n toma los datos brutos del 'commit' y los transforma en una salida HTML muy estilizada. Esto incluye la codificación por colores de las diferencias de código (verde para adiciones, rojo para eliminaciones) para una legibilidad óptima en un cliente de correo electrónico.


4. Análisis de IA (Nodo Agente de IA): El nodo 'Agente de IA' de n8n recibe este HTML formateado. Se le instruye mediante una instrucción de sistema estricta para que actúe como un revisor de código experto, centrándose en preocupaciones funcionales, de estilo y de seguridad. Utiliza el Modelo de Chat de Groq y un nodo 'Memoria Simple' de n8n para el procesamiento, aunque la memoria es opcional para una revisión de una sola pasada.


5. Combinación de Salida: Un nodo 'Parser de Salida Code' de n8n fusiona los detalles originales del 'commit' (del primer nodo 'Code') y el resumen HTML estricto generado por el Agente de IA.


6. Notificación Final: La salida HTML final se envía a través del nodo 'Gmail' de n8n al destinatario especificado (el revisor o el equipo de desarrollo), completando el flujo de trabajo automatizado de n8n. El flujo concluye entonces con el nodo 'Fin del Flujo de Trabajo' de n8n.

Texto formateado en Markdown:

1. Importar la plantilla de n8n: Copia el JSON proporcionado y pégalo en tu instancia de n8n usando el menú 'Nuevo' -> 'Importar desde JSON'.


2. Credenciales de GitHub: Configura las credenciales para el nodo 'Trigger de Github' de n8n y el nodo 'Petición HTTP' de n8n.


3. Configuración de Groq: Configura el nodo 'Modelo de Chat de Groq' de n8n con tu clave API de Groq.


4. Configuración del Trigger de Github: Personaliza la URL del repositorio y los detalles del propietario en el nodo 'Trigger de Github' de n8n para monitorizar tu proyecto objetivo. Asegúrate de que el webhook esté configurado correctamente en la configuración de tu repositorio de GitHub para que apunte a la URL del disparador de n8n.


5. Configuración de Gmail: Configura el nodo 'Gmail' de n8n con tus credenciales OAuth2. Actualiza el parámetro sendTo a la dirección de correo electrónico del revisor deseado.


6. Activar: Guarda y activa el flujo de trabajo de n8n. Ahora se ejecutará automáticamente en cada evento de 'push'.

Texto formateado en Markdown:
Trigger de Github (disparador de n8n):
Función: Inicia el flujo de trabajo de n8n tras un evento de 'push' en un repositorio específico de GitHub.
Configuración clave: Eventos configurados como push. Los detalles del repositorio deben actualizarse manualmente para que coincidan con tu proyecto.
Petición HTTP (nodo n8n):
Función: Obtiene metadatos detallados del 'commit', incluidos los parches de archivos, utilizando expresiones dinámicas que hacen referencia al ID del 'commit' proporcionado por los datos del disparador de n8n.
Configuración clave: Utiliza el tipo de credencial OAuth2 de GitHub para acceso seguro a la API. La URL se genera dinámicamente para solicitar datos del 'commit': =https://api.github.com/repos/{{ $json.body.repository.owner.name }}/.../commits/{{ $json.body.head_commit.id }}.
Code (nodo formateador de n8n):
Función: Transforma los datos brutos del 'commit' de GitHub (diffs) en HTML con estilo y codificación por colores para una excelente visualización por correo electrónico. Separa las líneas añadidas (+, verde) y las líneas eliminadas (-, rojo).
Configuración clave: Contiene lógica JavaScript personalizada (formatPatch y renderResponse) para estructurar metadatos (info del repo, autor, mensaje) y diferencias de código.
Modelo de Chat de Groq (nodo n8n):
Función: Proporciona el backend LLM para el Agente de IA, utilizando el rápido modelo llama-3.1-8b-instant para la generación rápida de revisiones de código.
Configuración clave: Requiere una credencial API de Groq.
Agente de IA (nodo n8n):
Función: Actúa como la inteligencia central. Toma la diferencia de código formateada en HTML como entrada y genera una revisión de código estricta y estructurada basada en las instrucciones detalladas del prompt.
Configuración clave: El prompt del sistema obliga a la IA a comprobar aspectos funcionales, de estilo, de seguridad y a sugerir mejoras, y fundamentalmente, a devolver sus hallazgos en uno de dos bloques HTML predefinidos.
Gmail (nodo n8n):
Función: Envía la salida HTML final combinada (detalles del 'commit' + revisión de IA) como una notificación por correo electrónico.
Configuración clave: El Asunto se establece como 'Revisión de Código'. El Mensaje utiliza la salida HTML final del nodo 'Parser de Salida' de n8n.