📖 日志 是什么？

⚡ 一句话秒懂

像飞机的黑匣子：平时没人看，出事时靠它还原现场。

📖 举个故事

小赵的 Agent 一直跑得好好的，忽然有用户投诉“回复变慢了”，代码没报错，谁都说不出原因。他打开日志一看：每天凌晨 3 点都有一批慢请求——原来是定时任务和用户请求挤在一起抢资源。没日志只能靠猜，有日志几分钟就定位。就像超市的监控录像：平时没人看，丢了东西回放一下，谁拿的一目了然。

💡 类比理解

暂未补充。

🧩 真实例子

暂未补充。

🛠️ 怎么实际使用

在 Agent 每个关键步骤打日志：收到什么输入、调用了哪个工具、工具返回什么、最终输出什么。用 Python logging 配好格式：时间、级别、事件。DEBUG 记细节，INFO 记关键节点，ERROR 记异常。给每次对话生成 request_id 贯穿所有日志，线上排查时 grep 这个 ID，就能把一次请求的完整链路串起来，一眼看出哪一步最慢。

📚 进阶原理

好日志三要素：结构化（JSON 格式，机器可解析）、分级（DEBUG/INFO/WARNING/ERROR，按级别路由到不同输出）、可关联（trace_id/request_id 贯穿一次请求全链路）。别用 print，用 logging 模块，支持 Handler 配置。生产环境建议集中收集到 Loki/ELK 并给 ERROR 设告警。注意脱敏：API Key、手机号等敏感信息绝不能进日志。

继续学习相关术语