Hướng dẫn kết nối n8n với Hermes Agent tạo quy trình tự động

Để kết nối n8n với Hermes Agent, bạn có thể kích hoạt API Server của Hermes Agent, sau đó sử dụng node HTTP Request trong n8n để gửi yêu cầu xử lý. Khi hai hệ thống đã liên kết, n8n có thể tự động kích hoạt AI Agent theo lịch, chuyển dữ liệu cần phân tích và tiếp nhận kết quả để sử dụng trong các bước tiếp theo. Theo dõi bài viết để biết cách thực hiện nhé!

n8n và Hermes Agent kết nối với nhau như thế nào?

n8n và Hermes Agent có thể giao tiếp thông qua API. Trong đó, n8n đảm nhiệm việc điều phối quy trình, còn Hermes Agent tiếp nhận yêu cầu và thực hiện những tác vụ AI được giao.

Cụ thể:

• n8n: Tự động kích hoạt workflow, thu thập dữ liệu, kết nối các ứng dụng và xử lý kết quả.
• Hermes Agent: Tiếp nhận yêu cầu, sử dụng mô hình AI và những công cụ đã được cấu hình để xử lý công việc.
• API Server: Cung cấp giao diện giao tiếp HTTP để hai hệ thống trao đổi dữ liệu.

Hermes Agent hỗ trợ API tương thích với chuẩn OpenAI, bao gồm endpoint /v1/chat/completions. Nhờ vậy, n8n có thể gửi yêu cầu bằng HTTP Request thông thường.

Quy trình xử lý cơ bản:

n8n kích hoạt workflow → HTTP Request gửi yêu cầu → Hermes Agent xử lý → Trả kết quả về n8n → Thực hiện bước tiếp theo.

Ví dụ, bạn có thể thiết lập một quy trình tự động tạo ý tưởng bài viết mỗi sáng:

1. Đến 8 giờ, n8n tự động khởi chạy workflow.
2. n8n gửi yêu cầu đề xuất ý tưởng nội dung đến Hermes Agent.
3. Hermes Agent sử dụng mô hình AI đã cấu hình để tạo danh sách ý tưởng.
4. Kết quả được trả về n8n để lưu trữ hoặc gửi qua Telegram.

Bên cạnh API Server, Hermes Agent còn hỗ trợ Webhook để tiếp nhận sự kiện từ dịch vụ bên ngoài. Tuy nhiên, hướng dẫn dưới đây ưu tiên HTTP Request kết hợp API Server vì dễ kiểm tra đầu vào, đầu ra và phù hợp với những workflow cần lấy kết quả AI về n8n.

Cần chuẩn bị gì trước khi kết nối?

Trước khi thực hiện, bạn cần chuẩn bị:

• n8n: Đã cài đặt và có thể truy cập giao diện quản lý workflow.
• Hermes Agent: Đã cài đặt trên máy chủ hoặc VPS, có quyền cấu hình API Server.
• Mô hình AI: Hermes Agent đã được cấu hình nhà cung cấp mô hình AI và thông tin xác thực hợp lệ.
• Quyền quản trị: Có thể chỉnh sửa cấu hình Hermes Agent và khởi động lại Gateway.
• Kết nối mạng: n8n phải truy cập được địa chỉ API của Hermes Agent.

Bạn có thể triển khai n8n và Hermes Agent trên cùng một VPS hoặc hai VPS riêng biệt.

Trong hướng dẫn này, phần cấu hình Hermes Agent áp dụng cho bản cài đặt trực tiếp trên Linux theo tài liệu chính thức của dự án. Nếu sử dụng bản đóng gói bằng Docker hoặc VPS cài sẵn từ nhà cung cấp, đường dẫn cấu hình và cách khởi động dịch vụ có thể khác.

Hướng dẫn kết nối n8n với Hermes Agent để tạo quy trình tự động

Hướng dẫn dưới đây sử dụng hai VPS đã cài sẵn n8n và Hermes Agent. Chúng ta sẽ kết nối hai máy chủ này qua Tailscale, bật API Server trên Hermes Agent rồi tạo một workflow tự động trên n8n.

Trước khi bắt đầu, hãy hảm bảo Hermes Agent đã được cấu hình mô hình AI có thể hoạt động và bạn có quyền SSH vào cả hai VPS.

Bước 1: Kết nối hai VPS bằng Tailscale

Đầu tiên, sử dụng Xshell để SSH vào từng VPS. Trên cả VPS n8n và VPS Hermes Agent, chạy lần lượt:

curl -fsSL https://tailscale.com/install.sh | sh

sudo tailscale up

Terminal sẽ hiển thị đường dẫn đăng nhập Tailscale. Mở đường dẫn và xác thực cả hai VPS vào cùng một mạng Tailscale.

Sau khi hoàn tất, trên VPS Hermes Agent, chạy:

tailscale ip -4

Hệ thống sẽ hiển thị một địa chỉ IP riêng có dạng 100.x.x.x.

Hãy sao chép địa chỉ IP này để sử dụng trong những bước tiếp theo.

Bước 2: Kích hoạt API Server trên Hermes Agent

Trên VPS Hermes Agent, trước tiên cài đặt Nano (nếu chưa có):

sudo apt update && sudo apt install nano -y

Tiếp theo, mở tệp cấu hình môi trường của Hermes Agent:

nano ~/.hermes/.env

Tìm các biến API_SERVER_* đã tồn tại và chỉnh sửa, hoặc thêm những dòng sau nếu chưa có:

API_SERVER_ENABLED=true

API_SERVER_HOST=100.x.x.x

API_SERVER_PORT=8642

API_SERVER_KEY=THAY_BANG_API_KEY_CUA_BAN

Trong đó:

• API_SERVER_ENABLED=true: Kích hoạt API Server.
• API_SERVER_HOST: Thay bằng IP Tailscale thực tế của VPS Hermes Agent.
• API_SERVER_PORT=8642: Cổng API mặc định.
• API_SERVER_KEY: Khóa bảo mật dùng để xác thực yêu cầu từ n8n.

Để tạo API Key ngẫu nhiên, bạn có thể mở một phiên SSH khác và chạy:

openssl rand -hex 32

Sao chép kết quả vào dòng API_SERVER_KEY.

Sau khi chỉnh sửa, nhấn:

• Ctrl + O → Enter để lưu.
• Ctrl + X để thoát Nano.

Giới hạn quyền truy cập tệp cấu hình:

chmod 600 ~/.hermes/.env

Cuối cùng, khởi động lại Hermes Gateway:

hermes gateway restart

Lưu ý: Các lệnh cần được chạy bằng đúng tài khoản Linux vận hành Hermes Agent. Với VPS cài sẵn có hệ thống quản lý Gateway riêng, cần bảo đảm tệp .env vừa chỉnh sửa được dịch vụ đang chạy sử dụng.

Bước 3: Kiểm tra kết nối giữa n8n và Hermes Agent

Trên VPS Hermes Agent, chạy:

curl http://100.x.x.x:8642/health

Thay 100.x.x.x bằng IP Tailscale thực tế đã lấy ở Bước 1.

Nếu API Server hoạt động, phản hồi sẽ chứa:

{"status":"ok"}

Tiếp theo, SSH vào VPS n8n và chạy lại lệnh kiểm tra tương tự:

curl http://100.x.x.x:8642/health

Nếu nhận được trạng thái ok, VPS n8n đã truy cập được API Server của Hermes Agent.

Đến đây, phần thiết lập kết nối giữa hai VPS đã hoàn tất. Tiếp theo, chúng ta sẽ tạo một workflow thực tế để kiểm tra khả năng xử lý AI.

Ví dụ: Tự động tạo ý tưởng bài viết mỗi sáng bằng n8n và Hermes Agent

Trong ví dụ này, n8n sẽ tự động gửi yêu cầu đến Hermes Agent vào 8 giờ sáng mỗi ngày. Hermes Agent tiếp nhận yêu cầu, tạo 3 ý tưởng bài viết về công nghệ và trả kết quả về n8n.

Quy trình gồm hai node chính:

Schedule Trigger → HTTP Request (Hermes Agent)

Tạo workflow mới trên n8n

Truy cập giao diện quản lý n8n và thực hiện:

1. Tạo một workflow mới.
2. Đặt tên: AI Content Ideas – Hermes Agent.
3. Nhấn dấu + và tìm node Schedule Trigger.

Trong Schedule Trigger, cấu hình:

Lưu ý: Trong Workflow Settings, nên đặt Timezone thành Asia/Ho_Chi_Minh để lịch chạy theo giờ Việt Nam.

Sau đó, thêm node HTTP Request và kết nối phía sau Schedule Trigger.

Cấu hình HTTP Request gửi yêu cầu đến Hermes Agent

Mở node HTTP Request và thiết lập:

Thay 100.x.x.x trong URL bằng IP Tailscale của VPS Hermes Agent.

Thiết lập API Key:

Tại mục Authentication:

1. Chọn Generic Credential Type → Bearer Auth.
2. Nhấn tạo Credential mới.
3. Nhập API Key đã tạo ở Bước 2 vào trường Bearer Token.
4. Lưu Credential.

Thiết lập nội dung yêu cầu AI:

Trong phần JSON Body, giữ chế độ Fixed, sau đó dán:

{
  "model": "hermes-agent",
  "stream": false,
  "messages": [
    {
      "role": "user",
      "content": "Hãy đề xuất 3 ý tưởng bài viết về AI Agent và VPS. Mỗi ý tưởng gồm tiêu đề và mô tả ngắn gọn. Trả lời bằng tiếng Việt."
    }
  ]
}

Trong đó:

• model: Model alias của Hermes Agent API Server, mặc định thường là hermes-agent.
• stream: false: Nhận nội dung trả lời hoàn chỉnh.
• content: Yêu cầu mà bạn muốn Hermes Agent thực hiện.

Nếu Hermes Agent sử dụng model alias khác, cần thay giá trị model theo kết quả từ endpoint /v1/models.

Chạy thử và kích hoạt workflow

Sau khi cấu hình xong, nhấn Execute Workflow để chạy thử.

Nếu thành công, node HTTP Request sẽ nhận được phản hồi từ Hermes Agent. Mở phần Output để kiểm tra kết quả.

Đây chỉ là kết quả minh họa, không phải kết quả thực thi đã được kiểm chứng.

Cuối cùng, lưu và nhấn Publish để kích hoạt lịch chạy tự động.

Từ thời điểm này, n8n sẽ tự động gửi yêu cầu tạo ý tưởng bài viết đến Hermes Agent mỗi ngày. Bạn có thể xem kết quả tại mục Executions nếu lịch sử thực thi được bật.

Các lỗi thường gặp khi kết nối n8n với Hermes Agent

Trong quá trình kết nối, một số lỗi có thể xuất hiện do cấu hình API, kết nối mạng hoặc thông tin xác thực chưa chính xác.

Nếu VPS n8n truy cập được API nhưng HTTP Request vẫn thất bại, hãy kiểm tra cấu hình mạng Docker và quyền kết nối từ container n8n đến IP Tailscale.

Có thể ứng dụng n8n kết hợp Hermes Agent vào những công việc nào?

Ngoài ví dụ tạo ý tưởng bài viết, bạn có thể kết hợp n8n và Hermes Agent để tự động hóa nhiều công việc khác như:

• Tạo nội dung marketing: Tự động đề xuất ý tưởng blog, bài Facebook hoặc nội dung email theo lịch.
• Phân tích dữ liệu: Thu thập thông tin từ Google Sheets, chuyển đến Hermes Agent để phân tích và tóm tắt.
• Báo cáo định kỳ: Tổng hợp dữ liệu từ các nguồn đã kết nối và tạo báo cáo hằng ngày.
• Chăm sóc khách hàng: Phân loại yêu cầu, tóm tắt nội dung và đề xuất phương án phản hồi.
• Theo dõi website: Phân tích dữ liệu hoạt động và gửi thông báo khi phát hiện những vấn đề cần chú ý.

Khả năng triển khai phụ thuộc vào các dịch vụ đã kết nối với n8n, công cụ được cấp quyền cho Hermes Agent và mô hình AI đang sử dụng.

Những lưu ý khi sử dụng n8n với Hermes Agent

Để quy trình hoạt động ổn định và an toàn, bạn nên chú ý:

• Bảo mật API Key: Không chia sẻ khóa bảo mật hoặc đưa trực tiếp vào workflow công khai.
• Kiểm soát quyền truy cập: Chỉ cấp cho Hermes Agent những quyền thực sự cần thiết.
• Giới hạn tần suất: Tránh kích hoạt quá nhiều workflow cùng lúc, đặc biệt với những tác vụ AI phức tạp.
• Theo dõi chi phí: Kiểm tra mức sử dụng API của mô hình AI để tránh phát sinh chi phí ngoài dự kiến.
• Kiểm tra kết quả: Không tự động thực hiện các hành động quan trọng chỉ dựa trên nội dung AI tạo ra mà chưa có bước xác minh.

Kết luận

Kết nối n8n với Hermes Agent giúp kết hợp khả năng điều phối workflow của n8n với khả năng xử lý công việc bằng AI của Hermes Agent. Thông qua API Server và HTTP Request, bạn có thể xây dựng quy trình tự động mà không cần phát triển ứng dụng tích hợp riêng.

Nếu muốn triển khai nhanh trên VPS, bạn có thể tham khảo VPS n8n và VPS Hermes Agent tại Tino. Các giải pháp cài sẵn giúp giảm bớt thao tác thiết lập ban đầu, phù hợp với người mới tiếp cận tự động hóa bằng AI.

Những câu hỏi thường gặp