SOLA AI Agent 共学营 · 补充材料

Agent 表现不好怎么排查

五个症状覆盖了日常 90% 的问题，排查逻辑都是一样的：

先查 context 满没满（/status）——这是最常见的根因。context 超过 80% 之后 Agent 的所有行为都会开始走样，不管是读错文件、漏用技能、还是数据不对，都可能是 context 溢出的症状。解法最简单：开新会话。

再查文件读对没读对——直接问 Agent "你读了哪些文件"。大部分时候不是 Agent 能力不行，而是它压根没看到你想让它看的文件（文件名不直观、目录太深、或者你忘了上传）。

然后查技能和指令——/skills 确认技能加载了，再让 Agent 列出"你当前遵守哪些规则"排查指令冲突。CLAUDE.md 里的规则、Skill 里的规则、你口头说的指令三层可能互相矛盾。

最后查数据来源——让 Agent 打印计算过程。如果它给不出"我是用 pandas 从 CSV 第 3 列求和得到 342 万"这样的过程，说明它是在"编"不是在"算"。Skill 里写死"数据必须用代码计算"能从根本上防止这个问题。

最实用的一招：直接问 Agent。 "你为什么这么做""你读了什么""你 context 里有什么"——它能回答自己行为的大部分问题。不需要先翻日志，先问它，答案可疑时再查底层。

从 agent-depth.html 主课件正文抽取生成，用于替代缺失的嵌入材料页面。