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