HermesAgent日志分析:如何追踪Agent行为

星浩同学_8819

星浩同学_8819

2026-04-23

971人浏览

原创

必须解析会话json日志、查询sqlite状态库、监控audit.log、使用session_search_tool.py及启用opentracing,才能结构化追踪hermes agent的操作、工具调用与状态变更。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

hermesagent日志分析:如何追踪agent行为

如果您需要理解Hermes Agent在运行过程中执行了哪些操作、调用了哪些工具、产生了哪些状态变更,则必须对其行为轨迹进行结构化追踪。以下是实现该目标的多种技术路径:

一、解析会话级JSON日志文件

会话JSON文件完整记录单次交互的全部事件流,包含时间戳、事件类型、工具调用参数与返回结果,是还原Agent行为最细粒度的数据源。

1、进入用户主目录,执行ls -la ~/.hermes/sessions/列出全部会话JSON日志文件。

2、选取最新会话文件,使用jq提取关键字段:jq -r '.timestamp, .event_type, .tool_name, .status' ~/.hermes/sessions/session_*.json。

3、按时间顺序排序并高亮失败事件:jq -r 'select(.status == "failed") | "\(.timestamp) \(.event_type) \(.tool_name)"' ~/.hermes/sessions/*.json | sort。

4、定位某次具体工具调用的完整输入输出:jq -r 'select(.tool_name == "web_search" and .status == "success") | .input, .output' ~/.hermes/sessions/*.json。

二、查询SQLite状态数据库

SQLite数据库存储结构化元数据,如会话生命周期、工具调用链路、状态变更序列,适合执行跨会话关联分析与状态回溯。

1、启动数据库交互终端:sqlite3 ~/.hermes/state.db。

2、查看sessions表中最近5个会话的创建时间与结束状态:SELECT id, created_at, ended_at, status FROM sessions ORDER BY created_at DESC LIMIT 5;。

3、检索某一会话ID下所有工具调用记录及其执行顺序:SELECT tool_name, status, started_at, finished_at, duration_ms FROM tool_calls WHERE session_id = "sess_abc123" ORDER BY started_at;。

4、识别异常中断的会话(ended_at为空且status为running):SELECT id FROM sessions WHERE status = "running" AND ended_at IS NULL;。

三、实时监控审计日志中的安全动作

audit.log专用于记录权限变更、技能安装、系统扫描等高风险操作,是追踪Agent越权或非预期行为的关键入口。

1、确认审计日志存在且可读:ls -l ~/.hermes/audit.log。

Hermes Agent
Hermes Agent

将OpenClaw打造为具备种子工作空间规则、技能提升、反思记忆和主动维护的学习循环智能体。

下载

2、实时跟踪新增审计条目:tail -f ~/.hermes/audit.log。

3、筛选出所有拒绝类操作:grep "deny\|DENY" ~/.hermes/audit.log。

4、提取过去两小时内涉及技能管理的操作:awk -v d="$(date -d '2 hours ago' '+%Y-%m-%d %H:%M:%S')" '$0 > d {print}' ~/.hermes/audit.log | grep -E "(install|uninstall|enable|disable)"。

四、使用session_search_tool.py执行条件化行为检索

该工具支持基于时间窗口、事件类型、工具名称等多维条件组合查询,避免手动遍历原始日志,提升行为定位效率。

1、确保工具具备执行权限:chmod +x tools/session_search_tool.py。

2、检索某天内所有vision_tools调用记录:python tools/session_search_tool.py --tool-name vision_tools --since "2026-04-17" --until "2026-04-18"。

3、查找某次会话中耗时超过5秒的工具调用:python tools/session_search_tool.py --session-id sess_xyz789 --min-duration 5000。

4、导出所有ERROR级别事件为CSV格式便于外部分析:python tools/session_search_tool.py --level ERROR --output csv > error_events.csv。

五、启用OpenTracing并注入Span上下文

当Hermes Agent参与分布式调用链时,仅靠本地日志无法还原跨服务行为路径,需通过OpenTracing协议注入trace-id与span-id,实现端到端行为追踪。

1、编辑hermes-agent.yaml,在tracing节点下设置enabled: true与tracer-type: opentracing。

2、重启Agent后,验证HTTP响应头是否携带traceparent字段:curl -I http://localhost:8000/health。

3、在消息发送逻辑中调用tracer.start_span()并显式注入父Span上下文:span.set_tag("hermes.session_id", current_session_id)。

4、检查/actuator/traces端点是否返回带hermes.*标签的Span列表:若返回空列表,说明OpenTracing未正确激活。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

hermes agent hermesagent

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Hermes Agent完整设置指南教程
Hermes Agent完整设置指南教程

此专题为您提供 HermesAgent最新、最全面的设置指南。内容涵盖从一键安装、模型配置(支持阿里云百炼等)到微信、钉钉等全平台接入的完整流程。无论您是新手还是进阶用户,都能在这里找到清晰的步骤说明与常见问题解答,助您快速部署并掌握这款能自我进化的AI代理,轻松开启智能化工作流。

2026.04.13

592

11

Hermes Agent完整部署教程
Hermes Agent完整部署教程

本专题聚焦开源AI智能体Hermes Agent,提供从入门到精通的完整部署教程。作为会“自我进化”的AI助手,它支持本地及云端私有化部署,具备持久记忆与技能自动沉淀能力。无论你是开发者还是效率追求者,这里都将助你快速搭建专属的“数字伙伴”,实现AI自主执行复杂任务,让工作效率倍增。

2026.04.13

414

20

HermesAgent下载安装完整教程
HermesAgent下载安装完整教程

本专区为您提供 HermesAgent最全面的安装与部署指南。作为由NousResearch推出的“可成长”AI智能体,Hermes支持Linux、macOS及WSL2环境。我们汇集了从官方推荐的一键脚本安装、手动源码部署,到Docker及云服务器(如腾讯云Lighthouse)搭建的保姆级教程。无论您是新手还是开发者,都能在此找到详细的配置步骤,助您快速拥有这位具备持久记忆与自我进化能力的AI助手。

2026.04.13

317

21

Hermes Agent使用指南汇总
Hermes Agent使用指南汇总

本专题将带你从零开始,全面掌握Hermes Agent的安装部署、核心配置、技能扩展与生态整合,无论你是想打造专属私人助手,还是探索AI自动化变现路径,这里都有最实用的实战指南。

2026.05.06

469

34

FrankenPHP集成Laravel详细教程
FrankenPHP集成Laravel详细教程

本专题提供FrankenPHP集成Laravel的详细配置指南,全面解析运行原理、开发环境搭建、Caddyfile配置、Octane工作模式、数据库连接、队列任务、定时任务和生产环境优化,解决部署过程中常见的报错与兼容性问题。

2026.10.08

0

20

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

2026.09.30

120

10

LLVM RISC-V参数配置教程
LLVM RISC-V参数配置教程

本专题介绍LLVM对RISC-V基础ISA和扩展的支持方式,涵盖RV32、RV64、标准扩展、实验性扩展、厂商扩展、-menable-experimental-extensions和版本差异。

2026.09.30

100

14

LLVM IR中间表示入门指南
LLVM IR中间表示入门指南

本专题整理LLVM IR的核心概念,包括中间表示作用、模块结构、函数、基本块、SSA形式、类型系统和常见语法,帮助新手理解LLVM编译流程中的关键层。

2026.09.30

80

12

PDF转图片方法
PDF转图片方法

需要把 PDF 页面用于上传、预览、分享或图片归档时,PDF 转图片方法专题整理 JPG/PNG 格式选择、逐页导出、清晰度设置、批量下载和结果检查等流程,帮助用户稳定完成 PDF 图片化处理。

2026.09.30

80

26

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Hermes Agent中文文档
Hermes Agent中文文档

共0课时 | 0人学习