Harness Academy
Tài liệu gốc 33 8 phútTiếng Việt + English
docs/en/glossary.mdXem bản gốc
Ngôn ngữ bài đọc
Bản dịch tiếng Việt

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ặpLàm thế nào để phân biệt chúng
CLI so với CổngCLI 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ăngMộ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ảngMô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.mdSOUL.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.mdHERMES.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 XoayMộ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.

Mục lục nguồn