Hướng dẫn 14: Profiles — Nhiều Agent, Một Máy
Tutorial 14: Profiles — Multiple Agents, One Machine — easy-to-understand guide based on official docs
Hướng dẫn 14: Profiles — Nhiều Agent, Một Máy
Vậy là bạn đã tận hưởng Hermes Agent, nhưng giờ bạn đang nghĩ: “Liệu mình có thể chạy một trợ lý lập trình và một bot nghiên cứu trên cùng một máy mà chúng không giẫm chân lên nhau không?” Đó chính xác là những gì profiles dùng để làm.
Profiles Là Gì?
Hãy nghĩ về profile như một ngôi nhà riêng cho mỗi agent Hermes. Mỗi profile có thư mục riêng chứa config.yaml, .env, SOUL.md, bộ nhớ, phiên làm việc, kỹ năng, cron jobs và cơ sở dữ liệu trạng thái của riêng nó. Điều này có nghĩa là bạn có thể chạy một trợ lý lập trình, một bot cá nhân và một agent nghiên cứu song song — mỗi cái có API keys, tính cách và bộ nhớ riêng — mà không có bất kỳ sự trộn lẫn nào.
Cảnh báo quan trọng: Không bao giờ trỏ hai tiến trình agent vào cùng một profile. Cả hai đều tự động ghi bộ nhớ và mỗi cái nạp dữ liệu ghi của cái kia vào system prompt khi bắt đầu phiên. Hai trình ghi trên một ngôi nhà sẽ cộng dồn trạng thái của nhau cho đến khi nó không còn là thứ bạn cấu hình nữa. Profiles tồn tại chính xác để ngăn điều này. Nếu các agent cần bộ nhớ dùng chung, hãy dùng một nhà cung cấp bộ nhớ ngoài.
Bắt Đầu Nhanh
Bắt đầu cực kỳ đơn giản:
hermes profile create coder # tạo profile + lệnh alias "coder"
coder setup # cấu hình API keys và model
coder chat # bắt đầu trò chuyện
Chỉ vậy thôi! Ngay khi bạn tạo một profile, nó trở thành lệnh riêng của chính nó. Tạo một cái tên coder là bạn ngay lập tức có coder chat, coder setup, coder gateway start, v.v.
Tạo Một Profile
Bạn có vài lựa chọn khi tạo profile:
Profile trống — bắt đầu mới với các kỹ năng đi kèm được seed sẵn:
hermes profile create mybot
Sau đó chạy mybot setup để cấu hình API keys, model và gateway tokens.
Chỉ clone cấu hình — sao chép config.yaml, .env, SOUL.md và kỹ năng từ profile hiện tại của bạn:
hermes profile create work --clone
Cùng API keys và khả năng, nhưng phiên làm việc và bộ nhớ mới. Chỉnh sửa ~/.hermes/profiles/work/.env để đổi API keys, hoặc ~/.hermes/profiles/work/SOUL.md để đổi tính cách.
Clone mọi thứ — một bản snapshot làm việc hoàn chỉnh:
hermes profile create backup --clone-all
Lệnh này sao chép cấu hình, API keys, tính cách, toàn bộ bộ nhớ, kỹ năng, cron jobs và plugins. Lịch sử riêng của từng profile bị loại trừ (lịch sử phiên, cơ sở dữ liệu trạng thái, bản sao lưu) vì chúng có thể lên tới hàng chục gigabyte. Để sao lưu đầy đủ bao gồm cả lịch sử, hãy dùng hermes profile export hoặc hermes backup.
Clone từ một profile cụ thể:
hermes profile create work --clone-from coder
Kết hợp với --clone-all để có bản sao đầy đủ của profile nguồn đó.
Mẹo chuyên nghiệp: Nếu bạn định dùng một profile làm kanban worker, hãy truyền --description "<vai trò>" khi tạo để orchestrator biết nó giỏi việc gì:
hermes profile create researcher --description "Đọc mã nguồn và tài liệu ngoài, ghi lại phát hiện."
Sử Dụng Profiles Hằng Ngày
Lệnh alias — mỗi profile tự động có một lệnh alias:
coder chat # trò chuyện với agent coder
coder setup # cấu hình cài đặt của coder
coder gateway start # khởi động gateway của coder
coder doctor # kiểm tra sức khỏe của coder
coder skills list # liệt kê kỹ năng của coder
coder config set model.default anthropic/claude-sonnet-4
Cờ -p — bạn cũng có thể chỉ định rõ profile với bất kỳ lệnh nào:
hermes -p coder chat
hermes --profile=coder doctor
hermes chat -p coder -q "xin chào" # hoạt động ở bất kỳ vị trí nào
Mặc định cố định — đặt một mặc định để các lệnh hermes thông thường nhắm vào profile đó:
hermes profile use coder
hermes chat # giờ nhắm vào coder
hermes profile use default # chuyển về mặc định
Giống như kubectl config use-context — đơn giản và hiệu quả.
Biết mình đang ở đâu — CLI luôn hiển thị profile nào đang hoạt động:
- Dấu nhắc:
coder ❯thay vì❯ - Banner: Hiển thị
Profile: coderkhi khởi động hermes profile: Hiển thị tên profile hiện tại, đường dẫn, model và trạng thái gateway
Profiles vs Workspaces vs Sandboxes
Những khái niệm này thường bị nhầm lẫn, nhưng chúng là những thứ khác nhau:
- Một profile cấp cho Hermes thư mục trạng thái riêng: cấu hình, bộ nhớ, phiên, nhật ký, cron jobs và trạng thái gateway.
- Một workspace hoặc thư mục làm việc là nơi các lệnh terminal khởi chạy — được kiểm soát riêng bởi
terminal.cwd. - Một sandbox giới hạn quyền truy cập hệ thống tệp. Profiles không sandbox agent.
Trên backend terminal local mặc định, agent vẫn có quyền truy cập hệ thống tệp giống như tài khoản người dùng của bạn. Một profile không ngăn nó truy cập các thư mục bên ngoài thư mục profile.
Tổng Kết
Profiles là cách sạch sẽ nhất để chạy nhiều agent Hermes độc lập trên một máy. Mỗi cái có danh tính, bộ nhớ và cấu hình riêng — và chúng không bao giờ cần biết sự tồn tại của nhau. Hãy thử với hermes profile create và xem quy trình làm việc đa agent của bạn trở nên mượt mà hơn thế nào!
📖 Tài liệu chính thức
この記事は Hermes Agent のTài liệu chính thứcに基づいています:Tài liệu chính thức › user-guide/profiles