E-mail Automatizado de Revisão de Código de Commits do GitHub com IA - Fluxo de trabalho n8n

Markdown-formatted text:
Equipes de Desenvolvimento de Software que necessitam de feedback imediato sobre novos commits.
Engenheiros DevOps que procuram integrar portões de qualidade automatizados em seus pipelines de CI/CD usando o n8n.
Usuários do n8n que precisam de um exemplo avançado de combinação de webhooks, código personalizado e modelos de linguagem grandes.
Líderes técnicos que buscam monitorar a qualidade do código em vários repositórios usando um único fluxo de trabalho do n8n.

A revisão manual de código pode consumir tempo e estar sujeita a erros humanos. Este fluxo de trabalho do n8n resolve este problema criando um loop de feedback de qualidade de código em tempo real, orientado por IA. Quando um desenvolvedor envia código para um repositório GitHub monitorado, o gatilho (trigger) do n8n ativa instantaneamente a automação. O fluxo de trabalho busca os detalhes completos do commit e passa a diferença de código (diff) formatada para um Agente de IA inteligente usando o Groq. O agente analisa problemas funcionais, estilo, falhas de segurança potenciais e sugere melhorias, retornando um resumo estruturado em HTML. Todo este processo, gerenciado por vários nós do n8n, garante feedback de código rápido e consistente entregue diretamente na caixa de entrada do revisor via Gmail, tornando este um dos templates n8n mais úteis para equipes modernas.

Este poderoso fluxo de trabalho do n8n começa a execução com o nó Github Trigger do n8n. Este gatilho n8n é configurado para escutar eventos de 'push' em um repositório específico.

1. Gatilho e Análise de Dados: Quando ocorre um push, o Github Trigger captura o payload. O nó subsequente Parser do n8n extrai metadados essenciais (nome do repositório, proprietário, ID do commit).


2. Busca de Detalhes do Commit: Um nó HTTP Request do n8n usa então o ID do commit para chamar a API do GitHub, recuperando as informações detalhadas do commit, incluindo os dados cruciais de patch/diff.


3. Formatação HTML (Nó Code): Um nó Code especializado do n8n pega os dados brutos do commit e os transforma em uma saída HTML altamente estilizada. Isso inclui codificação por cores das diferenças de código (verde para adições, vermelho para exclusões) para legibilidade ideal em um cliente de e-mail.


4. Análise de IA (Nó AI Agent): O nó AI Agent do n8n recebe este HTML formatado. Ele é instruído através de um prompt de sistema rigoroso a agir como um revisor de código especialista, focando em questões funcionais, de estilo e de segurança. Ele utiliza o Modelo de Chat Groq e um nó Simple Memory do n8n para processamento, embora a memória seja opcional para revisão de passagem única.


5. Combinação da Saída: Um nó Output Parser Code do n8n mescla os detalhes originais do commit (do primeiro nó Code) e o resumo HTML rigoroso gerado pelo Agente de IA.


6. Notificação Final: A saída HTML finalizada é enviada via nó Gmail do n8n para o destinatário especificado (o revisor ou equipe de desenvolvimento), completando o fluxo de trabalho automatizado do n8n. O fluxo então é concluído com o nó End Workflow do n8n.

Markdown-formatted text:

1. Importação do template n8n: Copie o JSON fornecido e cole-o em sua instância do n8n usando o menu 'Novo' -> 'Importar do JSON'.


2. Credenciais do GitHub: Configure as credenciais para o nó Github Trigger do n8n e o nó HTTP Request do n8n.


3. Configuração do Groq: Configure o nó Groq Chat Model do n8n com sua chave de API Groq.


4. Configuração do Github Trigger: Personalize o URL do repositório e os detalhes do proprietário no nó Github Trigger do n8n para monitorar seu projeto alvo. Certifique-se de que o webhook esteja configurado corretamente nas configurações do seu repositório GitHub para apontar para o URL do gatilho do n8n.


5. Configuração do Gmail: Configure o nó Gmail do n8n com suas credenciais OAuth2. Atualize o parâmetro sendTo para o endereço de e-mail do revisor desejado.


6. Ativar: Salve e ative o fluxo de trabalho do n8n. Ele agora será executado automaticamente a cada evento de push.

Markdown-formatted text:
Github Trigger (n8n trigger):
Função: Inicia o fluxo de trabalho do n8n após um evento de 'push' em um repositório GitHub específico.
Configuração Chave: Eventos definidos como push. Os detalhes do repositório devem ser atualizados manualmente para corresponder ao seu projeto.
HTTP Request (nó n8n):
Função: Busca metadados detalhados do commit, incluindo patches de arquivos, usando expressões dinâmicas que referenciam o ID do commit fornecido pelos dados do gatilho do n8n.
Configuração Chave: Usa o tipo de credencial OAuth2 do GitHub para acesso seguro à API. O URL é gerado dinamicamente para solicitar dados do commit: =https://api.github.com/repos/{{ $json.body.repository.owner.name }}/.../commits/{{ $json.body.head_commit.id }}.
Code (Nó Formatador n8n):
Função: Transforma os dados brutos do commit do GitHub (diffs) em HTML estilizado e com codificação de cores para excelente visualização por e-mail. Ele separa linhas adicionadas (+, verde) e linhas removidas (-, vermelho).
Configuração Chave: Contém lógica JavaScript personalizada (formatPatch e renderResponse) para estruturar metadados (informações do repositório, autor, mensagem) e diferenças de código.
Groq Chat Model (nó n8n):
Função: Fornece o backend LLM para o Agente de IA, utilizando o modelo rápido llama-3.1-8b-instant para geração rápida de revisão de código.
Configuração Chave: Requer uma credencial de API Groq.
AI Agent (nó n8n):
Função: Atua como a inteligência central. Ele recebe o diff de código formatado em HTML como entrada e gera uma revisão de código rigorosa e estruturada com base nas instruções detalhadas do prompt.
Configuração Chave: O prompt do sistema força a IA a verificar preocupações funcionais, de estilo, de segurança e a sugerir melhorias, e crucialmente, a retornar suas descobertas em um de dois blocos HTML predefinidos.
Gmail (nó n8n):
Função: Envia a saída HTML final e combinada (detalhes do commit + revisão da IA) como uma notificação por e-mail.
Configuração Chave: O Subject (Assunto) é definido como 'Code Review'. A Message (Mensagem) usa a saída HTML final do nó Output Parser do n8n.