Agent 错误日志记录器

记录 Agent 犯过的错误，避免重复踩坑。

功能

• - 自动记录: 任务失败时自动记录错误详情
• 模式识别: 识别重复出现的错误模式
• 主动提醒: 新任务前检索相似错误，提前预警
• 统计分析: 按月/类型统计错误分布

文件结构

workspace/memory/
├── error-patterns.md # 错误模式索引（长期）
└── error-log-YYYY-MM.md # 月度详细日志

使用方式

1. 记录错误

markdown
用户：记录一个错误，刚才发布小红书失败了

Agent: 好的，请告诉我：

1. 1. 任务是什么？
2. 具体错误是什么？
3. 原因是什么？
4. 怎么修正的？

或者我帮你从对话中提取这些信息？

2. 查询错误

markdown
用户：查一下之前发布失败的错误
用户：有没有类似的文件校验错误？
用户：显示所有 #网络超时 的错误

3. 主动提醒

markdown
Agent: 等一下，我查一下错误日志...
上次发布小红书失败是因为图片文件不存在。
这次请确认：
✓ 图片文件路径是否正确
✓ 如果是 URL，需要先下载
✓ 文件权限是否可读

错误记录格式

markdown

错误 #XXX - 简短描述

• - 时间: YYYY-MM-DD HH:MM
• 任务: 任务描述
• 错误: 具体错误信息
• 原因: 根本原因分析
• 修正: 修正方案
• 模式标签: #标签 1 #标签 2
• 相似错误: 关联的错误编号

模式标签

脚本工具

record-error.sh

记录新错误：

bash
cd /path/to/agent-error-logger/scripts
python record_error.py \
--task 发布内容失败 \
--error 图片文件不存在 \
--cause 用户只提供了 URL，未下载 \
--fix 发布前先下载 URL 图片 \
--tags #文件校验 #图片处理

search-errors.sh

查询错误：

bash
python search_errors.py --tag #文件校验 --limit 5
python search_errors.py --keyword 关键词 --limit 10

monthly-report.sh

生成月度报告：

bash
python monthly_report.py --month YYYY-MM --output markdown

主动检查清单

在以下场景自动检索错误日志：

最佳实践

1. 1. 及时记录: 错误发生后立即记录，细节更准确
2. 详细分析: 不仅记录现象，还要分析根本原因
3. 标签规范: 使用统一标签，便于检索
4. 定期回顾: 每月回顾错误模式，更新检查清单
5. 主动提醒: 新任务前主动检索，避免重复错误

扩展建议

• - [ ] 自动从对话中提取错误信息
• [ ] 错误相似度计算（向量检索）
• [ ] 错误趋势分析（图表）
• [ ] 集成到 HEARTBEAT 自检
• [ ] 多 Agent 共享错误库

相关资源

• - Self-Refine: Iterative Refinement with Self-Feedback
• CoVE: Chain of Verification
• AgentDropoutV2: Dynamic Error Handling