콘텐츠로 이동

기여 가이드

에이전트 개발 키트(ADK)에 기여하고자 해 주셔서 감사합니다! 아래에 나열된 핵심 프레임워크, 문서 및 관련 구성 요소에 대한 기여를 환영합니다.

이 가이드는 참여 방법을 안내합니다.

기여 준비하기

올바른 리포지토리 선택하기

ADK 프로젝트는 여러 리포지토리로 나뉘어 있습니다. 기여할 대상에 맞는 리포지토리를 찾아보세요.

리포지토리 설명 상세 가이드
google/adk-python 핵심 Python 라이브러리 소스 코드를 포함합니다. CONTRIBUTING.md
google/adk-python-community 커뮤니티가 기여한 도구, 통합, 스크립트를 포함합니다. CONTRIBUTING.md
google/adk-js 핵심 JavaScript 라이브러리 소스 코드를 포함합니다. CONTRIBUTING.md
google/adk-go 핵심 Go 라이브러리 소스 코드를 포함합니다. CONTRIBUTING.md
google/adk-java 핵심 Java 라이브러리 소스 코드를 포함합니다. CONTRIBUTING.md
google/adk-docs 현재 보고 계신 문서 사이트의 소스를 포함합니다. CONTRIBUTING.md
google/adk-samples ADK 샘플 에이전트를 포함합니다. CONTRIBUTING.md
google/adk-web adk web 개발 UI의 소스를 포함합니다.

이러한 리포지토리에는 일반적으로 루트에 CONTRIBUTING.md 파일이 있으며, 해당 구성 요소의 요구 사항, 테스트, 코드 리뷰 절차 등에 대한 자세한 정보가 담겨 있습니다.

CLA에 서명하기

이 프로젝트에 대한 기여에는 기여자 라이선스 계약(Contributor License Agreement, CLA) 이 필요합니다. 귀하(또는 귀하의 고용주)는 기여물의 저작권을 보유하며, 이 계약은 프로젝트의 일부로서 귀하의 기여를 사용하고 재배포할 수 있는 권한을 저희에게 부여합니다.

귀하 또는 현재 고용주가 이미 Google CLA에 서명했다면(다른 프로젝트를 위한 것이었더라도), 다시 서명할 필요가 없을 수 있습니다.

https://cla.developers.google.com/에서 현재 계약 상태를 확인하거나 새 계약에 서명하세요.

커뮤니티 가이드라인 검토하기

이 프로젝트는 Google의 오픈소스 커뮤니티 가이드라인을 따릅니다.

논의에 참여하기

질문이 있거나, 아이디어를 공유하고 싶거나, ADK를 어떻게 사용하는지 이야기하고 싶으신가요? Python, TypeScript, Go, Java Discussions로 오세요!

이 공간은 주로 다음을 위한 곳입니다.

  • 질문하고 커뮤니티와 유지보수자에게 도움받기
  • 프로젝트나 사용 사례 공유하기 (Show and Tell)
  • 공식 이슈를 만들기 전에 기능 개선이나 변경 사항을 논의하기
  • ADK에 관한 일반적인 대화

기여 방법

ADK에 기여하는 방법은 여러 가지가 있습니다.

이슈 보고하기

프레임워크의 버그나 문서의 오류를 발견했다면:

개선 사항 제안하기

새 기능이나 기존 기능 개선 아이디어가 있나요?

문서 개선하기

오타, 불명확한 설명, 누락된 정보를 발견했다면 변경 사항을 직접 제출하세요.

코드 작성하기

버그를 수정하거나, 새 기능을 구현하거나, 문서용 코드 샘플을 기여하는 데 도움을 주세요.

방법: 코드 변경 사항이 담긴 Pull Request(PR)를 제출하세요.

코드 리뷰

  • 프로젝트 구성원을 포함한 모든 기여는 리뷰 과정을 거칩니다.

  • 코드 제출과 리뷰에는 GitHub Pull Request(PR)를 사용합니다. PR에 변경 사항을 명확하게 설명해 주세요.

라이선스

기여함으로써 귀하는 귀하의 기여물이 프로젝트의 Apache 2.0 라이선스 하에 라이선스되는 데 동의하게 됩니다.

질문이 있으신가요?

막히거나 질문이 있으면 관련 리포지토리의 이슈 트래커에 자유롭게 이슈를 열어 주세요.