Xây dựng workflow n8n thay đổi mã với phê duyệt của con người và xác minh bằng kiểm thử

Tổng quan workflow

Sử dụng n8n để AI agent đề xuất thay đổi repository, nhưng đặt thao tác ghi sau bước phê duyệt của con người. Sau khi thao tác ghi được phê duyệt, hãy chạy kiểm thử trên chính commit tạo ra và báo cáo kết quả. Việc merge hoặc triển khai cần là một quyết định riêng.

Điểm khác biệt then chốt là phê duyệt công cụ so với phê duyệt đầu ra. Trong n8n, bước kiểm duyệt của con người có thể tạm dừng AI Agent trước khi công cụ được chọn thực thi. Người kiểm duyệt thấy công cụ được đề xuất và các tham số của nó; phê duyệt sẽ thực thi lệnh gọi đó, còn từ chối sẽ hủy lệnh gọi và thông báo cho agent. Hành vi này được mô tả trong hướng dẫn human-in-the-loop của n8n.

OneMux cung cấp quyền truy cập các mô hình AI qua một API tương thích OpenAI. Đây là một phương án truy cập mô hình cho thiết kế này, không phải tích hợp n8n đã được xác minh. Hãy đối chiếu tài liệu API OneMux và cấu hình node n8n với endpoint và các tham số bạn dự định sử dụng.

Những gì cần chuẩn bị trước khi xây dựng

• Một phiên bản n8n có AI Agent, kết nối mô hình chat phù hợp và quyền truy cập vào kênh kiểm duyệt của con người như Slack hoặc n8n Chat.
• Một tích hợp repository hoặc dịch vụ tùy chỉnh có thể đọc revision được chỉ định và áp dụng bản vá lên nhánh không phải production. Chỉ cấp cho thông tin xác thực dùng để ghi quyền truy cập cần thiết đối với repository và nhánh đó.
• Một test runner được cô lập khỏi thông tin xác thực và hệ thống production. Runner phải nhận mã định danh commit chính xác và trả về trạng thái cùng đường dẫn hoặc thông tin tham chiếu đến kết quả.
• Tài khoản OneMux và quyền truy cập API nếu bạn chọn OneMux để gọi mô hình. Tham khảo hướng dẫn bắt đầu nhanh để biết thông tin kết nối hiện tại và danh mục mô hình khi chọn mô hình có sẵn.
• Một repository có lệnh kiểm thử đã xác định, nhánh mặc định được bảo vệ và người được ủy quyền kiểm duyệt các thay đổi đề xuất.

Đây là một mẫu triển khai, không phải workflow có thể nhập trực tiếp. Công cụ repository, tích hợp runner, lựa chọn mô hình và các trường n8n cụ thể phụ thuộc vào môi trường của bạn. Cụ thể, tài liệu được cung cấp không xác lập rằng một mô hình OneMux cụ thể hỗ trợ cách gọi công cụ mà n8n AI Agent yêu cầu. Hãy xác minh khả năng hỗ trợ đó trước khi dựa vào thiết kế này.

Thiết kế workflow dựa trên revision chính xác

Một trình tự thực tế gồm:

1. Tiếp nhận yêu cầu. Lấy repository, mô tả vấn đề, nhánh làm việc đích, commit cơ sở và lệnh kiểm thử được phép từ cấu hình workflow đáng tin cậy.
2. Đọc và đề xuất. Cho phép agent xem các tệp liên quan tại commit cơ sở và chuẩn bị bản vá. Quyền đọc không được cho phép sửa đổi repository.
3. Kiểm duyệt thao tác ghi. Đưa công cụ áp dụng bản vá qua bước kiểm duyệt của con người trong n8n. Người kiểm duyệt phê duyệt hoặc từ chối lệnh gọi công cụ được đề xuất.
4. Áp dụng và xác định commit. Nếu được phê duyệt, dịch vụ ghi kiểm tra nhánh vẫn trỏ đến commit cơ sở đã được duyệt, áp dụng bản vá đã được duyệt và trả về ID commit mới. Nếu cơ sở đã thay đổi, hãy dừng theo hướng an toàn và yêu cầu đề xuất cùng phê duyệt mới.
5. Xác minh. Chạy các bài kiểm thử đã cấu hình trên chính commit mới đó trong runner cô lập. Ghi lại lệnh, commit, trạng thái và thông tin tham chiếu kết quả.
6. Báo cáo. Gửi commit và kết quả kiểm thử cho người kiểm duyệt và người yêu cầu. Kết quả kiểm thử thất bại, bị hủy hoặc bị thiếu không được coi là đạt.

Đây là các biện pháp kiểm soát được khuyến nghị, không phải tính năng được bước kiểm duyệt của con người trong n8n bảo đảm. Đặc biệt, dịch vụ repository của bạn phải thực thi việc kiểm tra commit cơ sở và bảo đảm bản vá được áp dụng chính là bản vá đã được duyệt.

Cấu hình kết nối mô hình

Trong n8n, hãy chọn cấu hình mô hình chat hỗ trợ endpoint tương thích OpenAI có thể tùy chỉnh và cách gọi công cụ mà AI Agent cần. Sử dụng endpoint, phương thức xác thực và mã định danh mô hình được nêu trong tài liệu OneMux hiện tại. Lưu thông tin xác thực trong hệ thống quản lý thông tin xác thực của n8n, thay vì trong prompt hoặc tin nhắn workflow.

Trước khi kết nối quyền truy cập repository, hãy gửi một yêu cầu thử nghiệm nhỏ và kiểm tra phản hồi có đúng định dạng mà node n8n mong đợi hay không. Sau đó thử một lệnh gọi công cụ vô hại. Tương thích OpenAI không có nghĩa là mọi endpoint, tham số hoặc định dạng gọi công cụ đều có thể thay thế cho nhau: khả năng tương thích ở đây phụ thuộc vào việc cả hai phía đều hỗ trợ các yêu cầu và phản hồi cần thiết. Cấu hình này chưa được kiểm thử cho bài viết.

Nếu kết nối mô hình hiện có không hỗ trợ các lệnh gọi công cụ của agent, đừng bỏ qua bước phê duyệt bằng cách cấp trực tiếp thông tin xác thực có quyền ghi cho mô hình. Hãy sử dụng cấu hình tương thích hoặc xây dựng một bước chuyển giao riêng đến dịch vụ ghi với quy trình kiểm duyệt rõ ràng.

Thêm bước phê duyệt của con người cho thao tác ghi repository

Trong node AI Agent, mở đầu nối Tools và tìm Human review trong Tools Panel. Chọn kênh phê duyệt và cấu hình thông tin xác thực cho kênh đó. Kết nối công cụ ghi repository với đầu nối công cụ của bước kiểm duyệt. Khi phù hợp, hãy tách riêng các công cụ chỉ đọc và đặt mọi công cụ khác có thể thay đổi trạng thái bên ngoài sau bước kiểm duyệt riêng hoặc biện pháp kiểm soát tương đương.

Theo tài liệu n8n, người kiểm duyệt có thể nhận được tên công cụ và các tham số do AI cung cấp. Ví dụ, hãy cấu hình thông điệp kiểm duyệt với:

Proposed tool: {{ $tool.name }}
Proposed parameters:
{{ JSON.stringify($tool.parameters, null, 2) }}

Sử dụng công cụ ghi có đầu vào cho phép kiểm duyệt bao gồm repository, nhánh, commit cơ sở và bản vá đầy đủ hoặc tham chiếu bất biến đến bản vá kèm digest. Nếu bản vá quá lớn đối với kênh, hãy cung cấp một vị trí kiểm duyệt an toàn, có thể truy cập và xác minh rằng dịch vụ ghi áp dụng đúng nội dung đó. Một chỉ dẫn mơ hồ như “sửa các bài kiểm thử” không đủ để phê duyệt một thay đổi repository cụ thể.

Các giá trị $tool.parameters được tài liệu mô tả bao gồm những trường được cấu hình bằng biểu thức $fromAI(); đừng cho rằng thông điệp hiển thị mọi thông tin xác thực cố định, giá trị cấu hình ẩn hoặc tác động ở các bước sau. Hãy giới hạn các thiết lập cố định và cung cấp cho người kiểm duyệt một cách riêng để xem xét chúng. Tránh đưa thông tin bí mật vào tham số công cụ vì các tham số có thể xuất hiện trong thông điệp phê duyệt.

Thêm một chỉ dẫn hệ thống nêu tên công cụ được kiểm soát và cho agent biết phải làm gì khi bị từ chối. Ví dụ:

Repository writes require human approval. Propose a patch against the
specified base commit and request the write tool only for that patch.
If approval is denied, do not retry the write or use another tool to make
the change. Tell the requester it was denied and ask for clarification.
Report test results only when supplied by the test runner.

Chỉ dẫn này giúp agent xử lý việc kiểm duyệt; nó không phải là ranh giới bảo mật. Hãy thực thi quyền và các hạn chế đối với nhánh bên ngoài prompt.

Xác minh thay đổi đã được phê duyệt

Chỉ kích hoạt test runner sau khi dịch vụ ghi trả về ID commit. Cấu hình runner checkout đúng ID đó, không phải đầu nhánh mới nhất, và thực thi một lệnh trong danh sách cho phép do nhóm của bạn xác định. Với repository mà người bảo trì đã chọn lệnh này, một ví dụ có thể là:

npm test

Lệnh đó chỉ mang tính minh họa; hãy sử dụng hướng dẫn kiểm thử thực tế của dự án. Coi mã repository, script cài đặt dependency và đầu ra kiểm thử là không đáng tin cậy. Chạy chúng với quyền truy cập mạng và hệ thống tệp bị hạn chế, không có thông tin bí mật của production, đồng thời giới hạn thời gian và tài nguyên. Một bộ kiểm thử chạy đạt chỉ cho thấy các bước kiểm tra được chọn đã đạt trong môi trường đó; điều này không chứng minh thay đổi an toàn hoặc chính xác.

Trả về kết quả ngắn gọn gồm cơ sở đã được duyệt, commit mới, lệnh kiểm thử, trạng thái đạt/không đạt và liên kết đến log. Nếu kiểm thử thất bại, agent có thể đề xuất bản vá đã chỉnh sửa, nhưng thao tác ghi tiếp theo cần được phê duyệt riêng. Không tự động merge chỉ vì người kiểm duyệt đã phê duyệt lệnh gọi công cụ trước đó.

Xử lý sự cố và giới hạn vận hành

Yêu cầu phê duyệt thiếu ngữ cảnh hữu ích

Kiểm tra những đầu vào nào do AI cung cấp và hiển thị trong $tool.parameters. Đưa thông tin nhận diện bản vá, nhánh và revision cơ sở vào đầu vào công cụ có thể kiểm duyệt hoặc cung cấp một tài liệu kiểm duyệt bất biến, an toàn. Nếu người kiểm duyệt không thể xác định chính xác thao tác ghi, hãy từ chối.

Agent không thể gọi công cụ

Trước tiên, hãy thử một công cụ vô hại độc lập với quyền repository. Đối chiếu node n8n, endpoint OneMux, mô hình đã chọn và các tham số gọi công cụ cần thiết với tài liệu hiện tại của chúng. Các nguồn được cung cấp không xác minh một tổ hợp mô hình và node cụ thể.

Nhánh đã thay đổi hoặc kiểm thử chưa hoàn tất

Từ chối thao tác ghi dựa trên cơ sở đã cũ thay vì áp dụng bản vá lên một cơ sở khác. Nếu hết thời gian, runner gặp lỗi hoặc thiếu log, hãy báo cáo việc xác minh chưa hoàn tất. Chạy lại trên cùng commit khi phù hợp; yêu cầu phê duyệt mới nếu thao tác ghi được đề xuất thay đổi.

Kết luận

Ranh giới hữu ích ở đây có phạm vi hẹp: một người phê duyệt thao tác ghi repository cụ thể, còn runner cô lập xác minh commit tạo ra. n8n cung cấp quy trình tạm dừng và phê duyệt ở cấp công cụ như được mô tả trong tài liệu; dịch vụ repository, runner, quyền truy cập và quy trình kiểm duyệt của bạn cung cấp các biện pháp bảo vệ còn lại. Chỉ sử dụng OneMux làm lớp truy cập mô hình sau khi xác nhận endpoint và các tham số đã chọn hoạt động với cấu hình n8n của bạn.

Nguồn

• n8n: Human-in-the-loop for tools — hành vi phê duyệt công cụ, cách thiết lập, các kênh kiểm duyệt và biến trong thông điệp kiểm duyệt.
• Tài liệu OneMux — tham khảo để biết thông tin kết nối API hiện tại.