这是本文档旧的修订版！
Agent 的 7 个核心模块
| 模块 | 你要能回答的问题 | 常见坑 |
| Goal | 任务成功是什么样？失败边界是什么？ | 只写“帮我完成任务”，没有验收标准 |
| State | 当前任务状态、历史、工作区文件放哪里？ | 只依赖聊天历史，长任务一压缩就丢线索 |
| Context | 哪些信息进入模型？顺序和格式是什么？ | 把所有资料塞进上下文，导致干扰和成本暴涨 |
| Tools | 工具有哪些？schema、权限、错误如何描述？ | 工具名含糊、返回值太长、没有分页和重试 |
| Loop | 最大步数、停止条件、反思、恢复怎么做？ | 无限循环或过早停止 |
| Guardrails | 哪些动作需要确认？哪些输入不可信？ | 让模型自己决定安全边界 |
| Eval | 怎么证明它真的完成任务？ | 只有演示视频，没有可重复评测集 |
张叶安