LangChain create_react_agent流仅输出首条AIMessage未完成推理求助

我按照LangChain官方SQL QA教程创建了可查询SQLite数据库的LLM ReAct Agent，核心代码如下：

agent_executor = create_react_agent(chat_model, tools, messages_modifier=system_message)

for s in agent_executor.stream(
    {"messages": [HumanMessage(content="Which country's customers spent the most?")]}
):
    print(s)
    print("----")

执行后，流输出仅停留在第一条AIMessage，未完成文档提及的完整推理过程，输出内容如下：

{'agent': {'messages': [AIMessage(content="To determine which country's customers spent the most, we need to look at the relevant tables in the database. First, let's list all the tables to understand the structure of the database.", additional_kwargs={'refusal': None}, response_metadata={'token_usage': {'completion_tokens': 36, 'prompt_tokens': 549, 'total_tokens': 585}, 'model_name': 'gpt-4o', 'system_fingerprint': 'fp_f5a70d8dc9', 'finish_reason': 'stop', 'logprobs': None}, id='run-fa55841d-026a-4bd9-9060-24740c0ec6ad-0', usage_metadata={'input_tokens': 549, 'output_tokens': 36, 'total_tokens': 585})]}}

请问是否有人能复现文档描述的完整结果？

可能的原因及解决方向 #

• 工具绑定不完整：确认tools是否正确包含SQL查询类工具（如QuerySQLDataBaseTool），且工具描述清晰，能引导Agent主动调用。工具未正确注册时，Agent会停留在思考阶段无法推进。
• System Prompt缺失引导：检查system_message是否明确告知Agent需通过调用工具完成任务，比如需包含“使用提供的工具获取数据库信息，完成多步推理后给出最终答案”这类指令，避免Agent仅停留在思考步骤。
• 执行模式适配问题：尝试用agent_executor.invoke()替代stream()测试，部分场景下stream()输出需要手动处理后续步骤触发，或存在异步配置问题导致流程中断。
• 模型配置限制：确认GPT-4o模型有足够上下文窗口和调用权限，部分模型可能因输出截断或权限问题无法完成多步推理，可切换到GPT-3.5-turbo验证是否能复现完整流程。
• 数据库连接有效性：检查SQLite数据库连接是否正常，工具能否正确访问表结构。若工具调用失败（如连接错误），Agent可能无法继续，可添加日志排查工具调用状态。

复现验证 #

按教程步骤操作时，确保以下几点可复现完整推理流程：

1. 正确初始化SQLDatabase实例并绑定到QuerySQLDataBaseTool
2. System Prompt包含ReAct推理逻辑的明确引导（参考教程默认prompt）
3. 使用agent_executor.invoke()执行查询，能观察到Agent依次调用工具列表面、查询表结构、执行聚合查询，最终输出结果

内容的提问来源于stack exchange，提问作者amikhou