google-agents-cli-adk-code

ADK 代码参考

首先启用 /google-agents-cli-workflow，以了解必需的开发阶段和脚手架步骤。

1. 学习示例（无需项目）

Python — 在回答“如何构建 X”之前，先阅读 references/samples.md 中的主题索引。 其中提供了可直接参考的实现，涵盖：沙盒化／按用户隔离的代码执行、可由 Agent 加载的 SKILL.md 技能、跨会话记忆、针对高风险操作的审批关卡、工具防护、按用户配置凭据，以及定时／事件驱动的运行。

Go — 阅读上游 examples/。 克隆代码库，并在实现前阅读与所需功能匹配的示例。

2. 编写代码的前提条件

在完成项目脚手架搭建之前，切勿编写 Agent 代码。

1. 验证项目：运行 agents-cli info（如果配置存在，则继续）。
2. 新建项目：运行 agents-cli scaffold create <name> --agent adk --deployment-target <target> — Go 项目使用 --agent adk_go。
3. 已有代码：运行 agents-cli scaffold enhance .。

快速参考 — 最常见的模式

Python 和 Go 代码示例分别见 references/adk-python.md 和 references/adk-go.md。

---

参考资料

常见模式请查阅速查表。如需深入了解，请获取文档索引或检查已安装的软件包。

参考资料	语言	何时阅读
references/samples.md	Python	按主题索引的 ADK 参考示例目录。 在工作流第 1 阶段阅读 — 在搭建脚手架和编写代码之前 — 用于将某项功能与实现它的示例对应起来。
references/adk-python.md	Python	ADK 核心 API：Agent、工具、回调、插件、状态、制品、多 Agent 系统、SequentialAgent / ParallelAgent / LoopAgent、自定义 BaseAgent、ManagedAgent（由服务端托管的一方 Agent）、A2A 协议、A2UI。适用于大多数 Agent。
references/adk-python-workflows.md	Python	基于图的 Workflow API（ADK Python 2.0）：节点、边、扇出／扇入、HITL、并行处理。需要显式定义图拓扑时使用。
references/adk-python-live.md	Python	实时和语音 Agent：Runner.run_live、LiveRequestQueue、模型和区域可用性、语音／speech_config、VAD、会话限制、/run_live 服务。适用于实时语音或视频 Agent。
references/adk-go.md	Go	ADK Go 核心 API：llmagent、工具、回调、插件、状态、制品、多 Agent 系统、顺序／并行／循环 Agent、自定义 Agent、运行器、通过 HTTP 提供服务、A2A 协议，以及环境触发器。适用于大多数 Agent。
references/adk-go-workflows.md	Go	基于图的 Workflow API：节点、边、扇出／扇入、HITL、并行处理。需要显式定义图拓扑时使用。
examples/	Go	可运行的上游程序 — 是 Go 示例目录中最接近配方目录的内容。
curl https://adk.dev/llms.txt	Python	文档索引（包含每个页面的标题和 URL）。获取该索引，然后对于速查表未涵盖的内容，使用 WebFetch 获取相应页面。
已安装的 ADK 软件包	Python	准确的签名和符号 — 检查源代码（参见 references/adk-python.md 中的“检查 ADK 源代码”）。

相关技能

• /google-agents-cli-workflow — 开发工作流、编码指南和操作规则
• /google-agents-cli-scaffold — 使用 agents-cli scaffold create / scaffold enhance 创建和增强项目
• /google-agents-cli-eval — 评估方法、数据集架构和评估修复循环
• /google-agents-cli-deploy — 部署目标、CI/CD 管道和生产工作流