Hướng dẫn tác nhân Flaq AI

Hướng dẫn thực tế để dùng Hermes Agent với dịch vụ API của Flaq AI

Sử dụng endpoint tương thích Hermes Agent của Flaq AI để nhanh chóng cấu hình Hermes Agent với Flaq và truy cập các dịch vụ model của chúng tôi từ terminal. Sau khi cấu hình API key, hãy làm theo các ví dụ trong hướng dẫn này để chọn một model hiện được hỗ trợ và xác minh thiết lập.

Hướng dẫn tác nhân

Claude Code/cc-apiOpenAI Codex/codex-api/v1Hermes Agent/api/v1

Cài đặt

Cài đặt Hermes Agent

Cài đặt Hermes Agent cho hệ thống của bạn, tải lại shell nếu cần, rồi xác minh lệnh hermes trước khi thêm cài đặt Flaq AI. Nếu trình cài đặt mở trình hướng dẫn thiết lập, bạn có thể bỏ qua đăng nhập Nous Portal và cấu hình Flaq thủ công sau đó.

1

Cài đặt Hermes Agent

Chọn trình cài đặt phù hợp với hệ thống của bạn, rồi chạy lệnh cài đặt bên dưới.

  • Trình cài đặt có thể mở trình hướng dẫn thiết lập Hermes.
  • Với thiết lập Flaq, bạn có thể bỏ qua đăng nhập Nous Portal và tiếp tục với cấu hình thủ công bên dưới.

Script cài đặt chính thức

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

Tải lại shell profile

Chạy lệnh này sau khi cài đặt nếu lệnh hermes chưa khả dụng. Dùng source ~/.bashrc nếu shell của bạn dùng bash.

Tải lại shell profile

source ~/.zshrc
3

Xác minh Hermes Agent

Xác nhận lệnh hermes có sẵn trước khi thêm thông tin xác thực Flaq AI.

Xác minh cài đặt

hermes --version

Cấu hình

Kết nối Hermes Agent với Flaq AI

Chọn một model hiện được endpoint tương thích OpenAI của Flaq hỗ trợ, lưu API key Flaq của bạn trong ~/.hermes/.env, và trỏ config.yaml đến URL gốc API của Flaq.

Model text được khuyến nghị làm mặc định đáng tin cậy cho quy trình coding Hermes Agent.

Dùng các lệnh Hermes CLI để ghi API key Flaq và cài đặt model với ít thao tác chỉnh file thủ công hơn. Việc này cập nhật cài đặt Hermes cục bộ của bạn, nên hãy sao lưu cấu hình hiện có trước nếu bạn đã dùng Hermes.

Ghi key Flaq, model đã chọn, nhà cung cấp tùy chỉnh, base URL và độ dài context thông qua các lệnh cấu hình của Hermes.

Thiết lập nhanh bằng Hermes CLI

hermes config set FLAQ_API_KEY Your_Api_Keyhermes config set model.default gpt-5.4-text-to-texthermes config set model.provider customhermes config set model.base_url https://api.flaq.ai/api/v1hermes config set model.api_key '${FLAQ_API_KEY}'hermes config set model.context_length 128000hermes config check

Xác minh

Xác minh Flaq trong Hermes Agent

Chạy một lệnh Hermes one-shot nhanh. Câu trả lời bình thường nghĩa là Hermes có thể gọi model thông qua endpoint Flaq LLM.

Khởi động chế độ tương tác

hermes

Lệnh kiểm thử nhanh

hermes -m gpt-5.4-text-to-text -z "What is 2+2?"

Chẩn đoán cấu hình

hermes config check

Đặt model đã chọn làm mặc định

hermes config set model.default gpt-5.4-text-to-text

Khắc phục sự cố

Câu hỏi thường gặp về Hermes Agent

Việc sử dụng thiết lập trong hướng dẫn này có thể làm tăng đáng kể lượng token sử dụng.