# Mẹo & Thực hành Tốt nhất (Tips & Best Practices) cho Hermes Agent
Bài viết này tổng hợp các mẹo và hướng dẫn thực hành tốt nhất từ tài liệu [Tips & Best Practices của Hermes Agent]( Tips & Best Practices | Hermes Agent ) để giúp bạn sử dụng Agent hiệu quả, tối ưu chi phí và tăng cường bảo mật.
## 1. Tối ưu Kết quả Trả về (Getting the Best Results)
* **Cụ thể và rõ ràng:** Tránh những prompt chung chung như “sửa lỗi code”. Hãy cung cấp chi tiết: tên file, số dòng, thông báo lỗi (tracebacks).
* **Cung cấp Context ngay từ đầu:** Đưa ra các chi tiết quan trọng, đường dẫn file, lỗi và kỳ vọng ngay trong tin nhắn đầu tiên thay vì phải giải thích nhiều vòng.
* **Tận dụng file ngữ cảnh (Context Files):** Nếu có các quy tắc code lặp đi lặp lại (VD: “sử dụng tab thay vì space”, “sử dụng pytest”), hãy lưu chúng vào file `AGENTS.md`. Agent sẽ tự động đọc file này mỗi phiên làm việc.
* **Để Agent tự sử dụng Tools:** Thay vì hướng dẫn từng bước nhỏ (mở file A, nhìn dòng 42,…), hãy giao việc lớn: “tìm và sửa lỗi bài test đang thất bại”. Agent có đủ công cụ (tìm file, chạy terminal, chạy code) để tự khám phá.
* **Sử dụng Skills cho quy trình phức tạp:** Dùng lệnh `/skills` để xem các skills có sẵn hoặc gọi trực tiếp (ví dụ: `/github-pr-workflow`) thay vì phải viết prompt dài dòng để giải thích cách làm.
## 2. Mẹo cho Người dùng CLI (CLI Power User Tips)
* **Xuống dòng (Multi-Line Input):** Nhấn `Alt+Enter`, `Ctrl+J` hoặc `Shift+Enter` (tùy terminal) để xuống dòng mà không gửi tin nhắn.
* **Tự nhận diện Paste:** CLI tự động nhận diện khi bạn dán (paste) các khối code dài hoặc log lỗi, không lo bị tách thành nhiều tin nhắn.
* **Ngắt và Điều hướng (Interrupt & Redirect):** Nhấn `Ctrl+C` 1 lần để dừng Agent đang phản hồi và điều hướng lại. Nhấn đúp `Ctrl+C` trong vòng 2 giây để thoát.
* **Tiếp tục phiên làm việc:** Dùng `hermes -c` để tiếp tục phiên làm việc gần nhất, hoặc `hermes -r “tên-phiên”` để gọi lại lịch sử trò chuyện.
* **Dán ảnh trực tiếp:** Bấm `Ctrl+V` để dán ảnh chụp màn hình/báo lỗi từ clipboard trực tiếp vào chat.
* **Tự động hoàn thành lệnh (Autocomplete):** Gõ `/` và nhấn `Tab` để xem danh sách các lệnh và skills có sẵn.
## 3. Các File Ngữ Cảnh (Context Files)
* **`AGENTS.md` (Bộ não của Dự án):** Lưu các quyết định về kiến trúc, quy ước viết code. Đặt ở thư mục gốc của dự án.
* **`SOUL.md` (Tùy chỉnh Tính cách):** Sửa file `~/.hermes/SOUL.md` để thiết lập “giọng văn” (personality) mặc định cho Agent (ví dụ: luôn trả lời ngắn gọn, đóng vai kỹ sư backend).
* **Tương thích `.cursorrules`:** Hermes tự động nhận diện và đọc file `.cursorrules` hoặc `.cursor/rules/*.mdc` nếu có.
* **Lazy Discovery:** File `AGENTS.md` trong các thư mục con chỉ được load khi Agent truy cập vào thư mục đó, giúp tiết kiệm dung lượng token.
## 4. Quản lý Bộ nhớ & Skills
* **Phân biệt Memory và Skills:** Memory (Bộ nhớ) dùng cho sự kiện, sở thích, thông tin môi trường (“What”). Skills (Kỹ năng) dùng cho quy trình, các bước công việc nhiều bước (“How”).
* **Tạo Kỹ năng mới:** Khi làm 1 tác vụ 5+ bước và có thể tái sử dụng, hãy bảo: “save what you just did as a skill called xyz”. Lần sau chỉ cần gõ `/xyz`.
* **Quản lý giới hạn bộ nhớ:** Khi bộ nhớ (`MEMORY.md` / `USER.md`) đầy, hãy yêu cầu Agent dọn dẹp hoặc xóa các thông tin cũ (VD: “xóa note về Python 3.9 đi, giờ dùng 3.12 rồi”).
* **Chủ động Ghi nhớ:** Nói “remember this for next time” để Agent lưu lại các kết quả quan trọng sau một phiên làm việc hiệu quả.
## 5. Tối ưu Hiệu suất & Chi phí (Performance & Cost)
* **Giữ Cache của Prompt:** Các LLMs có bộ nhớ đệm (cache). Nếu bạn thay đổi model (`/model`) liên tục trong một phiên dài, cache sẽ bị xóa và bạn sẽ tốn nhiều tiền hơn. Hãy hạn chế switch model.
* **Sử dụng `/compress`:** Nếu đoạn chat quá dài và Agent bị chậm/ngắt kết quả, dùng lệnh `/compress` để tóm tắt lại lịch sử hội thoại, giữ ngữ cảnh mà vẫn giảm đáng kể số lượng token.
* **Ủy quyền làm việc song song:** Dùng tính năng `delegate_task` cho subagents để nghiên cứu nhiều chủ đề cùng lúc. Nhờ vậy, phiên chat chính sẽ không bị nhồi nhét token.
* **Sử dụng Script (execute_code) cho các tác vụ hàng loạt:** Đừng yêu cầu Agent chạy từng lệnh terminal để đổi tên 100 file. Yêu cầu nó viết 1 đoạn script Python thực thi một lần.
* **Chọn đúng Model:** Dùng các mô hình mạnh (Claude Opus, GPT-4o) cho việc kiến trúc/lập luận khó, và đổi model nhỏ hơn (nhanh hơn) cho các thao tác format code, tạo boilerplate.
## 6. Mẹo cho Nền tảng Nhắn tin (Messaging Tips)
* **Set kênh cố định (`/sethome`):** Gõ `/sethome` trên Telegram/Discord để Agent biết đây là kênh mặc định, từ đó có thể gửi thông báo, kết quả cron jobs chủ động.
* **Đặt tên phiên làm việc (`/title`):** Luôn dùng `/title ten-du-an` để dễ tìm kiếm lại bằng lệnh `hermes sessions list`.
* **DM Pairing:** Thay vì duyệt user ID thủ công cho allowlists, hãy dùng tính năng ghép nối. Khi thành viên nhắn cho bot, họ sẽ nhận mã code để bạn xác duyệt bằng lệnh `hermes pairing approve …`.
## 7. Bảo mật & An toàn (Security)
* **Dùng Docker cho Code không đáng tin:** Nếu phải chạy code/kho lưu trữ mới, thiết lập `TERMINAL_ENV=docker` trong `.env` để cách ly môi trường khỏi máy tính thật của bạn.
* **Lưu ý Encoding trên Windows:** Trên Windows, nên yêu cầu Agent lưu file với `encoding=“utf-8”` hoặc thiết lập PowerShell để xuất UTF-8, tránh lỗi `UnicodeEncodeError`.
* **Cẩn thận với tùy chọn “Always” (Luôn cho phép):** Khi Agent yêu cầu chạy các lệnh nguy hiểm (`rm -rf`, `DROP TABLE`), hãy nghĩ kỹ trước khi ấn “Always” (Luôn cho phép vĩnh viễn). Hãy thử “Session” (Trong phiên này) trước.
* **Đừng tắt tính năng Command Approval:** Hermes luôn chặn các lệnh nguy hiểm (xóa hệ thống, script lạ). Không bao giờ tắt tính năng duyệt lệnh (approval) trên môi trường thật.
* **Dùng Allowlists:** Tuyệt đối không để `GATEWAY_ALLOW_ALL_USERS=true` trên bot có quyền truy cập terminal. Hãy giới hạn qua `TELEGRAM_ALLOWED_USERS` hoặc `DISCORD_ALLOWED_USERS`.