[Hermes] Hướng dẫn Quản lý Đa Agent với Profiles trong Hermes Agent

# Hướng dẫn Quản lý Đa Agent với Profiles trong Hermes Agent

Tài liệu tóm tắt và hướng dẫn thực hành chi tiết về tính năng **Profiles (Quản lý nhiều Agent độc lập)** trong Hermes Agent, trích xuất từ tài liệu chính thức: [Hermes Agent - Profiles: Running Multiple Agents]( Profiles: Running Multiple Agents | Hermes Agent ).

-–

## 1. Tổng quan về Profiles trong Hermes

### Profiles là gì?

**Profiles** là cơ chế cho phép bạn chạy **nhiều Agent Hermes hoàn toàn độc lập trên cùng một máy tính**. Mỗi profile hoạt động như một thực thể Agent riêng biệt với:

- Tệp cấu hình riêng (`config.yaml`).

- Bộ biến môi trường & API keys / Bot tokens riêng (`.env`).

- Nhân cách & chỉ dẫn hành vi riêng (`SOUL.md`).

- Bộ nhớ dài hạn (Memories), lịch sử hội thoại (Sessions), kho kỹ năng (Skills).

- Các tác vụ tự động (Cron jobs), plugin và trạng thái Gateway riêng biệt.

> **Quy tắc cốt lõi:** Không bao giờ để hai tiến trình Agent dùng chung một thư mục Home. Profiles được thiết kế để cô lập trạng thái, tránh việc các Agent ghi đè và làm ô nhiễm bộ nhớ của nhau.

-–

## 2. Bắt đầu nhanh (Quick Start)

Khi bạn tạo một profile có tên là `coder`, hệ thống tự động tạo một bí danh lệnh (command alias) `coder`:

```bash

# 1. Tạo profile mới có tên “coder”

hermes profile create coder

# 2. Cấu hình API keys và Model cho coder

coder setup

# 3. Bắt đầu trò chuyện với agent coder

coder chat

```

-–

## 3. Các cách khởi tạo Profile (Creating Profiles)

```bash

# 1. Tạo profile trắng (Fresh profile với các kỹ năng cơ bản)

hermes profile create mybot

# (Tùy chọn) Thêm mô tả vai trò cho điều phối viên Kanban

hermes profile create researcher --description “Chuyên đọc mã nguồn, tài liệu và tổng hợp báo cáo.”

# 2. Clone chỉ Cấu hình, Kỹ năng và Nhân cách (–clone)

# (Sao chép config.yaml, .env, SOUL.md, skills; sessions và memory hoàn toàn mới)

hermes profile create work --clone

# 3. Clone toàn bộ trạng thái (–clone-all)

# (Sao chép cả memories, cron jobs, plugins. Không copy lịch sử chat nặng của state.db)

hermes profile create backup --clone-all

# 4. Clone từ một Profile cụ thể

hermes profile create work-copy --clone-from coder

hermes profile create work-backup --clone-from coder --clone-all

```

-–

## 4. Cách sử dụng Profiles

### Cách 1: Sử dụng Lệnh tắt trực tiếp (Command Alias)

Mỗi profile có một lệnh thực thi riêng tại `~/.local/bin/<tên_profile>`, hỗ trợ mọi lệnh con của Hermes:

```bash

coder chat # Chat với coder

coder setup # Cấu hình cài đặt cho coder

coder gateway start # Bật gateway nhắn tin riêng của coder

coder doctor # Kiểm tra sức khỏe của coder

coder skills list # Xem danh sách kỹ năng của coder

coder config set model.default anthropic/claude-sonnet-4

```

### Cách 2: Sử dụng cờ `-p` hoặc `–profile`

Áp dụng cho lệnh `hermes` thông thường:

```bash

hermes -p coder chat

hermes --profile=coder doctor

hermes chat -p coder -q “Kiểm tra mã nguồn giúp tôi”

```

### Cách 3: Chọn Profile mặc định cố định (`hermes profile use`)

Tương tự cơ chế đổi context trong Kubernetes (`kubectl config use-context`):

```bash

# Đặt coder làm profile mặc định cho mọi lệnh hermes

hermes profile use coder

hermes chat # Lệnh này giờ đây sẽ mở coder

hermes tools # Cấu hình công cụ của coder

# Chuyển về profile mặc định ban đầu

hermes profile use default

```

### Nhận biết Profile đang kích hoạt

- **Dấu nhắc lệnh (Prompt):** Hiển thị `coder ❯` thay vì `❯`.

- **Khởi động:** Hiển thị banner `Profile: coder`.

- **Lệnh kiểm tra:** Chạy `hermes profile` để xem thông tin chi tiết về profile hiện tại.

-–

## 5. Phân biệt: Profiles vs Workspaces vs Sandboxing

| Khái niệm | Phạm vi | Mô tả |

| :— | :— | :— |

| **Profile** | Trạng thái Hermes (`HERMES_HOME`) | Cô lập cấu hình, memories, sessions, skills, logs, gateway state. |

| **Workspace** | Thư mục làm việc (`terminal.cwd`) | Nơi bắt đầu thực thi các lệnh terminal của agent. |

| **Sandbox** | Giới hạn quyền hệ điều hành | Giới hạn quyền truy cập file/OS. *Profile không tự động tạo sandbox an toàn.* |

### Tùy chỉnh thư mục làm việc cố định cho Profile

Để một profile luôn bắt đầu trong một thư mục dự án nhất định, cấu hình trong `config.yaml` của profile đó:

```yaml

terminal:

backend: local

cwd: /absolute/path/to/project # Bắt buộc dùng đường dẫn tuyệt đối

```

### Cô lập môi trường CLI Tools (`HOME` vs `HERMES_HOME`)

- **Mặc định:** Hermes dùng chung thư mục `HOME` thật của tài khoản để các công cụ CLI (`git`, `ssh`, `gh`, `npm`…) tận dụng thông tin đăng nhập sẵn có.

- **Cách cô lập danh tính CLI riêng cho từng profile:** Thiết lập trong `config.yaml`:

```yaml

terminal:

home_mode: profile   # Lúc này HOME sẽ là \~/.hermes/profiles/<name>/home

```

-–

## 6. Chạy Gateway nhắn tin đa nền tảng độc lập

Mỗi profile có thể chạy một Gateway riêng biệt với bot token riêng:

```bash

coder gateway start # Chạy gateway cho bot coder (tiến trình riêng)

assistant gateway start # Chạy gateway cho bot assistant (tiến trình riêng)

```

### Điểm nổi bật:

1. **Token khác nhau:** Chỉnh sửa token Telegram/Discord/Slack trong file `.env` của từng profile:

  • `~/.hermes/profiles/coder/.env`

  • `~/.hermes/profiles/assistant/.env`

2. **Khóa an toàn Token Lock:** Hermes tự động cảnh báo và chặn nếu hai profile cố tình dùng chung một bot token.

3. **Cài đặt dịch vụ chạy nền (Systemd / Launchd / Docker s6-overlay):**

```bash

coder gateway install # Tạo dịch vụ hệ thống hermes-gateway-coder

assistant gateway install # Tạo dịch vụ hệ thống hermes-gateway-assistant

```

-–

## 7. Các lệnh Quản trị Profile (Profile Management)

```bash

# Xem danh sách tất cả các profile và trạng thái

hermes profile list

# Xem chi tiết cấu hình và đường dẫn của 1 profile

hermes profile show coder

# Đổi tên profile (tự động cập nhật alias và system service)

hermes profile rename coder dev-bot

# Xuất profile ra file nén (.tar.gz)

hermes profile export coder

# Nhập profile từ file nén

hermes profile import coder.tar.gz

# Xóa một profile (xóa toàn bộ dữ liệu, service và alias)

hermes profile delete coder [–yes]

# Cập nhật mã nguồn và tự động đồng bộ kỹ năng mới cho TẤT CẢ profile

hermes update

```

-–

## 8. Chia sẻ Profile dạng Gói phân phối (Profile Distributions)

Bạn có thể đóng gói toàn bộ nhân cách, cấu hình và kỹ năng của một Agent lên Git để chia sẻ cho đồng nghiệp hoặc cộng đồng:

```bash

# Cài đặt một Agent hoàn chỉnh từ Git Repository

hermes profile install github.com/you/research-bot --alias

# Cập nhật phiên bản mới từ tác giả (giữ nguyên memories và .env cá nhân)

hermes profile update research-bot

```