Trình gửi Email Đánh giá Mã nguồn Commit GitHub Tích hợp AI - Quy trình làm việc n8n

Văn bản định dạng Markdown:
Các Nhóm Phát triển Phần mềm cần phản hồi ngay lập tức về các commit mới.
Các Kỹ sư DevOps muốn tích hợp các cổng kiểm soát chất lượng tự động vào đường ống CI/CD của họ bằng n8n.
Người dùng n8n cần một ví dụ nâng cao về việc kết hợp webhook, mã tùy chỉnh và các mô hình ngôn ngữ lớn.
Các trưởng nhóm kỹ thuật muốn giám sát chất lượng mã nguồn trên nhiều kho lưu trữ bằng một luồng công việc n8n duy nhất.

Đánh giá mã nguồn thủ công có thể tốn thời gian và dễ xảy ra lỗi của con người. Luồng công việc n8n này giải quyết vấn đề bằng cách tạo ra một vòng lặp phản hồi chất lượng mã nguồn theo thời gian thực, do AI điều khiển. Khi nhà phát triển đẩy mã lên một kho lưu trữ GitHub được giám sát, trình kích hoạt n8n sẽ kích hoạt tự động hóa ngay lập tức. Luồng công việc sẽ truy xuất chi tiết commit đầy đủ và chuyển bản diff code đã được định dạng cho một Tác nhân AI thông minh sử dụng Groq. Tác nhân này phân tích các vấn đề về chức năng, phong cách, các lỗ hổng bảo mật tiềm ẩn và đề xuất các cải tiến, trả về một bản tóm tắt HTML có cấu trúc. Toàn bộ quá trình này, được quản lý bởi các node n8n khác nhau, đảm bảo phản hồi mã nguồn nhanh chóng, nhất quán được gửi thẳng đến hộp thư của người đánh giá qua Gmail, làm cho đây trở thành một trong những mẫu n8n hữu ích nhất cho các nhóm hiện đại.

Luồng công việc n8n mạnh mẽ này bắt đầu thực thi bằng node Kích hoạt Github (Github Trigger n8n node). Kích hoạt n8n này được cấu hình để lắng nghe các sự kiện 'push' trên một kho lưu trữ cụ thể.

1. Kích hoạt & Phân tích Dữ liệu: Khi xảy ra một lần đẩy (push), Kích hoạt Github sẽ nắm bắt dữ liệu tải (payload). Node Parser n8n tiếp theo sẽ trích xuất siêu dữ liệu cần thiết (tên repo, chủ sở hữu, ID commit).


2. Truy xuất Chi tiết Commit: Một node Yêu cầu HTTP (HTTP Request n8n node) sau đó sử dụng ID commit để gọi API GitHub, lấy thông tin chi tiết commit, bao gồm cả dữ liệu vá/diff quan trọng.


3. Định dạng HTML (Node Code): Một node Code n8n chuyên dụng lấy dữ liệu commit thô và chuyển đổi nó thành đầu ra HTML được tạo kiểu tốt. Điều này bao gồm việc tô màu bản diff code (màu xanh lá cho các dòng thêm vào, màu đỏ cho các dòng bị xóa) để tối ưu hóa khả năng đọc trong ứng dụng email.


4. Phân tích AI (Node Tác nhân AI): Node Tác nhân AI (AI Agent n8n node) nhận HTML được định dạng này. Nó được hướng dẫn thông qua một lời nhắc hệ thống (system prompt) nghiêm ngặt để hoạt động như một người đánh giá mã nguồn chuyên gia, tập trung vào các mối quan tâm về chức năng, phong cách và bảo mật. Nó sử dụng Mô hình Trò chuyện Groq và node Bộ nhớ Đơn giản (Simple Memory n8n node) để xử lý, mặc dù bộ nhớ là tùy chọn cho việc đánh giá một lần.


5. Kết hợp Đầu ra: Một node Code Parser Đầu ra (Output Parser Code n8n node) hợp nhất các chi tiết commit gốc (từ node Code đầu tiên) và bản tóm tắt HTML nghiêm ngặt do Tác nhân AI tạo ra.


6. Thông báo Cuối cùng: Đầu ra HTML hoàn chỉnh được gửi qua node Gmail n8n đến người nhận được chỉ định (người đánh giá hoặc nhóm phát triển), hoàn tất luồng công việc n8n tự động. Luồng sau đó kết thúc bằng node Kết thúc Luồng công việc (End Workflow n8n node).

Văn bản định dạng Markdown:

1. Nhập mẫu n8n: Sao chép JSON được cung cấp và dán vào phiên bản n8n của bạn bằng cách sử dụng menu 'Mới' -> 'Nhập từ JSON'.


2. Thông tin xác thực GitHub: Thiết lập thông tin xác thực cho node Kích hoạt Github n8n và node Yêu cầu HTTP n8n.


3. Thiết lập Groq: Cấu hình node Mô hình Trò chuyện Groq n8n với khóa API Groq của bạn.


4. Cấu hình Kích hoạt Github: Tùy chỉnh URL kho lưu trữ và chi tiết chủ sở hữu trong node Kích hoạt Github n8n để giám sát dự án mục tiêu của bạn. Đảm bảo webhook được thiết lập chính xác trong cài đặt kho lưu trữ GitHub của bạn để trỏ đến URL kích hoạt n8n.


5. Thiết lập Gmail: Cấu hình node Gmail n8n với thông tin xác thực OAuth2 của bạn. Cập nhật tham số sendTo thành địa chỉ email của người đánh giá mong muốn.


6. Kích hoạt: Lưu và kích hoạt luồng công việc n8n. Nó sẽ tự động chạy khi có bất kỳ sự kiện đẩy (push) nào.

Văn bản định dạng Markdown:
Kích hoạt Github (n8n trigger):
Chức năng: Khởi động luồng công việc n8n khi có sự kiện 'push' tới một kho lưu trữ GitHub cụ thể.
Cấu hình chính: Sự kiện được đặt là push. Chi tiết kho lưu trữ phải được cập nhật thủ công để phù hợp với dự án của bạn.
Yêu cầu HTTP (n8n node):
Chức năng: Truy xuất siêu dữ liệu commit chi tiết, bao gồm các bản vá tệp, bằng cách sử dụng các biểu thức động tham chiếu đến ID commit được cung cấp bởi dữ liệu kích hoạt n8n.
Cấu hình chính: Sử dụng loại thông tin xác thực OAuth2 của GitHub để truy cập API an toàn. URL được tạo động để yêu cầu dữ liệu commit: =https://api.github.com/repos/{{ $json.body.repository.owner.name }}/.../commits/{{ $json.body.head_commit.id }}.
Code (node Định dạng n8n):
Chức năng: Chuyển đổi dữ liệu commit GitHub thô (diffs) thành HTML được tô màu, tạo kiểu tốt để hiển thị qua email xuất sắc. Nó tách các dòng được thêm (+, màu xanh lá) và các dòng bị xóa (-, màu đỏ).
Cấu hình chính: Chứa logic JavaScript tùy chỉnh (formatPatch và renderResponse) để cấu trúc siêu dữ liệu (thông tin repo, tác giả, thông báo) và các bản diff code.
Mô hình Trò chuyện Groq (n8n node):
Chức năng: Cung cấp backend LLM cho Tác nhân AI, sử dụng mô hình llama-3.1-8b-instant nhanh chóng để tạo đánh giá mã nguồn nhanh.
Cấu hình chính: Yêu cầu thông tin xác thực API Groq.
Tác nhân AI (n8n node):
Chức năng: Đóng vai trò là trí tuệ cốt lõi. Nó nhận đầu vào là bản diff code được định dạng HTML và tạo ra một đánh giá mã nguồn nghiêm ngặt, có cấu trúc dựa trên các hướng dẫn nhắc nhở chi tiết.
Cấu hình chính: Lời nhắc hệ thống buộc AI phải kiểm tra các mối quan tâm về chức năng, phong cách, bảo mật và đề xuất các cải tiến, và quan trọng nhất, trả về kết quả của nó trong một trong hai khối HTML được xác định trước.
Gmail (n8n node):
Chức năng: Gửi đầu ra HTML cuối cùng, được kết hợp (chi tiết commit + đánh giá của AI) dưới dạng thông báo email.
Cấu hình chính: Chủ đề được đặt thành 'Đánh giá Mã nguồn'. Tin nhắn sử dụng đầu ra HTML cuối cùng từ node Parser Đầu ra n8n.