附录B 附录 常见坑与排查

坑1：AI 不调工具 原因：工具 docstring 太模糊。 解决：写清"何时调用 + 参数格式"，并在系统提示里强调"必须调工具"。

坑2：无限循环调工具 原因：工具返回信息 AI 看不懂，又去调。 解决：设 recursion_limit，工具返回写清"请用以上结果回答"。

坑3：interrupt 用不了 原因：没挂 Checkpointer。 解决：compile(checkpointer=...) 后再用 interrupt()。

坑4：重启后记忆没了 原因：用了 InMemorySaver。 解决：生产换 SqliteSaver 或 PostgresSaver。

坑5：Postgres 报 thread_id 过长 原因：thread_id 超 255 字符。 解决：用 str(uuid.uuid4())。