google-adk-go

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Google ADK Go

Google ADK Go

Use this skill as the offline reference for
google.golang.org/adk@v0.6.0
.
将本技能作为
google.golang.org/adk@v0.6.0
的离线参考资料。

Version Lock

版本锁定

  1. Confirm you are targeting ADK Go
    v0.6.0
    before applying patterns.
  2. Read references/00-source-lock.md for commit pin, release date, and release notes.
  3. If the user asks for a newer version, stop and call out that this skill is intentionally pinned to
    v0.6.0
    .
  1. 在应用相关模式前,确认你以ADK Go
    v0.6.0
    为目标版本。
  2. 阅读references/00-source-lock.md以获取提交固定信息、发布日期和发布说明。
  3. 如果用户询问更新版本,请告知用户本技能特意固定为
    v0.6.0
    版本,不再提供更高版本的内容。

Fast Path

快速路径

  1. Start with references/01-quickstart.md to scaffold a minimal runnable app.
  2. Use references/12-cookbook.md for copy-ready patterns.
  3. Pull exact signatures and field behavior from references/api-go-doc.md when implementing.
  1. references/01-quickstart.md开始,搭建一个最小可运行应用。
  2. 使用references/12-cookbook.md中的可直接复用模式。
  3. 实现时,从references/api-go-doc.md获取准确的签名和字段行为。

Workflow

工作流

  1. Choose app shape:
  • Single LLM agent: references/03-llm-agent-config.md
  • Multi-agent workflow: references/06-workflow-and-multi-agent.md
  • Tool-heavy design: references/04-tools.md
  1. Choose persistence model:
  • In-memory: references/05-state-session-memory-artifacts.md
  • Database/Vertex AI session services: references/05-state-session-memory-artifacts.md
  1. Choose serving interface:
  • Console/web launchers and flags: references/07-serving-a2a-rest-web.md
  • REST routes and behavior: references/07-serving-a2a-rest-web.md
  • A2A local/remote agents: references/07-serving-a2a-rest-web.md
  1. Add cross-cutting concerns:
  • Plugins and callbacks: references/08-plugins-telemetry.md
  • Telemetry setup: references/08-plugins-telemetry.md
  • Cloud Run deploy CLI: references/09-deployment-cloudrun.md
  1. Apply guardrails:
  • Best practices checklist: references/10-best-practices.md
  • Failure handling: references/11-troubleshooting.md
  1. 选择应用形态:
  • 单LLM Agent:references/03-llm-agent-config.md
  • 多Agent工作流:references/06-workflow-and-multi-agent.md
  • 工具密集型设计:references/04-tools.md
  1. 选择持久化模型:
  • 内存内存储:references/05-state-session-memory-artifacts.md
  • 数据库/Vertex AI会话服务:references/05-state-session-memory-artifacts.md
  1. 选择服务接口:
  • 控制台/Web启动器和标志:references/07-serving-a2a-rest-web.md
  • REST路由和行为:references/07-serving-a2a-rest-web.md
  • A2A本地/远程Agent:references/07-serving-a2a-rest-web.md
  1. 添加跨领域关注点:
  • 插件和回调:references/08-plugins-telemetry.md
  • 遥测设置:references/08-plugins-telemetry.md
  • Cloud Run部署CLI:references/09-deployment-cloudrun.md
  1. 应用防护措施:
  • 最佳实践清单:references/10-best-practices.md
  • 故障处理:references/11-troubleshooting.md

Reference Map

参考地图

  • Architecture and execution model: references/02-architecture.md
  • LLM agent fields and callbacks: references/03-llm-agent-config.md
  • Tools, functiontool, MCP, confirmation: references/04-tools.md
  • State, sessions, memory, artifacts: references/05-state-session-memory-artifacts.md
  • Workflow agents and composition: references/06-workflow-and-multi-agent.md
  • REST, A2A, launchers: references/07-serving-a2a-rest-web.md
  • Plugins and telemetry: references/08-plugins-telemetry.md
  • adkgo
    deployment command: references/09-deployment-cloudrun.md
  • Production guidance: references/10-best-practices.md
  • Debugging and common mistakes: references/11-troubleshooting.md
  • Ready-made recipes: references/12-cookbook.md
  • Raw exported package docs from
    go doc -all
    : references/api-go-doc.md
  • Example inventory from
    examples/
    : references/examples-index.md
  • 架构和执行模型:references/02-architecture.md
  • LLM Agent字段和回调:references/03-llm-agent-config.md
  • 工具、FunctionTool、MCP、确认机制:references/04-tools.md
  • 状态、会话、内存、工件:references/05-state-session-memory-artifacts.md
  • 工作流Agent和组合:references/06-workflow-and-multi-agent.md
  • REST、A2A、启动器:references/07-serving-a2a-rest-web.md
  • 插件和遥测:references/08-plugins-telemetry.md
  • adkgo
    部署命令:references/09-deployment-cloudrun.md
  • 生产环境指南:references/10-best-practices.md
  • 调试和常见问题:references/11-troubleshooting.md
  • 现成可用的方案:references/12-cookbook.md
  • 来自
    go doc -all
    的原始导出包文档:references/api-go-doc.md
  • examples/
    中的示例清单:references/examples-index.md

Operating Rules

操作规则

  1. Keep code and commands pinned to
    v0.6.0
    unless the user explicitly requests upgrading.
  2. Prefer patterns already present in official
    examples/
    and exported package docs.
  3. Call out behavior that is marked experimental in source comments (for example, tool confirmation wrappers).
  4. For uncertain behavior, verify against references/api-go-doc.md before coding.
  1. 除非用户明确要求升级,否则代码和命令均固定为
    v0.6.0
    版本。
  2. 优先使用官方
    examples/
    和导出包文档中已有的模式。
  3. 标注出源代码注释中标记为实验性的行为(例如工具确认包装器)。
  4. 对于不确定的行为,在编码前需对照references/api-go-doc.md进行验证。