docs/en/glossary.mdXem bản gốc Bản dịch đầy đủ theo đúng cấu trúc tài liệu; code, liên kết và định danh kỹ thuật được giữ nguyên.
Thuật ngữ
Bảng thuật ngữ này bao gồm các thuật ngữ có nhiều khả năng thu hút những người mới tham gia vào hệ thống agent Hermes.
Nhiều thuật ngữ trong số này cũng xuất hiện trong các hướng dẫn chung về agent, nhưng trong Hermes, chúng mang ý nghĩa hoặc cách triển khai cụ thể.
Đề xuất đọc
entity-map.md-- hiểu mỗi thực thể thuộc về lớp nào.data-structures.md-- hiểu những thuật ngữ này trông như thế nào khi chúng chuyển sang mã ở trạng thái thực tế.
agent AIA
Lớp cốt lõi của agent Hermes.
Nó không phải là một quá trình dịch vụ chạy dài. Trong chế độ CLI, một phiên bản duy nhất chạy từ đầu đến cuối. Ở chế độ Cổng, một phiên bản mới được tạo khi mỗi tin nhắn của người dùng đến, được tải cùng với lịch sử hội thoại và bị loại bỏ sau khi quá trình chạy hoàn tất.
Điều này có nghĩa là bất kỳ trạng thái nào cần tồn tại trong các tin nhắn đều không thể tồn tại bên trong phiên bản đó.
run_conversation
Phương pháp chính của AIAgent. Nhận tin nhắn của người dùng, chạy vòng hội thoại cho đến khi mô hình dừng gọi công cụ và trả về câu trả lời cuối cùng cùng với toàn bộ lịch sử tin nhắn.
Đó là một thường xuyên def, không phải một async def. Đây là một trong những lựa chọn thiết kế quan trọng nhất trong Hermes Agent.
Giao diện tương thích với OpenAI
agent Hermes sử dụng OpenAI Python SDK làm ứng dụng khách API duy nhất. Tất cả các nhà cung cấp mô hình (OpenRouter, Anthropic, điểm cuối cục bộ) được kết nối bằng cách cài đặt base_url.
Điều này có nghĩa là định dạng tin nhắn luôn là định dạng OpenAI (role: user/assistant/tool) và việc chuyển đổi mô hình chỉ yêu cầu thay đổi cấu hình.
Đăng ký công cụ
Một sổ đăng ký đơn lẻ. Mỗi file công cụ sẽ tự động gọi register() để tự đăng ký khi được Python nhập.
Chuỗi nhập khẩu tại agent Hermes là: đăng ký <- tool files <- orchestration layer <- core loop. The registry does not depend on any tool, preventing circular imports.
Toolset
Nội dung này trình bày chi tiết về hệ thống, giới hạn và cách vận hành của agent. web terminal
Nội dung này trình bày chi tiết về hệ thống, giới hạn và cách vận hành của agent.
Skill
Nội dung này trình bày chi tiết về hệ thống, giới hạn và cách vận hành của agent.
Nội dung này giải thích khái niệm và cách vận hành tương ứng trong hệ thống agent.
Nội dung này giải thích khái niệm và cách vận hành tương ứng trong hệ thống agent.
Gateway
Nội dung này giải thích khái niệm và cách vận hành tương ứng trong hệ thống agent.
Nội dung này giải thích khái niệm và cách vận hành tương ứng trong hệ thống agent.
Platform Adapter
Inside the Gateway, each platform has its own adapter.
Nội dung này mô tả quy tắc đánh giá và cách vận hành trong hệ thống agent.
Nội dung này mô tả quy tắc đánh giá và cách vận hành trong hệ thống agent.
MessageEvent
The unified format that adapters convert platform-specific messages into.
Nội dung này mô tả quy tắc đánh giá và cách vận hành trong hệ thống agent.
Terminal Backend / Execution Environment
Where terminal commands are actually executed.
Hermes Agent abstracts an execution environment interface with six implementations: local process, Docker container, SSH remote, Modal serverless, Daytona serverless, and Singularity container.
Nội dung này giải thích thành phần và hành vi tương ứng của hệ thống agent.
SessionDB (Session Store)
Nội dung này giải thích thành phần và hành vi tương ứng của hệ thống agent.
Uses WAL mode to support concurrent reads and writes (for the multi-platform Gateway scenario), and FTS5 to support full-text search across historical sessions.
FTS5
SQLite's full-text search extension. Lets you quickly search text content across a large volume of historical sessions.
Context Compression
Nội dung này giải thích thành phần và hành vi tương ứng của hệ thống agent.
Nội dung này trình bày thành phần và quy trình tương ứng trong kiến trúc agent. parent_session_id
SOUL.md
Nội dung này trình bày thành phần và quy trình tương ứng trong kiến trúc agent.
Nội dung này trình bày thành phần và quy trình tương ứng trong kiến trúc agent.
MEMORY.md / USER.md
Memory files. They store information that remains valuable across sessions (user preferences, project context, etc.).
Nội dung này mô tả context, cấu hình và môi trường runtime cô lập của agent.
HERMES.md / AGENTS.md
Nội dung này mô tả cấu hình, safety và giới hạn runtime của agent.
Similar to CLAUDE.md or .cursorrules in other agent frameworks, but Hermes Agent supports multiple filenames and uses them in priority order.
Profile
Nội dung này mô tả context, cấu hình và môi trường runtime cô lập của agent.
Use case: the same person might have a "development" profile and a "writing" profile, with completely different personas, memories, and tool configurations.
Approval / Dangerous Command Detection
A safety check before executing terminal commands.
Nội dung này mô tả cấu hình, safety và giới hạn runtime của agent.
Iteration Budget
Nội dung này mô tả cấu hình, safety và giới hạn runtime của agent.
Nội dung này giải thích budget và cơ chế xử lý lỗi trong hệ thống agent.
Failover
Nội dung này giải thích budget và cơ chế xử lý lỗi trong hệ thống agent.
Examples: rate-limited -> lùi lại và thử lại; ngữ cảnh quá dài -> kích hoạt nén; lỗi xác thực -> chuyển đổi thông tin xác thực.
MCP
Giao thức bối cảnh mô hình. Cho phép agent kết nối với các công cụ bên ngoài thông qua một giao thức hợp nhất.
Khi một công cụ MCP được kết nối, nó trông giống hệt như một công cụ tích hợp sẵn trong mô hình. Mô hình không cần biết công cụ được tích hợp sẵn hay bên ngoài.
Công việc định kỳ
Cho phép agent tự động thực hiện công việc vào thời điểm trong tương lai.
Hỗ trợ ba định dạng lập lịch: trễ một lần (30m), khoảng lặp lại (every 2h) và biểu thức cron tiêu chuẩn (0 9 * * *).
Những khái niệm thường bị nhầm lẫn nhất
| Cặp | Làm thế nào để phân biệt chúng |
|---|---|
| CLI so với Cổng | CLI là điểm truy cập terminal dành cho một người dùng; Gateway là một cổng tin nhắn đa nền tảng. Vòng lặp cốt lõi là như nhau. |
| Công cụ so với Kỹ năng | Một công cụ là một khả năng được mã hóa cứng; kỹ năng là một tệp khả năng được quản lý bởi agent trong runtime. |
| Môi trường thực thi so với Bộ điều hợp nền tảng | Môi trường thực thi quản lý "nơi chạy lệnh"; bộ điều hợp quản lý "tin nhắn đến từ đâu". |
| Phiên so với bộ nhớ | Phiên là bản ghi đầy đủ của một cuộc trò chuyện; bộ nhớ là thông tin được quản lý kéo dài các phiên. |
| SOUL.md so với MEMORY.md | SOUL.md là cá tính (ổn định); MEMORY.md là bộ nhớ (được cập nhật theo thời gian). |
| HERMES.md so với MEMORY.md | HERMES.md chứa các quy tắc dự án (hướng dẫn dành cho agent); MEMORY.md chứa kiến thức mà agent đã tự tích lũy. |
| Lặp lại so với Xoay | Một lần lặp là một lệnh gọi API. Một lượt có thể chứa nhiều lần lặp (nếu mô hình gọi các công cụ liên tiếp). |
Nếu bạn gặp phải một thuật ngữ không quen thuộc khi đọc tài liệu, hãy quay lại đây trước thay vì đọc qua.