Chuyển tới nội dung chính

Profile: Chạy nhiều Agent

Chạy nhiều tác nhân Hermes độc lập trên cùng một máy — mỗi tác nhân có cấu hình, khóa API, bộ nhớ, phiên, kỹ năng và cổng riêng.

Hồ sơ là gì?​

Hồ sơ là một môi trường Hermes hoàn toàn biệt lập. Mỗi hồ sơ có thư mục riêng chứa config.yaml, .env, SOUL.md, ký ức, phiên, kỹ năng, công việc định kỳ và cơ sở dữ liệu trạng thái. Hồ sơ cho phép bạn điều hành các tác nhân riêng biệt cho các mục đích khác nhau — trợ lý mã hóa, bot cá nhân, tác nhân nghiên cứu — mà không có bất kỳ sự lây nhiễm chéo nào.

Khi bạn tạo một hồ sơ, nó sẽ tự động trở thành lệnh riêng. Tạo một hồ sơ có tên là Coder và bạn ngay lập tức có Trò chuyện với Coder, Thiết lập Coder, Khởi động cổng Coder, v.v.

Bắt đầu nhanh​

hermes profile create coder       # creates profile + "coder" command alias
coder setup                       # configure API keys and model
coder chat                        # start chatting

Thế thôi. Coder hiện là một đại lý hoàn toàn độc lập. Nó có cấu hình riêng, bộ nhớ riêng, mọi thứ riêng.

Tạo hồ sơ​

Hồ sơ trống​

hermes profile create mybot

Tạo một hồ sơ mới với các kỹ năng đi kèm được gieo mầm. Chạy mybot setup để định cấu hình khóa API, mô hình và mã thông báo cổng.

Chỉ sao chép cấu hình (--clone)​

hermes profile create work --clone

Sao chép config.yaml, .env và SOUL.md của hồ sơ hiện tại của bạn vào hồ sơ mới. Các khóa và mô hình API giống nhau nhưng phiên và bộ nhớ mới. Chỉnh sửa ~/.hermes/profiles/work/.env cho các khóa API khác nhau hoặc ~/.hermes/profiles/work/SOUL.md cho một tính cách khác.

Sao chép mọi thứ (--clone-all)​

hermes profile create backup --clone-all

Sao chép mọi thứ — cấu hình, khóa API, tính cách, tất cả ký ức, lịch sử phiên đầy đủ, kỹ năng, công việc định kỳ, plugin. Một ảnh chụp nhanh hoàn chỉnh. Hữu ích cho việc sao lưu hoặc phân nhánh một tác nhân đã có ngữ cảnh.

Sao chép từ một hồ sơ cụ thể​

hermes profile create work --clone --clone-from coder
Honcho memory + profiles

Khi Honcho được bật, --clone sẽ tự động tạo một AI ngang hàng chuyên dụng cho cấu hình mới trong khi chia sẻ cùng một không gian làm việc của người dùng. Mỗi hồ sơ xây dựng những quan sát và nhận dạng riêng của mình. Xem Honcho -- Multi-agent / Profiles để biết chi tiết.

Sử dụng hồ sơ​

Bí danh lệnh​

Mọi cấu hình sẽ tự động nhận được bí danh lệnh tại ~/.local/bin/<name>:

coder chat                    # chat with the coder agent
coder setup                   # configure coder's settings
coder gateway start           # start coder's gateway
coder doctor                  # check coder's health
coder skills list             # list coder's skills
coder config set model.model anthropic/claude-sonnet-4

Bí danh này hoạt động với mọi lệnh con của Hermes — nó chỉ là hermes -p <name> ẩn dưới mui xe.

Cờ -p​

Bạn cũng có thể nhắm mục tiêu một hồ sơ một cách rõ ràng bằng bất kỳ lệnh nào:

hermes -p coder chat
hermes --profile=coder doctor
hermes chat -p coder -q "hello"    # works in any position

Mặc định cố định (sử dụng hồ sơ hermes)​

hermes profile use coder
hermes chat                   # now targets coder
hermes tools                  # configures coder's tools
hermes profile use default    # switch back

Đặt mặc định để các lệnh hermes đơn giản nhắm mục tiêu cấu hình đó. Giống như kubectl config use-context.

Biết bạn đang ở đâu​

CLI luôn hiển thị hồ sơ nào đang hoạt động:

  • Nhắc: code ❯ thay vì ❯
  • Biểu ngữ: Hiển thị Profile: code khi khởi động
  • hermes profile: Hiển thị tên hồ sơ hiện tại, đường dẫn, model, trạng thái cổng

Chạy cổng​

Mỗi hồ sơ chạy cổng riêng của mình dưới dạng một quy trình riêng biệt với mã thông báo bot riêng:

coder gateway start           # starts coder's gateway
assistant gateway start       # starts assistant's gateway (separate process)

Mã thông báo bot khác nhau​

Mỗi hồ sơ có tệp .env riêng. Định cấu hình mã thông báo bot Telegram/Discord/Slack khác nhau trong mỗi mã:

# Edit coder's tokens
nano ~/.hermes/profiles/coder/.env

# Edit assistant's tokens
nano ~/.hermes/profiles/assistant/.env

An toàn: khóa token​

Nếu hai hồ sơ vô tình sử dụng cùng một mã thông báo bot, cổng thứ hai sẽ bị chặn với lỗi rõ ràng khi đặt tên cho hồ sơ xung đột. Được hỗ trợ cho Telegram, Discord, Slack, WhatsApp và Signal.

Dịch vụ liên tục​

coder gateway install         # creates hermes-gateway-coder systemd/launchd service
assistant gateway install     # creates hermes-gateway-assistant service

Mỗi hồ sơ có tên dịch vụ riêng. Họ chạy độc lập.

Cấu hình hồ sơ​

Mỗi hồ sơ có riêng:

  • config.yaml — model, nhà cung cấp, bộ công cụ, tất cả cài đặt
  • .env — Khóa API, mã thông báo bot
  • SOUL.md — tính cách và hướng dẫn
coder config set model.model anthropic/claude-sonnet-4
echo "You are a focused coding assistant." > ~/.hermes/profiles/coder/SOUL.md

Đang cập nhật​

hermes update lấy mã một lần (được chia sẻ) và tự động đồng bộ hóa các kỹ năng đi kèm mới với tất cả hồ sơ:

hermes update
# → Code updated (12 commits)
# → Skills synced: default (up to date), coder (+2 new), assistant (+2 new)

Các kỹ năng do người dùng sửa đổi không bao giờ bị ghi đè.

Quản lý hồ sơ​

hermes profile list           # show all profiles with status
hermes profile show coder     # detailed info for one profile
hermes profile rename coder dev-bot   # rename (updates alias + service)
hermes profile export coder   # export to coder.tar.gz
hermes profile import coder.tar.gz   # import from archive

Xóa hồ sơ​

hermes profile delete coder

Thao tác này sẽ dừng cổng, xóa dịch vụ systemd/launchd, xóa bí danh lệnh và xóa tất cả dữ liệu hồ sơ. Bạn sẽ được yêu cầu nhập tên hồ sơ để xác nhận.

Sử dụng --yes để bỏ qua xác nhận: hermes profile delete code --yes

ghi chú

Bạn không thể xóa hồ sơ mặc định (~/.hermes). Để xóa mọi thứ, hãy sử dụng hermes uninstall.

Hoàn thành tab​

# Bash
eval "$(hermes completion bash)"

# Zsh
eval "$(hermes completion zsh)"

Thêm dòng vào ~/.bashrc hoặc ~/.zshrc của bạn để hoàn thành liên tục. Hoàn thành tên hồ sơ sau -p, các lệnh phụ hồ sơ và các lệnh cấp cao nhất.

Cách thức hoạt động​

Cấu hình sử dụng biến môi trường HERMES_HOME. Khi bạn chạy code chat, tập lệnh bao bọc sẽ đặt HERMES_HOME=~/.hermes/profiles/code trước khi khởi chạy hermes. Vì hơn 119 tệp trong cơ sở mã giải quyết các đường dẫn thông qua get_hermes_home(), nên mọi thứ sẽ tự động nằm trong thư mục của hồ sơ — cấu hình, phiên, bộ nhớ, kỹ năng, cơ sở dữ liệu trạng thái, cổng PID, nhật ký và công việc định kỳ.

Cấu hình mặc định chỉ đơn giản là ~/.hermes. Không cần di chuyển — các bản cài đặt hiện tại hoạt động giống hệt nhau.