# Hermes Agent

Nguồn: https://docs.aicentos.com/vi/clients/hermes-agent

Language: vi

> Dùng aicentos trong Hermes Agent —— chỉ định endpoint OpenAI tương thích qua biến môi trường

Hermes Agent đọc thông tin kết nối của dịch vụ mô hình qua biến môi trường. Trỏ Base URL về aicentos, là có thể cho toàn bộ các yêu cầu suy luận của Agent đi qua các mô hình aicentos tích hợp.

## Chuẩn bị

Trước tiên, tạo một Key chuyên dụng cho Hermes Agent tại trang "API Key" trong Console (khuyến nghị đặt tên `hermes-agent` để dễ theo dõi mức sử dụng).

* Console: [https://aicentos.com](https://aicentos.com)
* Tạo Key: [https://aicentos.com/keys](https://aicentos.com/keys)
* Nạp tiền Ví: [https://aicentos.com/wallet](https://aicentos.com/wallet)
* Trang tài liệu: [https://docs.aicentos.com](https://docs.aicentos.com)

## Cấu hình cần điền

| Trường            | Giá trị                                      |
| ----------------- | -------------------------------------------- |
| OPENAI\_BASE\_URL | `https://aicentos.com/v1`                    |
| OPENAI\_API\_KEY  | Key tạo trong Console                        |
| Model             | tên mô hình trong "Model Square" của Console |

## Các bước thiết lập

Cấu hình trong cùng một shell chạy Agent:

```bash
export OPENAI_BASE_URL="https://aicentos.com/v1"
export OPENAI_API_KEY="sk-key-của-bạn"
export OPENAI_MODEL="gpt-4o"
```

Rồi khởi động Hermes Agent theo cách bình thường. Muốn lưu lâu dài, hãy ghi các `export` ở trên vào `~/.zshrc` hoặc `~/.bashrc`, và `source` lại một lần.

Nếu Hermes Agent có file cấu hình riêng, cũng có thể chỉ định base\_url / api\_key / model trong đó, hiệu lực tương đương; khi cả hai cùng tồn tại, lấy độ ưu tiên của chính nó làm chuẩn (thường biến môi trường cao hơn).

## Kiểm tra

Sau khi khởi động, kích hoạt một lần suy luận đơn giản nhất (ví dụ cho nó trả lời một câu hỏi kiến thức phổ thông), xác nhận có nhận được phản hồi. Rồi kiểm tra trang mức sử dụng trong Console, xác nhận yêu cầu thực sự được ghi vào Key bạn tạo cho Hermes Agent.

## Lưu ý

* Biến môi trường phải nhìn thấy được trong phiên shell khởi động Agent, ghi vào shell khác sẽ không có hiệu lực.
* Nếu bạn triển khai bằng Docker, nhớ truyền biến vào qua `-e` hoặc `environment` của compose, đừng chỉ ghi trên máy chủ.
* Base URL chỉ điền đến `/v1`.
* Một số framework Agent ưu tiên đọc `OPENAI_API_BASE`, nếu các biến ở trên không có hiệu lực, bổ sung thêm một biến cùng tên nhưng khác cách viết rồi thử lại.
* Khuyến nghị tạo Key riêng cho Agent, để tiện thống kê mức sử dụng theo dự án.