避坑要点包括：不要混淆LangChain、LangGraph和DeepAgent的职责边界；不要在没有理解同步异步差异的情况下盲目追求异步；预编译复用要结合实际调用频率评估收益，低频子智能体强行预编译反而增加维护成本。