Hermes Agent: 工具与工具集

me: 查一下北京今天的天气
Agent: [调用 web_search 工具]
       [调用 web_scrape 工具]
       北京今天：晴，26°C，空气质量优

me: 帮我运行这段 Python 代码
Agent: [调用 code_execution 工具]
       代码执行成功，输出：Hello World

高频工具（每日使用）：
  fs_read, fs_write, code_python, web_search

中频工具（每周使用）：
  web_scrape, code_shell, db_query, vision_analyze

低频工具（按需使用）：
  voice_tts, email_send, process_run, csv_process

# 读取文件
me: 读取 src/main.py 的内容
Agent: [调用 fs_read("src/main.py")]
       ```python
       from fastapi import FastAPI
       app = FastAPI()
       ...
       ```

# 写入文件
me: 创建一个 README.md
Agent: [调用 fs_write("README.md", content)]
       ✅ README.md 已创建

# 搜索文件
me: 找出所有使用了 deprecated API 的文件
Agent: [调用 fs_search("deprecated", path="src/", type="py")]
       找到3个文件：
       - src/api/users.py (line 42)
       - src/api/auth.py (line 15)
       - src/utils/helpers.py (line 88)

# 搜索
me: 搜索 React 19 新特性
Agent: [调用 web_search("React 19 new features")]
       React 19 主要新特性：
       1. Server Components 稳定版
       2. Actions 简化表单处理
       3. use() Hook
       ...

# 网页抓取
me: 抓取这个页面的标题和内容摘要
Agent: [调用 web_scrape("https://react.dev/blog")]
       标题: React 19 正式发布
       摘要: React 19 带来了...

me: 帮我计算斐波那契数列第20项
Agent: [调用 code_python]
       ```python
       def fibonacci(n):
           if n <= 1:
               return n
           return fibonacci(n-1) + fibonacci(n-2)
       print(fibonacci(20))
       ```
       执行结果：6765

me: [上传截图] 这个页面有什么问题？
Agent: [调用 vision_analyze]
       分析截图：
       1. 导航栏文字被截断
       2. 按钮颜色对比度不足（WCAG AA 不达标）
       3. 移动端布局错位
       建议：修改 CSS...

tools:
  # 沙箱配置
  sandbox: true
  sandbox_type: "docker"     # docker / subprocess / none
  
  # 代码执行限制
  code_execution:
    max_time: 30             # 最大执行30秒
    max_memory: "512MB"      # 最大内存
    allowed_languages:
      - python
      - javascript
      - bash
    network_access: false    # 禁止网络访问
    
  # 文件系统权限
  filesystem:
    allowed_paths:
      - "~/projects"
      - "/tmp/hermes"
    denied_paths:
      - "~/.ssh"
      - "~/.gnupg"
      - "/etc"
    allow_delete: false      # 禁止删除
    max_file_size: "10MB"
    
  # Web 访问限制
  web:
    rate_limit: 10           # 每分钟10次
    blocked_domains: []
    user_agent: "HermesAgent/1.0"

# ~/.hermes/tools/jira-search.yaml
name: "jira_search"
description: "搜索 Jira 工单"
category: "communication"
version: "1.0.0"

parameters:
  - name: "query"
    type: "string"
    required: true
    description: "搜索关键词"
  - name: "project"
    type: "string"
    required: false
    default: "PROJ"
  - name: "status"
    type: "string"
    required: false
    enum: ["open", "in_progress", "closed"]

execution:
  type: "api"
  method: "GET"
  url: "${JIRA_URL}/rest/api/2/search"
  headers:
    Authorization: "Bearer ${JIRA_TOKEN}"
  params:
    jql: "project = {project} AND summary ~ '{query}' AND status = {status}"

output:
  format: "json"
  transform: |
    results.map(issue => ({
      key: issue.key,
      summary: issue.fields.summary,
      status: issue.fields.status.name,
      assignee: issue.fields.assignee?.displayName
    }))

# ~/.hermes/tools/custom_metrics.py
from hermes import Tool, ToolResult

class CustomMetricsTool(Tool):
    name = "custom_metrics"
    description = "获取项目自定义指标"
    category = "data"
    
    parameters = {
        "metric": {"type": "str", "required": True},
        "time_range": {"type": "str", "default": "7d"}
    }
    
    def execute(self, metric: str, time_range: str = "7d") -> ToolResult:
        # 自定义逻辑
        data = self.fetch_metric(metric, time_range)
        return ToolResult(
            success=True,
            data=data,
            summary=f"{metric} 最近{time_range}: {data['trend']}"
        )

# 工具集：前端开发
toolsets:
  frontend-dev:
    tools:
      - fs_read
      - fs_write
      - code_node
      - code_shell
      - web_search
      - vision_analyze
    config:
      fs_write.allowed_extensions: [".ts", ".tsx", ".css", ".html"]
      code_shell.allowed_commands: ["npm", "npx", "git"]

  # 工具集：数据分析
  data-analysis:
    tools:
      - fs_read
      - code_python
      - db_query
      - csv_process
      - json_parse
    config:
      code_python.packages: ["pandas", "numpy", "matplotlib"]

# 指定工具集启动
hermes chat --toolset frontend-dev

# 对话中切换
/toolset data-analysis

# 查看当前工具集
/toolset list