컴백부터 K-뷰티까지 — K-컬쳐의 모든 것을 메일로 받아보세요메일로 받아보기

METAL MEDIA

google/adk-samples

10,214PythonApache-2.0

구글이 에이전트 개발 도구 ADK로 만든 예제들을 한곳에 모아 공개했다

google/adk-samples는 Agent Development Kit(ADK)로 만든 실행 가능한 소규모 AI 에이전트 예제, 즉 레시피들을 모아둔 저장소다. core 폴더에는 OAuth 인증, 세션 기억, 안전장치, RAG 검색 패턴처럼 핵심 개념 하나씩을 가르치는 예제가, contrib 폴더에는 커뮤니티가 올린 특정 업무용 예제가 들어 있다. 각 레시피는 자체 설명서와 실행 방법을 갖추고 있어 그대로 포크해서 자기 프로젝트의 출발점으로 쓸 수 있다.

무엇을 하는 레포인가

  1. ADK로 만든 실행 가능한 소규모 에이전트 예제들을 core와 contrib 두 폴더로 나눠 제공한다
  2. core는 OAuth 로그인 흐름, 세션 메모리, 안전장치, RAG 검색 패턴 등 핵심 패턴 하나씩을 보여주는 정제된 예제다
  3. contrib는 특정 산업이나 업무 사례에 맞춘 커뮤니티 기여 예제로 범위가 더 넓다
  4. 저장소를 만들 때 쓰인 AI 코딩 보조 도구는 .agents/skills에, 사용자에게 제공되는 예제는 skills/분야/솔루션 형태로 따로 구분해 둔다
  5. Apache 2.0 라이선스로 공개되어 있으며 구글의 공식 지원 제품은 아니고 데모 및 시작점 용도이지 실제 서비스 운영용은 아니다

왜 중요한가

AI 에이전트를 처음 만들려는 개발자가 빈 화면에서 시작하는 대신 인증, 기억, 검색 같은 실전 패턴이 이미 작동하는 코드를 보고 바로 따라 만들 수 있다. 스타 수가 1만 개를 넘을 만큼 구글 생태계 안에서 에이전트 개발의 표준 예제 모음으로 자리 잡고 있다.

이 레포의 용어

  • ADK(Agent Development Kit) · 구글이 만든, AI 에이전트를 만들기 위한 개발 도구 모음
  • OAuth · 다른 서비스 계정으로 안전하게 로그인하도록 해주는 인증 방식
  • RAG · AI가 답하기 전에 외부 문서를 검색해서 참고하는 방식
  • 세션 메모리 · 대화가 이어지는 동안 이전 내용을 기억하는 기능
  • 가드레일(guardrail) · 에이전트가 엉뚱하거나 위험한 행동을 하지 않도록 막는 안전장치

레포 원문 소개 (영문)

A collection of sample agents built with Agent Development Kit (ADK)

GitHub에서 보기프로젝트 사이트

관련 기사

주목받는 레포

레포 전체 보기 →

METAL MEDIA 최신 기사