RuntimeError: No available speakers found.

在 AutoGen 的 GraphFlow 中,当某个节点上的助手代理配置了工具(tools)时,执行下一跳选人可能失败并抛出 RuntimeError: No available speakers found. ,即使图中确实存在对应的边。排查时应优先检查该代理的工具调用结果是如何被当作消息处理的

快速结论:在 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、显卡等版本,不需要作为本问题的排查项。

解决步骤

  1. 在复现环境中保留组网日志,确认报错发生前执行到的代理节点,以及该节点在图中声明的出边和条件。
  2. 观察报错节点是否恰好是配置了工具、并刚执行过工具调用的节点,缩小问题范围。
  3. 可优先尝试:将该节点上的工具调用/工具结果处理路径作为排查重点,检查工具结果是否被直接作为消息送入后续选人逻辑;这是维护者在 Issue 中提出的怀疑方向。
  4. 按维护者要求整理一个最小可复现代码:最少节点数、至少一个带工具的节点、一条出边,提交到 Issue 以便确认。当前 Issue 讨论中没有提供已验证的修复步骤。

验证方法

在应用任何调整后重新运行同一 GraphFlow 流程:应不再出现 RuntimeError: No available speakers found.,并且流程能从带工具的节点按图中声明的边正常进入下一节点。由于 Issue 未给出确认的修复方案,以上验证方式仅用于判断问题是否仍可复现。

参考来源

microsoft/autogen #6523

GamsGo AI

AI 工具推荐

想把多个 AI 模型放在一个入口?

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。

这个方案解决了吗?

celebrityanime
celebrityanime
文章: 36448

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注