Communitygithub.com

majiayu000/claude-skill-registry

Google ADK Python(Agent Development Kit)을 사용하여 AI 에이전트를 구축합니다. 다중 에이전트 시스템, 워크플로우 에이전트(순차/병렬/루프), Vertex AI 배포, 도구 통합, 인간-루프-인-더-루프에 사용됩니다.

claude-skill-registry란 무엇인가요?

이 스킬은 Google의 Agent Development Kit(ADK) Python을 활용하여 AI 에이전트를 구축, 평가 및 배포하는 방법을 설명합니다. 개발자는 LLM 기반의 동적 라우팅 에이전트(LlmAgent)와 순차, 병렬, 루프와 같은 예측 가능한 워크플로우 에이전트를 사용하여 다중 에이전트 시스템을 설계할 수 있습니다. 또한 Google 검색, 코드 실행, 사용자 정의 함수 등 다양한 도구를 통합하고, 인간 승인 흐름을 구현하여 안전한 도구 실행을 보장할 수 있습니다. 에이전트는 Vertex AI Agent Engine, Cloud Run 또는 사용자 정의 인프라에 배포할 수 있으며, 내장 개발 UI를 통해 대화형 테스트와 디버깅이 가능합니다.

지원 대상✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/majiayu000/claude-skill-registry/tree/HEAD/skills/agent/google-adk-python-hoanghd218-landing-page-ai-kien-2

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Google ADK Python 스킬

당신은 Google의 Agent Development Kit(ADK) Python에 대한 전문 가이드입니다. 이는 AI 에이전트를 구축, 평가 및 배포하기 위한 오픈 소스, 코드 중심 툴킷입니다.

이 스킬을 사용하는 경우

사용자가 다음을 필요로 할 때 이 스킬을 사용하세요:

  • 도구 통합 및 오케스트레이션 기능을 갖춘 AI 에이전트 구축
  • 계층적 조정 기능을 갖춘 다중 에이전트 시스템 생성
  • 예측 가능한 파이프라인을 위한 워크플로우 에이전트(순차, 병렬, 루프) 구현
  • Google 검색, 코드 실행 또는 사용자 정의 도구와 LLM 기반 에이전트 통합
  • Vertex AI Agent Engine, Cloud Run 또는 사용자 정의 인프라에 에이전트 배포
  • 에이전트 성능을 체계적으로 평가 및 테스트
  • 도구 실행을 위한 인간-루프-인-더-루프 승인 흐름 구현

핵심 개념

에이전트 유형

LlmAgent: 동적 라우팅 및 적응형 동작이 가능한 LLM 기반 에이전트

  • 이름, 모델, 지침, 설명 및 도구로 정의
  • 위임 및 조정을 위한 하위 에이전트 지원
  • 컨텍스트 기반 지능적 의사 결정

워크플로우 에이전트: 구조화되고 예측 가능한 오케스트레이션 패턴

  • SequentialAgent: 정의된 순서대로 에이전트 실행
  • ParallelAgent: 여러 에이전트를 동시에 실행
  • LoopAgent: 반복 로직으로 실행 반복

BaseAgent: 사용자 정의 에이전트 구현을 위한 기반

핵심 구성 요소

도구 생태계:

  • 사전 구축된 도구(google_search, code_execution)
  • 사용자 정의 Python 함수를 도구로 변환
  • OpenAPI 사양 통합
  • 인간 승인을 위한 도구 확인 흐름

다중 에이전트 아키텍처:

  • 계층적 에이전트 구성
  • 특정 도메인을 위한 전문화된 에이전트
  • 위임을 위한 코디네이터 에이전트

설치

# 안정적인 릴리스 (권장)
pip install google-adk

# 개발 버전 (최신 기능)
pip install git+https://github.com/google/adk-python.git@main

구현 패턴

단일 에이전트와 도구

from google.adk.agents import LlmAgent
from google.adk.tools import google_search

agent = LlmAgent(
    name="search_assistant",
    model="gemini-2.5-flash",
    instruction="당신은 웹에서 정보를 검색하는 유용한 도우미입니다.",
    description="웹 쿼리를 위한 검색 도우미",
    tools=[google_search]
)

다중 에이전트 시스템

from google.adk.agents import LlmAgent

# 전문화된 에이전트
researcher = LlmAgent(
    name="Researcher",
    model="gemini-2.5-flash",
    instruction="웹 검색을 사용하여 주제를 철저히 조사하세요.",
    tools=[google_search]
)

writer = LlmAgent(
    name="Writer",
    model="gemini-2.5-flash",
    instruction="조사 내용을 바탕으로 명확하고 매력적인 콘텐츠를 작성하세요.",
)

# 코디네이터 에이전트
coordinator = LlmAgent(
    name="Coordinator",
    model="gemini-2.5-flash",
    instruction="리서처 및 라이터 에이전트에게 작업을 위임하세요.",
    sub_agents=[researcher, writer]
)

사용자 정의 도구 생성

from google.adk.tools import Tool

def calculate_sum(a: int, b: int) -> int:
    """두 숫자의 합을 계산합니다."""
    return a + b

# 함수를 도구로 변환
sum_tool = Tool.from_function(calculate_sum)

agent = LlmAgent(
    name="calculator",
    model="gemini-2.5-flash",
    tools=[sum_tool]
)

순차 워크플로우

from google.adk.agents import SequentialAgent

workflow = SequentialAgent(
    name="research_workflow",
    agents=[researcher, summarizer, writer]
)

병렬 워크플로우

from google.adk.agents import ParallelAgent

parallel_research = ParallelAgent(
    name="parallel_research",
    agents=[web_researcher, paper_researcher, expert_researcher]
)

인간-루프-인-더-루프

from google.adk.tools import google_search

# 확인이 필요한 도구
agent = LlmAgent(
    name="careful_searcher",
    model="gemini-2.5-flash",
    tools=[google_search],
    tool_confirmation=True  # 실행 전 승인 필요
)

배포 옵션

Cloud Run 배포

# 에이전트 컨테이너화
docker build -t my-agent .

# Cloud Run에 배포
gcloud run deploy my-agent --image my-agent

Vertex AI Agent Engine

# 확장 가능한 에이전트 호스팅을 위해 Vertex AI에 배포
# Google Cloud의 관리형 인프라와 통합

사용자 정의 인프라

# 로컬 또는 사용자 정의 서버에서 에이전트 실행
# 배포 환경에 대한 완전한 제어

모델 지원

Gemini에 최적화:

  • gemini-2.5-flash
  • gemini-2.5-pro
  • gemini-1.5-flash
  • gemini-1.5-pro

모델 불가지론: Gemini에 최적화되어 있지만, ADK는 표준 API를 통해 다른 LLM 제공자를 지원합니다.

모범 사례

  1. 코드 우선 철학: 버전 관리, 테스트 및 유연성을 위해 Python에서 에이전트 정의
  2. 모듈식 설계: 특정 도메인을 위한 전문화된 에이전트를 만들고 시스템으로 구성
  3. 도구 통합: 사전 구축된 도구를 활용하고 사용자 정의 함수로 확장
  4. 평가: 테스트 케이스에 대해 체계적으로 에이전트 테스트
  5. 안전: 민감한 작업에 대한 확인 흐름 구현
  6. 계층 구조: 복잡한 다중 에이전트 워크플로우를 위해 코디네이터 에이전트 사용
  7. 워크플로우 선택: 예측 가능한 파이프라인에는 워크플로우 에이전트를, 동적 라우팅에는 LLM 에이전트를 선택

일반적인 사용 사례

  • 연구 도우미: 웹 검색 + 요약 + 보고서 생성
  • 코드 도우미: 코드 실행 + 문서화 + 디버깅
  • 고객 지원: 쿼리 라우팅 + 지식 베이스 + 에스컬레이션
  • 콘텐츠 생성: 연구 + 작성 + 편집 파이프라인
  • 데이터 분석: 데이터 가져오기 + 처리 + 시각화
  • 작업 자동화: 조건부 로직이 포함된 다단계 워크플로우

개발 UI

ADK에는 다음과 같은 내장 인터페이스가 포함되어 있습니다:

  • 대화형으로 에이전트 동작 테스트
  • 도구 호출 및 응답 디버깅
  • 에이전트 성능 평가
  • 에이전트 설계 반복

리소스

구현 워크플로우

ADK 기반 에이전트를 구현할 때:

  1. 요구 사항 정의: 에이전트 기능과 필요한 도구 식별
  2. 아키텍처 선택: 단일 에이전트, 다중 에이전트 또는 워크플로우 기반
  3. 도구 선택: 사전 구축, 사용자 정의 함수 또는 OpenAPI 통합
  4. 에이전트 구현: 지침과 도구를 사용하여 에이전트 정의 생성
  5. 로컬 테스트: 개발 UI를 사용한 반복
  6. 평가 추가: 체계적인 검증을 위한 테스트 케이스 생성
  7. 배포: Cloud Run, Vertex AI 또는 사용자 정의 인프라 선택
  8. 모니터링: 에이전트 성능 추적 및 반복

기억하세요: ADK는 에이전트 개발을 전통적인 소프트웨어 엔지니어링과 동일하게 취급합니다. 버전 관리를 사용하고, 테스트를 작성하고, 엔지니어링 모범 사례를 따르세요.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

majiayu000/claude-skill-registry

Builds, edit or validate Agent Skill through conversational discovery. Use when the user requests to "Create an Agent", "Optimize an Agent" or "Edit an Agent".

majiayu000/claude-skill-registry

Edit existing BMAD agents while maintaining compliance

majiayu000/claude-skill-registry

Edit existing BMAD agents while maintaining compliance

majiayu000/claude-skill-registry

Edit existing BMAD modules while maintaining coherence

majiayu000/claude-skill-registry

Edit existing BMAD modules while maintaining coherence

majiayu000/claude-skill-registry

Analyzes current state and user query to answer BMad questions or recommend the next workflow or agent. Use when user says what should I do next, what do I do now, or asks a question about BMad

majiayu000/claude-skill-registry

Build AI agents with Google ADK Python (Agent Development Kit). Use for multi-agent systems, workflow agents (sequential/parallel/loop), Vertex AI deployment, tool integration, human-in-the-loop.

majiayu000/claude-skill-registry

Portfolio allocation and rebalancing optimizer. Manages asset allocation across stocks/cash/bonds, performs periodic rebalancing, and ensures diversification according to market regime and risk tolerance.

majiayu000/claude-skill-registry

Create a hilarious and ultra-realistic video of an anthropomorphic animal acting like a human vlogger in a real-world setting.

majiayu000/claude-skill-registry

Speech-to-text transcription and translation via OpenAI Audio API -- models, response formats, timestamps, prompting, streaming, chunking, and diarization

majiayu000/claude-skill-registry

BlockRun works with Claude Code and Google Antigravity.

majiayu000/claude-skill-registry

This skill should be used when the user asks about libraries, frameworks, API references, or needs code examples. Activates for setup questions, code generation involving libraries, or mentions of specific frameworks like React, Vue, Next.js, Prisma, Supabase, etc.

majiayu000/claude-skill-registry

小省导购员数字人带货版即梦视频提示词生成系统,基于四大智能体协同(提示词生成师、质量管控师、知识库运维师、跨环节适配师),按照"主体+运动+场景+(镜头语言+光影+氛围)"公式输出中英文双版提示词,适配5s短视频。确保人物一致性、视觉连贯性、情绪连贯性,支持知识库智能复用和跨工具适配(Suno音乐、AI绘画),为数字人带货视频提供高质量提示词生成服务。

majiayu000/claude-skill-registry

Upload and manage files using Google Gemini File API via scripts/. Use for uploading images, audio, video, PDFs, and other files for use with Gemini models. Supports file upload, status checking, and file management. Triggers on "upload file", "file API", "upload image", "upload PDF", "upload video", "file management".

majiayu000/claude-skill-registry

CRITICAL: Use for MolyKit AI chat toolkit. Triggers on: BotClient, OpenAI, SSE streaming, AI chat, molykit, PlatformSend, spawn(), ThreadToken, cross-platform async, Chat widget, Messages, PromptInput, Avatar, LLM

majiayu000/claude-skill-registry

AI and machine learning workflow covering LLM application development, RAG implementation, agent architecture, ML pipelines, and AI-powered features.

majiayu000/claude-skill-registry

Analyze images/audio/video with Gemini API (better vision than Claude). Generate images (Imagen 4), videos (Veo 3). Use for vision analysis, transcription, OCR, design extraction, multimodal AI.

majiayu000/claude-skill-registry

Analyze images/audio/video with Gemini API (better vision than Claude). Generate images (Imagen 4), videos (Veo 3). Use for vision analysis, transcription, OCR, design extraction, multimodal AI.

majiayu000/claude-skill-registry

Conduct domain and industry research. Use when the user says "lets create a research report on [domain or industry]

majiayu000/claude-skill-registry

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

관련 스킬