ADK 配方集

欢迎使用。这是一个公开的 ADK 示例集——这些小型、可运行的代理程序展示了如何使用 Agent Development Kit] 解决实际问题。您可以复制其中一个作为自己项目的起点，或浏览该集合以学习其中的设计模式。

无论您是在构建客服机器人、研究用代理，还是开发全新的功能，这里的示例都能为您提供可用的基础框架，而非空白的起点。

尝试一个示例

这些示例存放在两个地方：

core/ — 由 agents-cli 团队精心整理的规范型模式。这些小型且聚焦的示例能很好地教授某一特定主题（如 OAuth 流程、会话内存管理、约束规则、RAG 模式等）。
contrib/ — 由社区贡献的示例。其范围更广，每个示例都是针对特定用例或行业工作流程的独立范例。

每个示例都配有包含设置与运行说明的自己的 README.md。

先决条件

请从 ADK Get Started guide] 安装 ADK。所需的语言 SDK 包括：

贡献示例

首先参考 Recipe Checklist——仅一页纸，列出了发布示例所需的所有内容]。如果您需要更完整的背景信息及工具参考，Recipe Handbook] 中有更详细的说明。

Repo skills — 用于构建此代码库的 AI 编程辅助工具（如示例框架生成、清单文件创建、pyproject 对齐等功能）——存放在 .agents/skills/] 中。请注意，这要与 vertical skills 区分开来，后者是指通过 skills/<vertical>/<solution>/ 发送给用户的示例。

寻求帮助

请在 github.com/google/adk-samples/issues] 开启一个 GitHub 问题。

许可证

Apache 2.0 — 详情请参见 LICENSE]。

免责声明

这不是 Google 官方支持的产品，因此不符合 Google OSS Vulnerability Rewards Program] 的申请资格。这些示例仅用于演示和作为起点，不可用于实际生产环境。