Install
Use ADK with your preferred language누구에게 맞나
이 기술은 오픈소스, 코드 우선 도구 한 세트로 복잡한 AI 에이전트를 만들고 평가하고 배포하고 싶은 사람에게 맞다. 공식 이름은 Agent Development Kit(ADK)다. 이미 선호하는 프로그래밍 언어가 있고 공식 「선호 언어」 입구에서 시작할 준비가 된 사람에게도 맞다. 원문은 선호 언어로 ADK를 쓸 수 있다고 하지만 이 단락에는 구체적 언어 주소가 없다.
이 저장소를 설치 명령 한 줄로 보는 것에는 맞지 않는다. 여기는 문서 저장소다. ADK는 Gemini와 Google 생태계에 최적화되어 있지만 모델 무관, 배포 무관으로 쓰여 있고 다른 프레임워크와 호환된다. 먼저 문서만 읽고 아직 컨테이너 배포를 원하지 않으면 Cloud Run이나 GKE로 바로 올리지 마라.
공식 저장소는 https://github.com/google/adk-docs 그 페이지에 이미 적힌 설명으로 조작한다. 나타나지 않은 설치 프로그램이나 문서 주소를 지어내지 마라.
3분 만에 첫 시도 끝내기
공식 문서 경로만 간다. 먼저 선호 언어를 고르고 공식 설명에서 해당 입문을 찾는다. 나타나지 않은 패키지 설치 명령은 실행하지 마라.
전제: 공식 문서 저장소를 열 수 있고 사용할 언어가 이미 있다. 첫 번째에는 배포하지 말고 비밀을 대화에 쓰지 마라.
설치 위치: https://github.com/google/adk-docs 을 연다. 「선호 언어로 ADK를 쓸 수 있다」에 따라 공식 입문을 찾는다. 원문에 pip나 npm 명령이 없으니 채우지 마라.
낮은 위험 작업: 에이전트가 읽기 전용으로 세 가지만 요약하게 한다 — 코드 우선 툴킷이다; Gemini와 Google 생태계에 최적화되어 있어도 모델 무관, 배포 무관이다; AI 코드 편집기와 호환되는 최적화 문서 맥락을 제공한다. 문서 파일 주소를 지어내게 하지 말고 Cloud Run, GKE, Agent Runtime에 배포하게 하지 마라.
성공 신호: 다음 단계는 공식 문서로 돌아가 자기 언어로 입문해야 한다고 가리킬 수 있고, 지어낸 설치 명령을 실행하지 않았다. 에이전트가 나타나지 않은 주소나 패키지 이름을 주면 멈춰라.
사용 사례
사례 1: 이미 아는 언어로 에이전트를 만들기 시작한다. 원문은 선호 언어를 쓸 수 있다고 한다. 먼저 언어를 고른 다음 공식 입문 페이지만 여는 사람에게 맞다. 구체적 언어 경로가 현재 설명에 없으면 저장소 디렉터리 대조에서 멈추고 get-started 주소를 지어내지 마라.
사례 2: AI 코드 편집기에 최적화 문서 맥락을 준다. 원문은 ADK가 AI 코드 편집기와 호환되는 최적화 문서 맥락을 제공해 개발을 빠르게 한다고 한다. 이미 편집기를 쓰고 「공식 최적화 문서를 불러야 하며 아무 블로그를 붙이면 안 된다」는 것만 먼저 확인하려는 사람에게 맞다. 파일 이름과 주소가 원문에 없으면 지어내지 마라.
사용 경계
이 저장소는 문서이며 설치 프로그램이 아니다. 나타나지 않은 패키지 관리 명령을 주 경로에 넣지 마라. 능력은 구축, 평가, 배포를 덮는다. 배포 쪽은 컨테이너화해 Cloud Run 또는 GKE에 두거나 Agent Runtime으로 확장한다고만 적는다. 모두 부작용이 있어 첫 시도가 될 수 없다.
Gemini와 Google 생태계에 최적화되어 있지만 공식은 동시에 모델 무관, 배포 무관, 다른 프레임워크와 호환된다고 쓴다. 「Gemini만」이라고 쓰지 마라. 최적화 문서 맥락은 AI 코드 편집기와 호환되지만 클라이언트 목록은 없다. 공식 페이지는 https://github.com/google/adk-docs 에이전트가 제안하는 주소나 명령이 그 페이지와 다르면 그 페이지를 기준으로 한다.