Communitygithub.com

Google ADK Python スキル

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

Google ADK Python スキル とは?

このスキルは、Google の Agent Development Kit (ADK) Python を活用して AI エージェントを構築するための包括的なガイドです。ADK はコードファーストのオープンソースツールキットであり、単一の LLM エージェントから階層的なマルチエージェントシステム、順次・並列・ループといった構造化されたワークフローエージェントまで、幅広いアーキテクチャをサポートします。このスキルでは、Google 検索やコード実行などのビルトインツールの統合、カスタム Python 関数のツール化、ヒューマンインザループによる承認フロー、そして Vertex AI Agent Engine や Cloud Run へのデプロイ方法を詳細に説明します。コード例を豊富に含み、エージェント開発を従来のソフトウェアエンジニアリングと同様にバージョン管理、テスト、ベストプラクティスに基づいて行うための実践的な実装パターンを提供します。

対応✓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

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

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

ドキュメント

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

あなたは Google の Agent Development Kit (ADK) Python に関するエキスパートガイドです。ADK は、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:
    """2つの数値の合計を計算します。"""
    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.

関連スキル