Hermes Agent

Hermes Agent là tác tử chạy trong terminal, có thể đọc và ghi tệp, thực thi lệnh và gọi công cụ sau khi được người dùng cấp quyền.

Hướng dẫn này dùng Custom Endpoint tích hợp của Hermes Agent để kết nối API Chat Completions của AGTCloud và kiểm tra hội thoại cơ bản, không cần công cụ cấu hình khác. Thao tác tệp, tìm kiếm web, MCP, Skills và khả năng mở rộng khác nằm ngoài phạm vi kiểm tra của hướng dẫn.

Chuẩn bị

Trước khi bắt đầu, hãy đảm bảo bạn đã:

• Chuẩn bị hệ điều hành và môi trường terminal được Hermes Agent hỗ trợ;
• Đăng ký và đăng nhập AGTCloud;
• Tạo AGTCloud API Key trên trang API Keys;
• Sao chép ID mô hình mà API Key hiện tại nhìn thấy và hỗ trợ Chat Completions từ danh mục mô hình;
• Chuẩn bị thư mục thử nghiệm không chứa mã nhạy cảm hoặc thông tin xác thực của môi trường production.

Cài đặt Hermes Agent

Chọn phương thức cài đặt chính thức phù hợp với môi trường. Bản macOS đầu tiên hỗ trợ Apple Silicon; Intel Mac, Homebrew và cài đặt qua PyPI không nằm trong phạm vi hỗ trợ chính thức hiện tại.

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Sau khi cài đặt, mở lại terminal và kiểm tra phiên bản cùng môi trường chạy:

hermes version
hermes doctor

hermes doctor kiểm tra cài đặt, cấu hình và vấn đề môi trường thường gặp. Nếu không tìm thấy hermes, mở lại terminal trước, rồi xác nhận thư mục cài đặt nằm trong PATH. Xem thông tin hỗ trợ nền tảng chính thức của Hermes Agent để biết giới hạn khác.

Cấu hình AGTCloud

Hermes Agent có trình hướng dẫn cấu hình nhà cung cấp mô hình. Chạy lệnh sau trong terminal thông thường, không chạy trong hội thoại Hermes đang mở:

hermes model

Kiểm tra cấu hình

Sau khi hoàn tất trình hướng dẫn, kiểm tra thiết lập hiện tại bằng các lệnh sau:

hermes config
hermes config get model
hermes config check

• hermes config mở hoặc hiển thị mục cấu hình hiện tại;
• hermes config get model kiểm tra thiết lập mô hình hiện tại;
• hermes config check kiểm tra định dạng cấu hình và trường cần thiết.

Không sao chép hoặc chia sẻ API Key đầy đủ khi xem đầu ra. Nếu cấu hình vẫn trỏ đến Provider khác, chạy lại hermes model và hoàn tất Custom Endpoint.

Khởi chạy và kiểm tra kết nối

cd /path/to/safe/test-project

hermes

Chỉ trả lời: Kết nối AGTCloud thành công. Không gọi bất kỳ công cụ nào.

Chỉ đọc README.md và tóm tắt mục đích dự án thành ba ý. Không sửa tệp hoặc chạy lệnh khác.

Chuyển mô hình

Khi cần thêm mô hình, sửa Endpoint hoặc đổi API Key, thoát phiên hiện tại rồi chạy:

hermes model

Trong phiên đang mở, dùng /model để chuyển giữa Provider và mô hình đã cấu hình. /model không tạo Custom Endpoint mới; nếu mô hình đích chưa được cấu hình, dùng lệnh terminal hermes model trước.

MODEL_ID chỉ là giá trị giữ chỗ. Luôn dùng ID mô hình đầy đủ mà API Key hiện tại nhìn thấy trong danh mục mô hình, không dựa vào mô hình gợi ý cố định có thể thay đổi theo phiên bản.

Câu hỏi thường gặp

Nếu chưa xác định được vấn đề, chạy hermes doctor và hermes config check, ghi lại thời gian yêu cầu, API Base URL, ID mô hình, trạng thái HTTP và lỗi đã loại thông tin nhạy cảm, rồi xem Lỗi và khắc phục sự cố. Không gửi API Key đầy đủ.

Khuyến nghị bảo mật

• Không ghi API Key vào tệp dự án, kho Git, lịch sử lệnh, ảnh chụp màn hình, nhật ký hoặc cấu hình dùng chung;
• Dùng thư mục thử nghiệm an toàn trong lần đầu và kiểm tra từng yêu cầu truy cập tệp, lệnh và mạng;
• Không tắt xác nhận thao tác nguy hiểm qua --yolo hoặc cấu hình;
• Khi xử lý mã không đáng tin cậy, có thể dùng môi trường cách ly như Docker để giảm rủi ro, nhưng vẫn phải kiểm tra thư mục gắn kết và thông tin xác thực;
• Nếu nghi API Key bị lộ, vô hiệu hóa hoặc xóa ngay trong bảng điều khiển rồi tạo Key mới.

Bước tiếp theo

• API Key, Base URL và xác thực
• Chat Completions API Reference
• Lỗi và khắc phục sự cố