adk-agent-builder
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseADK Agent Builder
ADK Agent 构建器
Read only the reference that matches the task. Loading the whole tree costs
context and buries the part that matters.
Every API below was checked against 2.6.2. If a symbol is missing
at runtime, read the source under rather than guessing a
neighbouring name.
google-adksrc/google/adk/仅阅读与任务匹配的参考资料。加载整个目录树会消耗上下文,并掩盖关键内容。
以下每个 API 均已针对 2.6.2 进行验证。如果运行时缺少某个符号,请阅读 下的源代码,而不要猜测相近的名称。
google-adksrc/google/adk/Start here
从这里开始
| Task | Reference |
|---|---|
First agent, environment, | getting-started.md |
| Which import path is the canonical one | import-paths.md |
| The rules that cause most runtime failures | best-practices.md |
| 任务 | 参考资料 |
|---|---|
首个 Agent、环境、 | getting-started.md |
| 规范的 import path | import-paths.md |
| 最容易导致运行时失败的规则 | best-practices.md |
Building blocks
构建组件
- tool-catalog.md — function tools, MCP, OpenAPI,
Google API toolsets, built-in tools, custom and
BaseTool.BaseToolset - function-nodes.md — plain functions as nodes:
parameter resolution, generators, typing rules.
node_input - llm-agent-nodes.md — an used as a workflow node: output types, instruction templates,
LlmAgent, auto-wrapping behavior.output_schema - task-mode.md — and
mode='task'delegation with schema-validated input and output.mode='single_turn'
- tool-catalog.md——函数工具、MCP、OpenAPI、
Google API toolset、内置工具、自定义 和
BaseTool。BaseToolset - function-nodes.md——将普通函数用作节点:
参数解析、生成器、类型规则。
node_input - llm-agent-nodes.md——将 用作 工作流节点:输出类型、指令模板、
LlmAgent、自动包装行为。output_schema - task-mode.md——使用 和
mode='task'进行委派,并对输入和输出进行 schema 校验。mode='single_turn'
Graph orchestration
图编排
- routing-and-conditions.md — routed edges, dict routing maps, default routes, self-loops, revision loops.
- parallel-and-fanout.md — fan-out edges,
fan-in,
JoinNodelist processing.parallel_worker=True - dynamic-nodes.md — scheduling nodes at runtime
with and imperative workflow construction.
ctx.run_node() - human-in-the-loop.md — , resume behavior, resumable vs replayed sessions.
RequestInput - advanced-patterns.md — nested workflows,
retries, custom subclasses, graph validation rules.
BaseNode - multi-agent.md — chat-transfer hierarchies, and
the deprecated /
SequentialAgent/LoopAgentshells thatParallelAgentreplaces.Workflow
- routing-and-conditions.md——路由边、 字典路由映射、默认路由、自循环、修订循环。
- parallel-and-fanout.md——fan-out 边、
fan-in、
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
Runtime and verification
运行时与验证
- state-and-events.md — the object,
Contextfields, and how state flows between nodes.Event - session-and-state.md — session services, artifacts, memory, and state key scoping.
- callbacks-and-plugins.md — the six agent callbacks and app-level plugins.
- testing.md — with
pytest, faking a model, asserting on node output.InMemoryRunner
- state-and-events.md——对象、
Context字段,以及状态如何在节点之间流转。Event - session-and-state.md——会话服务、 artifact、memory,以及状态键的作用域。
- callbacks-and-plugins.md——六种 Agent callback 和应用级 plugin。
- testing.md——使用 配合
pytest、模拟模型、对节点输出进行断言。InMemoryRunner