贡献指南
声明
AI 智能体开发套件(Agent Development Kit, ADK)项目及其英文文档归属 Google 所有并维护。
本站为 ADK 文档的中文版本,由 ADK.Wiki 运营,内容由 ADK.Wiki 独立维护,并保持与上游文档google/adk-docs
保持同步更新。
本贡献指南不适用于当前中文版本内容改进。
感谢你对 AI 智能体开发套件(Agent Development Kit, ADK)的贡献兴趣!Google 欢迎对核心 Python 框架和其原始文档 google/adk-docs
的贡献。
本指南提供了如何参与 google/adk-python
与 google/adk-docs
的信息。
1. google/adk-python
¶
包含核心 Python 库源代码。
2. google/adk-docs
¶
包含你当前正在阅读的文档站点的上游原始文档(英文)的源代码。
开始之前¶
✏️ 签署 Google 的贡献者许可协议¶
对此项目的贡献必须附有 贡献者许可协议 (CLA)。你(或你的雇主)保留对你贡献的版权;这只是给予 Google 使用和重新分发你的贡献作为项目一部分的许可。
如果你或你当前的雇主已经签署了 Google CLA(即使是为了不同的项目),你可能不需要再次签署。
访问 https://cla.developers.google.com/ 查看你当前的协议或签署新协议。
📜 查看 Google 的社区准则¶
这个项目遵循 Google 的开源社区准则。
💬 加入讨论!¶
有问题、想分享想法或讨论你如何使用 ADK?前往 Google 的 GitHub Discussions!
这是主要的场所,用于:
- 提问并从社区和维护者那里获得帮助。
- 分享你的项目或使用案例(
Show and Tell
)。 - 在创建正式问题之前讨论潜在功能或改进。
- 关于 ADK 的一般对话。
如何贡献¶
你可以通过多种方式贡献给 ADK:
1. 报告问题(错误和异常)¶
如果你在框架中发现错误或文档中有错误:
2. 建议增强功能¶
对新功能或现有功能的改进有想法?
- 框架增强: 在
google/adk-python
中提出问题 - 文档增强: 在
google/adk-docs
中提出问题
3. 改进文档¶
发现拼写错误、解释不清晰或缺少信息?直接提交你的更改:
- 如何: 提交一个拉取请求(PR)附带你建议的改进。
- 在哪里: 在
google/adk-docs
中创建拉取请求
4. 编写代码¶
帮助修复错误、实现新功能或为文档贡献代码示例:
- 如何: 提交一个拉取请求(PR)附带你的代码更改。
- 框架: 在
google/adk-python
中创建拉取请求 - 文档: 在
google/adk-docs
中创建拉取请求
代码审查¶
-
所有贡献,包括来自项目成员的贡献,都要经过审查流程。
-
Google 使用 GitHub 拉取请求(PR)进行代码提交和审查。请确保你的 PR 清晰描述了你正在进行的更改。
许可证¶
通过贡献,你同意你的贡献将根据项目的 Apache 2.0 许可证 进行许可。
问题?¶
如果你遇到问题或有疑问,请随时在相关仓库中打开一个 issue。