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 プロバイダーもサポートしています。
ベストプラクティス
- コードファーストの哲学: バージョン管理、テスト、柔軟性のために Python でエージェントを定義する
- モジュラーデザイン: 特定のドメイン向けに特殊エージェントを作成し、システムに構成する
- ツール統合: プリビルドツールを活用し、カスタム関数で拡張する
- 評価: テストケースに対してエージェントを体系的にテストする
- 安全性: 機密操作には確認フローを実装する
- 階層構造: 複雑なマルチエージェントワークフローにはコーディネーターエージェントを使用する
- ワークフロー選択: 予測可能なパイプラインにはワークフローエージェントを、動的ルーティングには LLM エージェントを選択する
一般的なユースケース
- リサーチアシスタント: Web 検索 + 要約 + レポート生成
- コードアシスタント: コード実行 + ドキュメント作成 + デバッグ
- カスタマーサポート: クエリルーティング + 知識ベース + エスカレーション
- コンテンツ制作: リサーチ + 執筆 + 編集パイプライン
- データ分析: データ取得 + 処理 + 可視化
- タスク自動化: 条件ロジックを含むマルチステップワークフロー
開発 UI
ADK には以下を含む組み込みインターフェースが含まれています。
- インタラクティブなエージェント動作のテスト
- ツール呼び出しと応答のデバッグ
- エージェントパフォーマンスの評価
- エージェントデザインの反復
リソース
- GitHub: https://github.com/google/adk-python
- ドキュメント: https://google.github.io/adk-docs/
- llms.txt: https://raw.githubusercontent.com/google/adk-python/refs/heads/main/llms.txt
実装ワークフロー
ADK ベースのエージェントを実装する場合:
- 要件の定義: エージェントの機能と必要なツールを特定する
- アーキテクチャの選択: 単一エージェント、マルチエージェント、またはワークフローベース
- ツールの選択: プリビルド、カスタム関数、または OpenAPI 統合
- エージェントの実装: 指示とツールを使用してエージェント定義を作成する
- ローカルでテスト: 開発 UI を使用して反復する
- 評価の追加: 体系的な検証のためのテストケースを作成する
- デプロイ: Cloud Run、Vertex AI、またはカスタムインフラストラクチャを選択する
- 監視: エージェントパフォーマンスを追跡し、反復する
覚えておいてください: ADK はエージェント開発を従来のソフトウェアエンジニアリングと同様に扱います。バージョン管理を使用し、テストを書き、エンジニアリングのベストプラクティスに従ってください。