一、从一次深夜调试说起上周三凌晨两点，我在给一个客户演示前的最后一轮测试中遇到了诡异的问题：Agent明明收到了用户查询，却始终卡在“思考中”状态，不输出任何动作。日志里只有一句“Agent stopped due to iteration limit”。折腾半小时才发现，我忘记给Agent的工具调用设置超时机制——它内部陷入了一个自循环的决策死结。这个坑让我意识到，很多教程只教如何拼装Agent的组件，却很少提生产环境中的“暗礁”。今天我们就用LangChain动手搭一个能实际运行的Agent，重点聊那些文档里不写、但实际开发中一定会遇到的细节。二、环境准备：别在版本上栽跟头# requirements.txt 关键版本锁定langchain==0.1.0# 注意：1.0版本API变化很大，新手建议先用0.xopenai==1.6.1python