Hermes-Agent 自定义工具开发实战

# 1. 激活Hermes虚拟环境（手动安装用户）
source ~/.hermes/venv/bin/activate
# 2. 确认hermes命令可用
hermes version
# 3. 安装必要依赖（若未安装）
pip install pydantic  # 工具参数校验（Hermes内置依赖，一般已安装）

# 创建自定义工具目录（若不存在）
mkdir -p ~/.hermes/skills/my_custom_tools
cd ~/.hermes/skills/my_custom_tools

from hermes.tools.base import BaseTool
from pydantic import Field
from typing import Optional
# 自定义工具类，必须继承BaseTool
class FileQueryTool(BaseTool):
    # 1. 工具基础信息（必填）
    name: str = "file_query"  # 工具唯一标识（调用时用这个名字）
    description: str = "用于查询本地文件的内容，需要传入文件的绝对路径；如果文件不存在，会返回错误提示"  # LLM用来判断是否调用该工具
    return_direct: bool = False  # 是否直接返回结果（无需LLM二次处理）
    # 2. 工具参数（必填，用pydantic校验）
    file_path: str = Field(
        description="本地文件的绝对路径，例如：/home/user/test.txt、C:/Users/test.txt（WSL2中用Linux路径）"
    )
    encoding: Optional[str] = Field(
        default="utf-8",
        description="文件编码格式，默认utf-8，若出现乱码可尝试gbk"
    )
    # 3. 核心执行方法（必填，实现工具逻辑）
    async def execute(self) -> str:
        """执行工具，查询文件内容并返回"""
        try:
            # 读取文件内容
            with open(self.file_path, "r", encoding=self.encoding) as f:
                content = f.read()
            # 处理长文本（避免超过LLM上下文限制）
            if len(content) > 1000:
                return f"文件内容（前1000字符）：\n{content[:1000]}\n\n提示：文件内容过长，已截取前1000字符，如需完整内容请指定截取范围。"
            else:
                return f"文件内容：\n{content}"
        except FileNotFoundError:
            return f"错误：未找到文件，请检查路径是否正确（路径：{self.file_path}）"
        except Exception as e:
            return f"读取文件失败：{str(e)}"
# 注册工具（Hermes启动时会自动扫描并加载）
def register_tools(tool_manager):
    tool_manager.register_tool(FileQueryTool())

# 1. 重启Hermes（加载新工具）
hermes stop  # 若已启动，先停止
hermes       # 重新启动
# 2. 在Hermes交互界面，查看所有工具
/hermes tools list

# Hermes交互界面输入
帮我查询文件 /home/user/test.txt 的内容

start_line: Optional[int] = Field(
    default=1,
    description="开始读取的行数，默认从第1行开始"
)
end_line: Optional[int] = Field(
    default=None,
    description="结束读取的行数，默认读取到文件末尾"
)

hermes logs  # 查看Hermes运行日志，定位错误