Communitygithub.com

Google ADK Python スキル

Google ADK (Agent Development Kit) Python を使用して AI エージェントを構築します。マルチエージェントシステム、ワークフローエージェント(順次/並列/ループ)、Vertex AI へのデプロイ、ツール統合、人間参加型ループに利用します。

Google ADK Python スキル とは?

このスキルは、Google のオープンソース、コードファーストの Agent Development Kit (ADK) Python を使用して AI エージェントを構築、評価、デプロイするための総合ガイドです。LlmAgent、ワークフローエージェント(SequentialAgent、ParallelAgent、LoopAgent)、BaseAgent などのさまざまなエージェントタイプをサポートし、google_search や code_execution などの事前構築ツール、カスタム Python 関数、OpenAPI 仕様統合を含む豊富なツールエコシステムを提供します。このスキルは、階層的な調整とワークフローパターンを使用したマルチエージェントシステムの実装をカバーしており、Google Cloud 全体でデプロイ可能です。Cloud Run、Vertex AI Agent Engine、カスタムインフラストラクチャへのデプロイオプションを提供します。安全性のための人間参加型ループフロー、体系的なパフォーマンステストのための評価機能、エージェントの動作テストとデバッグのための開発 UI を備えています。このスキルは Claude Code、Cursor、Codex などの主要な AI エージェントプラットフォームと互換性があり、コードファーストアプローチを通じてバージョン管理、テスト、ベストプラクティスを重視した構造化されたエージェント開発を促進します。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Google ADK Python スキル は何をしますか?

あなたは、Google の Agent Development Kit (ADK) Python のエキスパートガイドです。これは、AI エージェントを構築、評価、デプロイするためのオープンソースのコードファーストツールキットです。

このスキルを使用するタイミング

ユーザーが以下を必要とする場合にこのスキルを使用します。

  • ツール統合とオーケストレーション機能を備えた AI エージェントの構築
  • 階層的な調整を備えたマルチエージェントシステムの作成
  • 予測可能なパイプラインのためのワークフローエージェント(順次、並列、ループ)の実装
  • LLM 搭載エージェントと Google 検索、コード実行、またはカスタムツールの統合
  • 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="You are a helpful assistant that searches the web for information.",
    description="Search assistant for web queries",
    tools=[google_search]
)

マルチエージェントシステム

from google.adk.agents import LlmAgent

# Specialized agents
researcher = LlmAgent(
    name="Researcher",
    model="gemini-2.5-flash",
    instruction="Research topics thoroughly using web search.",
    tools=[google_search]
)

writer = LlmAgent(
    name="Writer",
    model="gemini-2.5-flash",
    instruction="Write clear, engaging content based on research.",
)

# Coordinator agent
coordinator = LlmAgent(
    name="Coordinator",
    model="gemini-2.5-flash",
    instruction="Delegate tasks to researcher and writer agents.",
    sub_agents=[researcher, writer]
)

カスタムツールの作成

from google.adk.tools import Tool

def calculate_sum(a: int, b: int) -> int:
    """Calculate the sum of two numbers."""
    return a + b

# Convert function to tool
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

# Tool with confirmation required
agent = LlmAgent(
    name="careful_searcher",
    model="gemini-2.5-flash",
    tools=[google_search],
    tool_confirmation=True  # Requires approval before execution
)

デプロイオプション

Cloud Run デプロイ

# Containerize agent
docker build -t my-agent .

# Deploy to Cloud Run
gcloud run deploy my-agent --image my-agent

Vertex AI Agent Engine

# Deploy to Vertex AI for scalable agent hosting
# Integrates with Google Cloud's managed infrastructure

カスタムインフラストラクチャ

# Run agents locally or on custom servers
# Full control over deployment environment

モデルサポート

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 エージェントを選択する

一般的なユースケース

  • リサーチアシスタント: Web 検索 + 要約 + レポート生成
  • コードアシスタント: コード実行 + ドキュメント作成 + デバッグ
  • カスタマーサポート: クエリルーティング + 知識ベース + エスカレーション
  • コンテンツ制作: リサーチ + 執筆 + 編集パイプライン
  • データ分析: データ取得 + 処理 + 可視化
  • タスク自動化: 条件ロジックを含むマルチステップワークフロー

開発 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-data

Edit existing BMAD agents while maintaining compliance

majiayu000/claude-skill-registry-data

Edit existing BMAD agents while maintaining compliance

majiayu000/claude-skill-registry-data

Edit existing BMAD modules while maintaining coherence

majiayu000/claude-skill-registry-data

Edit existing BMAD modules while maintaining coherence

majiayu000/claude-skill-registry-data

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-data

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-data

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-data

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-data

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

majiayu000/claude-skill-registry-data

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-data

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

majiayu000/claude-skill-registry-data

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-data

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-data

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-data

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

majiayu000/claude-skill-registry-data

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

majiayu000/claude-skill-registry-data

Conduct market research on competition and customers. Use when the user says "create a market research report about [business idea]".

majiayu000/claude-skill-registry-data

Conduct technical research on technologies and architecture. Use when the user says "create a technical research report on [topic]".

majiayu000/claude-skill-registry-data

Understand an existing codebase through systematic exploration

majiayu000/claude-skill-registry-data

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".

関連スキル