Google ADK Agent部署报错：'ModuleAgent'无'agent_framework'属性

问题 #

部署Google ADK Agent到Agent Engine时触发错误：

Traceback (most recent call last): AttributeError: 'ModuleAgent' object has no attribute 'agent_framework'

本地通过adk run可正常运行，但CLI部署、GitHub部署均出现该错误。

相关代码与配置 #

Agent代码（agent.py） #

from google.adk.agents import Agent
from google.adk.tools import google_search
from dotenv import load_dotenv

load_dotenv()

# Define the agent
root_agent = Agent(
    name="google_news_agent",
    model="gemini-2.5-flash",
    instruction="Look for all the latest news in the internet and provide a crisp summary based on the topic",
    description="An agent that uses Google Search to fetch up-to-date news",
    #tools=[google_search]  # Built-in Google Search tool
)

.env配置 #

# If using Gemini via Vertex AI on Google CLoud
GOOGLE_CLOUD_PROJECT="<my-project>"
GOOGLE_CLOUD_LOCATION="us-central1" 
GOOGLE_GENAI_USE_VERTEXAI="True"

__init__.py文件 #

from . import agent

部署命令 #

adk deploy agent_engine academic_research \
    --project="<my-project-id>" \
    --region="us-central1" \
    --staging_bucket="gs://adk-agent-deploy-bucket" \
    --display_name="academic_research"

解决方案 #

1. 修正__init__.py导出逻辑 #

ADK需要明确导出Agent实例，而非仅导入模块。修改__init__.py为：

from .agent import root_agent

2. 对齐部署命令与代码中的代理名称 #

部署命令指定的代理名必须和代码中Agent类的name字段一致，调整部署命令：

adk deploy agent_engine google_news_agent \
    --project="<my-project-id>" \
    --region="us-central1" \
    --staging_bucket="gs://adk-agent-deploy-bucket" \
    --display_name="Google News Agent"

3. （可选）启用工具配置 #

若需使用Google Search功能，取消代码中tools=[google_search]的注释，确保代理功能完整。

验证 #

1. 本地执行adk run google_news_agent确认代理正常运行
2. 重新执行修正后的部署命令
3. 登录Agent Engine控制台，检查代理部署状态

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