Skip to main content
Thêm TokenLab làm nhà cung cấp riêng có tên, giữ nguyên tài khoản, cấu hình và quyền công cụ hiện có.

Giao việc này cho Agent

Cài đặt hoặc kiểm tra Hermes

Hướng dẫn chính thức có bộ cài máy tính cho macOS Apple Silicon và Windows, cùng CLI cho Linux và Windows nguyên bản. Kiểm tra yêu cầu hệ thống; bỏ qua cài đặt nếu đã có Hermes.

Tùy chọn: cấu hình có thể khôi phục

TokenLab Skills 0.1.3 có công cụ cấu hình cho Hermes chính thức 0.21.3. Công cụ xem trước, sao lưu rồi chỉ thêm một nhà cung cấp có tên, giữ nguyên chú thích YAML, tài khoản, mô hình mặc định và quyền. Đọc hướng dẫn trước. Đặt SKILL_DIR thành thư mục tokenlab-api-integration đã cài và HERMES_PYTHON thành Python trong thư mục cài đặt do hermes --version hiển thị: venv/bin/python trên macOS/Linux hoặc venv\Scripts\python.exe trên Windows. PowerShell dùng $SkillDir$HermesPython. Công cụ dùng môi trường hiện có, không cài gói Python toàn cục.
Sau khi áp dụng, bỏ qua bước hợp nhất thủ công bên dưới và làm theo thư mục cùng lệnh tải được in ra; công cụ nhận biết active_profile. Đọc cấu hình không xác minh khóa. Dùng --restore để xem trước, rồi thêm --apply để khôi phục các byte gốc. Xung đột, chỉnh sửa sau đó, cấu hình được quản lý hoặc WSL sẽ dừng tự động hóa; giữ nguyên thiết lập và dùng cách thủ công.

Cấu hình nhà cung cấp

Dùng thư mục HERMES_HOME nếu đã đặt, nếu không dùng ~/.hermes (Windows: %LOCALAPPDATA%\hermes). Sao lưu config.yaml rồi hợp nhất các mục dưới đây, giữ nguyên thiết lập khác. Chọn mô hình hiện hỗ trợ Chat Completions và gọi công cụ. Sao lưu cấu hình đang dùng. Chỉ thêm mục TokenLab và giữ nguyên nhà cung cấp, tài khoản, mô hình mặc định cùng quyền hiện có. Nếu tên đã được dùng, chọn tên khác và sửa lệnh tương ứng. Khi hoàn tác, chỉ xóa mục đã thêm hoặc khôi phục bản sao lưu trước đó.
Tạo khóa tại Khóa API. Lưu cục bộ thành TOKENLAB_API_KEY trong .env của thư mục Hermes hoặc môi trường tiến trình khởi chạy. Không dán khóa vào hội thoại hay YAML của nhà cung cấp.

Kiểm tra rồi gửi yêu cầu

Kiểm tra nhà cung cấp bằng hermes config get providers.tokenlab.api; kết quả phải là https://api.tokenlab.sh/v1. Giữ nguyên phần model hiện có. Bắt đầu phiên mới với nhà cung cấp và mô hình chỉ định bên dưới; không có các tùy chọn này thì dùng mặc định trước đó. Việc kiểm tra cấu hình không xác minh khóa.
Khi sẵn sàng dùng số dư TokenLab, gửi văn bản ngắn rồi đối chiếu phản hồi với bản ghi yêu cầu. Sau đó thử tác vụ công cụ chỉ đọc. Mô hình phụ và công cụ tùy chọn có thể dùng nhà cung cấp hoặc khóa riêng.

Khôi phục và xử lý lỗi

Nếu không nhận diện nhà cung cấp, kiểm tra phiên bản và định dạng hiện tại. Với lỗi xác thực, kiểm tra môi trường và trạng thái khóa mà không in khóa. Để hoàn tác, khôi phục mô hình cũ và chỉ xóa các mục TokenLab vừa thêm. MCP và Skills là các phần mở rộng riêng: hướng dẫn MCP thêm công cụ API, hướng dẫn Skill cung cấp chỉ dẫn tích hợp. Chúng không bắt buộc cho cấu hình nhà cung cấp này.