调试与优化

创建一个 Agent 可能十分钟就搞定了，但真正费劲的是后面的养成期。这个过程很像带一个新员工 — 入职第一天不能指望它什么都做好。

迭代开发流程

1. 先跑起来 — 第一版指令只写最核心的步骤，不追求完美
2. 观察结果 — 看 Agent 的执行结果，记录哪里不符合预期
3. 修正边界 — 你总会漏掉一些没想到的边界情况，逐步补充
4. 定期复盘 — 经常性地验证 Agent 的执行结果，评估它的必要性
5. 果断清理 — 如果觉得某个 Agent 可有可无，就删掉它。否则时间一长，推送通知太多，有用信息和噪音就分不清了

记忆页面模式

给 Agent 创建一个专用的记忆页面：

• Agent 每次执行前先读一遍，了解历史上下文
• 执行完后把关键信息写回去
• 相当于用 Notion 页面充当 Agent 的外部记忆
• 内容不用写得好看，真实准确就行

通过一次次小调整，逐步把一个粗糙的 Agent 磨成真正靠谱的虚拟员工。

常见问题排查

Agent 没有按预期触发

• 检查触发器设置是否正确
• 确认页面访问权限没有丢失（权限偶尔会静默失效）
• 查看 Agent 的执行日志

Agent 执行结果不理想

• 检查指令是否足够清晰和具体
• 确认 Agent 能访问到所需的数据库和页面
• 考虑换用更高端的模型
• 检查知识库内容是否覆盖了相关场景

Credits 消耗异常

• 查看是否有 Agent 被频繁误触发
• 检查指令是否加载了不必要的上下文
• 考虑使用路由模式减少无效触发

权限静默失效

• 表面上 Agent 正常挂着，实际已停摆
• 没有错误提示，需要主动检查执行日志
• 解决方法：重新授权相关页面的访问权限