深入解析ADK-Python项目中Agent初始化错误及解决方案

在ADK-Python项目1.0.0版本中，开发者在使用LlmAgent与MCPToolset集成时可能会遇到一个常见的初始化错误。本文将详细分析这个问题的根源，并提供正确的实现方式。

问题现象

当开发者尝试创建一个LlmAgent实例并与MCPToolset工具集集成时，如果采用异步方式初始化，运行时会抛出"'coroutine' object has no attribute 'sub_agents'"的错误。这个错误通常发生在调用adk web命令启动服务后，尝试发送消息给LLM之前。

错误原因分析

这个问题的根本原因在于1.0.0版本中ADK-Python框架对Agent初始化的处理方式发生了变化。在0.5.0版本中，异步初始化方式是可行的，但在1.0.0版本中，框架期望Agent能够直接提供sub_agents属性，而异步协程对象显然不具备这个属性。

具体来说，错误发生在框架内部尝试获取所有工具集时，它期望通过访问agent.sub_agents来遍历子代理，但由于我们的root_agent实际上是一个协程对象（因为使用了async def定义的函数），而不是真正的Agent实例，所以导致了属性访问失败。

解决方案

根据ADK-Python 1.0.0版本的官方推荐做法，正确的实现方式应该是直接实例化LlmAgent，并将MCPToolset作为工具列表的一部分传入，而不是使用异步工厂函数。以下是正确的代码实现：

from google.adk.agents.llm_agent import LlmAgent
from google.adk.models.lite_llm import LiteLlm
from google.adk.tools.mcp_tool.mcp_toolset import MCPToolset, SseServerParams

root_agent = LlmAgent(
    model="gemini-2.0-flash",
    name="enterprise_assistant",
    instruction="You are a powerful AI assistant.",
    tools=[
        MCPToolset(connection_params=SseServerParams(url="http://localhost:8888/sse"))
    ],
)

版本兼容性说明

值得注意的是，这个问题在ADK-Python 0.5.0版本中不会出现，因为旧版本对Agent初始化的处理方式不同。这也是为什么一些从旧版本迁移过来的开发者会遇到这个问题的原因。在升级到1.0.0版本时，需要特别注意初始化方式的变更。

最佳实践建议

1. 直接实例化：除非有特殊需求，否则建议直接实例化Agent类，而不是使用工厂函数
2. 工具集配置：将MCPToolset直接作为工具列表的一部分传入，框架会处理后续的初始化工作
3. 版本检查：在升级ADK版本时，务必检查初始化代码是否需要相应调整

通过采用这种标准的初始化方式，开发者可以避免异步初始化带来的问题，同时也使代码更加简洁和易于维护。这种模式也更符合ADK框架的设计理念，即将复杂的基础设施处理隐藏在框架内部，让开发者能够专注于业务逻辑的实现。