快速结论:在 AutoGen 的 GraphFlow 中,当某个节点上的助手代理配置了工具(tools)时,执行下一跳选人可能失败并抛出 RuntimeError: No available speakers found.,即使图中确实存在对应的边。排查时应优先检查该代理的工具调用结果是如何被当作消息处理的。
适用环境:工具为 AutoGen;Issue 中出现的是 GraphFlow 团队配合 DiGraphBuilder 构建的图,节点代理通过 create_assistant_agent 创建并配置了 tools。模型使用 gpt-4.1-mini。Issue 未确认操作系统、Python、CUDA、显卡等环境信息。
最快修复方案:暂无确认的一步修复方案。Issue 中有维护者怀疑问题与“工具结果被直接当作消息使用”有关,但该推测未在讨论中验证。
注意事项:维护者曾要求提供最小可复现代码,Issue 随后关闭,讨论中没有给出明确修复步骤;给出的代码片段是用户侧的组网示例,并非已验证的补丁。按推测方向排查时不要将其视为官方结论。
问题场景
用户在使用 AutoGen 构建 GraphFlow 团队:用 DiGraphBuilder 为多个助手代理(如 spock_dataset、spock_explore_dataset、spock_explore_fields、spock_write_query 等)逐个 add_node,再按配置中的 edges 添加有向边,最后 GraphFlow(self.agents, graph=graph, termination_condition=termination) 执行。每个代理通过 tools_allow_list 过滤并挂载工具。用户反馈:只要代理带有工具,GraphFlow 在寻找下一个发言者时就报错,尽管该边在图中存在。
报错原文
RuntimeError: No available speakers found.
原因分析
可能原因:Issue 中维护者的判断是“问题可能与工具调用结果(tool results)被直接当作消息(message)使用有关”。也就是说,在工具调用场景下,进入下一跳选人逻辑时消息的形态可能不符合 GraphFlow 的预期,导致它无法在当前节点上匹配到可用的下一发言者,从而抛出 RuntimeError: No available speakers found.,即使图中已为该节点声明了出边。该方向属于讨论中的推测,尚未经最小复现或代码修复确认。
环境排查
- 确认 AutoGen 版本,以及是否使用 GraphFlow + DiGraphBuilder 组网。
- 确认触发报错的节点代理是否配置了
tools(例如通过filter_tools和非空tools_allow_list挂载)。 - 确认图中该节点确实存在指向下一节点的边,且条件(condition)在运行时能够满足;用户代码中会打印 nodes、edges、start/leaf nodes、是否有环等信息,可对照日志核对。
- 对照带工具节点与不带工具节点的行为差异,帮助定位是否与工具结果消息有关。
- Issue 未涉及 Python、CUDA、PyTorch、显卡等版本,不需要作为本问题的排查项。
解决步骤
- 在复现环境中保留组网日志,确认报错发生前执行到的代理节点,以及该节点在图中声明的出边和条件。
- 观察报错节点是否恰好是配置了工具、并刚执行过工具调用的节点,缩小问题范围。
- 可优先尝试:将该节点上的工具调用/工具结果处理路径作为排查重点,检查工具结果是否被直接作为消息送入后续选人逻辑;这是维护者在 Issue 中提出的怀疑方向。
- 按维护者要求整理一个最小可复现代码:最少节点数、至少一个带工具的节点、一条出边,提交到 Issue 以便确认。当前 Issue 讨论中没有提供已验证的修复步骤。
验证方法
在应用任何调整后重新运行同一 GraphFlow 流程:应不再出现 RuntimeError: No available speakers found.,并且流程能从带工具的节点按图中声明的边正常进入下一节点。由于 Issue 未给出确认的修复方案,以上验证方式仅用于判断问题是否仍可复现。
参考来源
AI 工具推荐
想把多个 AI 模型放在一个入口?
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。
推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。
这个方案解决了吗?
可以继续搜索完整报错,或查看同一工具的其他排查指南。

![[Bug]: #67743 — LLaVA-OneVision crashes when videos have different frame counts](https://www.chat-gpts.plus/wp-content/uploads/2026/11/68004-44174f4e-768x403.jpg)
