Google ADK-Python项目中AgentTool参数传递问题解析

在Google ADK-Python项目(一个用于构建AI代理的开发工具包)中，开发者在使用AgentTool时可能会遇到一个常见问题：当将Agent包装为工具使用时，调用参数无法正确传递给被包装的Agent。本文将深入分析这一问题，并提供解决方案。

问题现象

当开发者将一个Agent实例通过AgentTool包装后作为工具使用时，发现只有系统指令被传递给了被包装的Agent，而调用时传入的参数却丢失了。具体表现为：

1. 主Agent正确调用了工具Agent
2. 工具Agent收到了系统指令
3. 但工具Agent没有收到主Agent传递的参数内容

问题根源

经过分析，这个问题主要由以下几个因素共同导致：

1. AgentTool的设计机制：Agent作为工具使用时，其参数传递机制与常规工具不同
2. 指令设计不明确：主Agent的指令中包含了硬编码的文件名("abcd")，与动态传入的参数("aaaa")产生冲突
3. 输入模式不清晰：工具Agent没有明确定义输入模式(input_schema)，导致参数传递不规范

解决方案

方案一：优化指令设计

主Agent的指令需要更加明确，确保它能够正确地将参数传递给工具Agent：

agent = Agent(
    name="agent",
    model="gemini-2.5-flash-preview-04-17",
    instruction=(
        "使用'tool_agent'工具来回应提供的文件名。"
        "当使用'tool_agent'工具时，确保总是告诉它你收到的文件名。"
    ),
    tools=[AgentTool(tool)],
)

方案二：明确定义输入模式

为工具Agent设置input_schema，明确参数传递规范：

tool = Agent(
    name="tool_agent",
    model="gemini-2.5-flash-preview-04-17",
    instruction="你是一个用于回应文件名的工具",
    description="一个回应文件名的工具",
    include_contents="none",
    input_schema={"request": str}  # 明确定义输入参数类型
)

方案三：规范消息传递格式

调用时使用更清晰的消息格式：

async for event_item in runner.run_async(
    user_id="a",
    session_id=session_id,
    new_message=types.Content(
        role="user", 
        parts=[types.Part(text="回应以下文件名: aaaa")]
    ),
):

最佳实践建议

1. 避免硬编码：不要在系统指令中硬编码具体参数值
2. 明确指令：确保指令清晰地说明如何处理和传递参数
3. 定义输入模式：为工具Agent明确定义input_schema
4. 统一消息格式：保持消息传递格式的一致性和明确性
5. 测试验证：在开发过程中，通过日志验证参数是否正确传递

通过以上方法，开发者可以确保AgentTool能够正确地将参数传递给被包装的Agent，实现预期的功能交互。