adk-agent-builder

ADK Agent 构建器

只阅读与任务相关的参考文档。加载整个目录树会占用上下文，并掩盖真正重要的内容。

以下每个 API 均已针对 google-adk 2.6.2 验证。如果某个符号在运行时缺失，请阅读 src/google/adk/ 下的源代码，而不要猜测名称相近的符号。

从这里开始

任务	参考文档
创建第一个 Agent、配置环境、使用 adk CLI	getting-started.md
哪个导入路径才是规范路径	import-paths.md
导致大多数运行时故障的规则	best-practices.md

构建模块

• tool-catalog.md — 函数工具、MCP、OpenAPI、Google API 工具集、内置工具、自定义 BaseTool 和 BaseToolset。
• function-nodes.md — 将普通函数用作节点：参数解析、生成器、node_input 类型规则。
• llm-agent-nodes.md — 将 LlmAgent 用作工作流节点：输出类型、指令模板、output_schema、自动包装行为。
• task-mode.md — 使用经过架构验证的输入和输出，通过 mode='task' 和 mode='single_turn' 进行委派。

图编排

• routing-and-conditions.md — 路由边、字典路由映射、默认路由、自循环、修订循环。
• parallel-and-fanout.md — 扇出边、JoinNode 扇入、parallel_worker=True 列表处理。
• dynamic-nodes.md — 使用 ctx.run_node() 在运行时调度节点，以及命令式工作流构建。
• human-in-the-loop.md — RequestInput、恢复行为、可恢复会话与重放会话。
• advanced-patterns.md — 嵌套工作流、重试、自定义 BaseNode 子类、图验证规则。
• multi-agent.md — 聊天移交层级，以及已弃用的 SequentialAgent / LoopAgent / ParallelAgent 外壳；这些外壳已由 Workflow 取代。

运行时与验证

• state-and-events.md — Context 对象、Event 字段，以及状态如何在节点间流转。
• session-and-state.md — 会话服务、制品、记忆，以及状态键作用域。
• callbacks-and-plugins.md — 六种 Agent 回调和应用级插件。
• testing.md — 使用 InMemoryRunner 进行 pytest 测试、模拟模型、断言节点输出。