google-adk-go
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseGoogle 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.0Version Lock
版本锁定
- Confirm you are targeting ADK Go before applying patterns.
v0.6.0 - Read references/00-source-lock.md for commit pin, release date, and release notes.
- If the user asks for a newer version, stop and call out that this skill is intentionally pinned to .
v0.6.0
- 在应用相关模式前,确认你以ADK Go 为目标版本。
v0.6.0 - 阅读references/00-source-lock.md以获取提交固定信息、发布日期和发布说明。
- 如果用户询问更新版本,请告知用户本技能特意固定为版本,不再提供更高版本的内容。
v0.6.0
Fast Path
快速路径
- Start with references/01-quickstart.md to scaffold a minimal runnable app.
- Use references/12-cookbook.md for copy-ready patterns.
- Pull exact signatures and field behavior from references/api-go-doc.md when implementing.
- 从references/01-quickstart.md开始,搭建一个最小可运行应用。
- 使用references/12-cookbook.md中的可直接复用模式。
- 实现时,从references/api-go-doc.md获取准确的签名和字段行为。
Workflow
工作流
- 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
- Choose persistence model:
- In-memory: references/05-state-session-memory-artifacts.md
- Database/Vertex AI session services: references/05-state-session-memory-artifacts.md
- 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
- 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
- Apply guardrails:
- Best practices checklist: references/10-best-practices.md
- Failure handling: references/11-troubleshooting.md
- 选择应用形态:
- 单LLM Agent:references/03-llm-agent-config.md
- 多Agent工作流:references/06-workflow-and-multi-agent.md
- 工具密集型设计:references/04-tools.md
- 选择持久化模型:
- 内存内存储:references/05-state-session-memory-artifacts.md
- 数据库/Vertex AI会话服务:references/05-state-session-memory-artifacts.md
- 选择服务接口:
- 控制台/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
- 添加跨领域关注点:
- 插件和回调:references/08-plugins-telemetry.md
- 遥测设置:references/08-plugins-telemetry.md
- Cloud Run部署CLI:references/09-deployment-cloudrun.md
- 应用防护措施:
- 最佳实践清单: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
- deployment command: references/09-deployment-cloudrun.md
adkgo - 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 : references/api-go-doc.md
go doc -all - Example inventory from : references/examples-index.md
examples/
- 架构和执行模型: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
- 部署命令:references/09-deployment-cloudrun.md
adkgo - 生产环境指南:references/10-best-practices.md
- 调试和常见问题:references/11-troubleshooting.md
- 现成可用的方案:references/12-cookbook.md
- 来自的原始导出包文档:references/api-go-doc.md
go doc -all - 中的示例清单:references/examples-index.md
examples/
Operating Rules
操作规则
- Keep code and commands pinned to unless the user explicitly requests upgrading.
v0.6.0 - Prefer patterns already present in official and exported package docs.
examples/ - Call out behavior that is marked experimental in source comments (for example, tool confirmation wrappers).
- For uncertain behavior, verify against references/api-go-doc.md before coding.
- 除非用户明确要求升级,否则代码和命令均固定为版本。
v0.6.0 - 优先使用官方和导出包文档中已有的模式。
examples/ - 标注出源代码注释中标记为实验性的行为(例如工具确认包装器)。
- 对于不确定的行为,在编码前需对照references/api-go-doc.md进行验证。