智能体框架定制开发的常见反模式定制智能体框架时隐藏全局状态和吞掉工具错误会让排障失去入口。状态应随会话显式传递工具失败应有类型化结果。给工具调用设边界限制每轮调用次数、总时长和可访问资源。需要重试时先确认操作幂等再保存每次尝试的原因。把反例留在测试中用缺少参数、返回无效格式和工具断连的案例验证框架行为。不要依靠日志文本猜测执行是否完成。