AI Agent日志最佳实践：把Agent的思考过程记下来

📘 教程 2026-07-16 约 1 分钟阅读

Agent出错了你不知道它怎么想的。好的日志记录Agent的每一步思考、工具调用、决策原因——调试利器。

💡 你将学到

Agent出错了你不知道它怎么想的。好的日志记录Agent的每一步思考、工具调用、决策原因——调试利器。

📜 目录

Agent日志跟普通日志不一样
必须记录的字段
日志格式
不要记录敏感信息
总结
相关文章

Agent日志跟普通日志不一样

普通日志：记录事件（"用户登录成功"）。 Agent日志：记录思考过程（"用户问天气→判断需要查API→调用weather_api→提取温度数据→生成回复"）。

必须记录的字段

字段	示例
用户输入	"今天北京热吗？"
Agent思考链	"用户想知道北京温度→需要weather API→提取city=北京"
工具调用	"weather_api(city='北京') → 返回32°C"
最终输出	"北京今天32°C，比较热，建议穿短袖。"
Token消耗	输入: 342, 输出: 128
耗时	3.2s

日志格式

{
  "session_id": "sess_abc123",
  "timestamp": "2026-07-16T10:30:00Z",
  "user_input": "...",
  "steps": [
    {"step": 1, "action": "reasoning", "content": "用户想知道天气"},
    {"step": 2, "action": "tool_call", "tool": "get_weather", "args": {"city": "北京"}, "result": "32°C"},
    {"step": 3, "action": "output", "content": "北京今天32°C"}
  ],
  "total_tokens": 470,
  "duration_ms": 3200
}