LangGraph中CompiledGraph调用后intermediate_steps不完整问题解析

在LangGraph项目开发过程中，我们遇到了一个关于Agent执行流程的有趣问题：当使用CompiledGraph调用结构化聊天Agent时，playground界面无法正确显示中间步骤(intermediate_steps)信息。这个问题涉及到LangGraph的核心工作流机制，值得深入探讨。

问题背景

在构建基于LangGraph的React风格Agent时，开发者设计了一个包含多个节点的执行图：

1. Agent节点：负责决策和生成动作
2. Action节点：负责执行工具调用
3. 条件边缘：根据Agent输出决定继续执行还是结束

当这个工作流被编译(compile)后，通过playground界面测试时，虽然Agent能够正常执行搜索等操作，但关键的中间步骤信息却没有在输出中显示。

技术分析

深入代码实现，我们可以发现几个关键点：

1. 状态管理：AgentState类型定义中，intermediate_steps字段被标记为可累加(Annotated)，这意味着每次工具执行结果都应该被追加到这个列表中。

2. 工作流设计：工作流正确设置了节点间的依赖关系，包括条件分支和普通边缘，理论上应该能够完整记录执行过程。

3. 版本因素：问题最终在升级到LangGraph 0.0.32版本后解决，这表明这可能是一个已知的框架级问题。

解决方案

经过排查，正确的解决方法是：

1. 版本升级：确保使用LangGraph 0.0.32或更高版本
2. 配置补充：在调用CompiledGraph时显式添加配置信息

# 升级后正确的调用方式
response = self._workflow_complied.with_config(config).invoke({
    "input": input["input"],
    "chat_history": [],
})

深入理解

这个问题的本质在于工作流执行时的上下文保持机制。在早期版本中，CompiledGraph可能没有正确处理状态对象的传递，导致中间步骤信息在流程结束后丢失。新版本通过改进状态管理机制，确保了执行上下文的完整性。

对于开发者来说，这提醒我们在使用LangGraph构建复杂工作流时需要注意：

1. 状态对象的生命周期管理
2. 版本兼容性问题
3. 配置信息的完整传递

最佳实践

基于这个案例，我们总结出以下LangGraph开发建议：

1. 始终使用最新稳定版本
2. 对于状态敏感的操作，显式验证中间状态
3. 复杂工作流应包含完整的配置传递链
4. 在playground测试前，先进行单元测试验证核心逻辑

这类问题的解决不仅修复了功能缺陷，也加深了我们对LangGraph内部工作机制的理解，为构建更可靠的AI应用奠定了基础。