adk-agent-builder

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

ADK 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
google-adk
2.6.2. If a symbol is missing at runtime, read the source under
src/google/adk/
rather than guessing a neighbouring name.
仅阅读与任务匹配的参考资料。加载整个目录树会消耗上下文,并掩盖关键内容。
以下每个 API 均已针对
google-adk
2.6.2 进行验证。如果运行时缺少某个符号,请阅读
src/google/adk/
下的源代码,而不要猜测相近的名称。

Start here

从这里开始

TaskReference
First agent, environment,
adk
CLI
getting-started.md
Which import path is the canonical oneimport-paths.md
The rules that cause most runtime failuresbest-practices.md
任务参考资料
首个 Agent、环境、
adk
CLI
getting-started.md
规范的 import pathimport-paths.md
最容易导致运行时失败的规则best-practices.md

Building blocks

构建组件

  • tool-catalog.md — function tools, MCP, OpenAPI, Google API toolsets, built-in tools, custom
    BaseTool
    and
    BaseToolset
    .
  • function-nodes.md — plain functions as nodes: parameter resolution, generators,
    node_input
    typing rules.
  • llm-agent-nodes.md — an
    LlmAgent
    used as a workflow node: output types, instruction templates,
    output_schema
    , auto-wrapping behavior.
  • task-mode.md —
    mode='task'
    and
    mode='single_turn'
    delegation with schema-validated input and output.
  • 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'
    和
    mode='single_turn'
    进行委派,并对输入和输出进行 schema 校验。

Graph orchestration

图编排

  • routing-and-conditions.md — routed edges, dict routing maps, default routes, self-loops, revision loops.
  • parallel-and-fanout.md — fan-out edges,
    JoinNode
    fan-in,
    parallel_worker=True
    list processing.
  • dynamic-nodes.md — scheduling nodes at runtime with
    ctx.run_node()
    and imperative workflow construction.
  • human-in-the-loop.md —
    RequestInput
    , resume behavior, resumable vs replayed sessions.
  • advanced-patterns.md — nested workflows, retries, custom
    BaseNode
    subclasses, graph validation rules.
  • multi-agent.md — chat-transfer hierarchies, and the deprecated
    SequentialAgent
    /
    LoopAgent
    /
    ParallelAgent
    shells that
    Workflow
    replaces.
  • routing-and-conditions.md——路由边、 字典路由映射、默认路由、自循环、修订循环。
  • parallel-and-fanout.md——fan-out 边、
    JoinNode
    fan-in、
    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
    Context
    object,
    Event
    fields, and how state flows between nodes.
  • 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 —
    pytest
    with
    InMemoryRunner
    , faking a model, asserting on node output.
  • state-and-events.md——
    Context
    对象、
    Event
    字段,以及状态如何在节点之间流转。
  • session-and-state.md——会话服务、 artifact、memory,以及状态键的作用域。
  • callbacks-and-plugins.md——六种 Agent callback 和应用级 plugin。
  • testing.md——使用
    pytest
    配合
    InMemoryRunner
    、模拟模型、对节点输出进行断言。