Skip to content

贡献指南

感谢你对 Agent Development Kit (ADK) 项目的贡献兴趣!我们欢迎对核心框架、文档和相关组件的贡献,如下所列。

AI 智能体开发套件(Agent Development Kit, ADK)项目及其英文文档归属 Google 所有并维护。

本站为 ADK 文档的中文版本,由 ADK.Wiki 运营,内容由 ADK.Wiki 独立维护,并保持与上游文档google/adk-docs 保持同步更新。

本贡献指南不适用于当前中文版本内容改进。

本指南提供了如何参与的信息。

贡献前的准备

选择正确的代码仓库

ADK 项目分布在多个代码仓库中。找到适合你贡献的那个:

仓库 描述 详细指南
google/adk-python 包含核心 Python 库源代码 CONTRIBUTING.md
google/adk-python-community 包含社区贡献的工具、集成和脚本 CONTRIBUTING.md
google/adk-java 包含核心 Java 库源代码 CONTRIBUTING.md
google/adk-docs 包含你当前阅读的文档站点源代码 CONTRIBUTING.md
google/adk-web 包含 adk web 开发 UI 的源代码

这些仓库通常在其仓库根目录中包含一个 CONTRIBUTING.md 文件,其中提供了关于需求、测试、代码审查流程等特定组件的更详细信息。

签署 CLA

对本项目的贡献必须附有贡献者许可协议 (CLA)。

你(或你的雇主)保留对你贡献的版权;这只是给予我们使用和重新分发你的贡献作为项目一部分的许可。

如果你或你当前的雇主已经签署了 Google CLA(即使是为不同的项目),你可能不需要再次签署。

查看社区准则

参与讨论

有问题、想分享想法或讨论你如何使用 ADK?前往我们的 PythonJava 讨论区!

  • 向社区和维护者提出问题并获取帮助。
  • 分享你的项目或用例(Show and Tell)。
  • 在创建正式议题之前讨论潜在功能或改进。
  • 关于 ADK 的一般性对话。

如何贡献

有几种方式你可以为 ADK 做出贡献:

报告问题(错误和错误)

如果你在框架中发现错误或文档中的错误:

建议增强功能

有新功能的想法或对现有功能的改进?

改进文档

发现拼写错误、不清楚的解释或缺失的信息?直接提交你的更改:

编写代码

帮助修复错误、实现新功能或为文档贡献代码示例:

如何: 提交包含你代码更改的 Pull Request (PR)。

代码审查

  • 所有贡献,包括来自项目成员的贡献,都需要经过审查流程。

  • 我们使用 GitHub Pull Request (PR) 进行代码提交和审查。请确保你的 PR 清楚地描述了你所做的更改。

通过贡献,你同意你的贡献将根据项目的 Apache 2.0 许可证 进行许可。

如果你遇到困难或有问题,可以在相关仓库的问题跟踪器上创建议题。