Repolode
google

google/adk-python

Google製のコードファーストなPythonフレームワーク。Geminiに最適化されつつ、モデルを問わずAIエージェントの構築・評価・デプロイに使えます。

スター
21,921
フォーク
4,409
未解決の Issue
358
最終コミット
8 時間前

これは何?

Agent Development Kit(ADK)は、ソフトウェア開発の実践手法をAIエージェントの作成に取り入れた、モジュール式のPythonフレームワークです。エージェントのロジック、ツール、オーケストレーションをPythonで直接定義できるため、テストやバージョン管理が容易です。Geminiに最適化されていますが、ほかのモデルやフレームワークにも対応しています。

複数の特化型エージェントを階層構造にまとめる機能、ルーティング・ループ・リトライ・human-in-the-loopのステップに対応したグラフベースのWorkflowランタイム、エージェント間の委任を行うTask APIを備えています。エージェントは組み込みツール、カスタム関数、OpenAPI仕様、MCPツールを利用できます。ツールの実行前に明示的な承認を求める確認フローも用意されています。

ADKには、エージェントのテストとデバッグに使えるCLIと開発用Web UI、evalsetファイルを使ってエージェントを実行する評価コマンド、DockerやGoogle Cloud Runへのデプロイコマンドが含まれています。

主な機能

  • 01ルーティング、ループ、リトライ、状態管理に対応したグラフベースのWorkflowランタイム
  • 02エージェント間の構造化された委任を行うTask API
  • 03特化型エージェントを組み合わせて構築するマルチエージェント階層
  • 04カスタム関数、OpenAPI仕様、MCPツールを含むツールエコシステム
  • 05実行前に人間の承認を求めるツール確認フロー
  • 06開発用Web UI、CLI、評価コマンドを標準搭載

ユースケース

  • 特化型エージェントが異なるサブタスクを担当するマルチエージェントアプリケーションの構築
  • OpenAPIまたはMCPツール経由で外部APIを呼び出すGeminiベースのエージェントの作成
  • 再現性のあるevalsetファイルを使ったエージェントの動作テストと評価
  • エージェントをコンテナとしてCloud Runにデプロイする、またはDockerでローカル実行する

クイックスタート

  1. 1

    PyPI から安定版をインストールする

    pip install google-adk
  2. 2

    root_agent を含むエージェントファイルを作成する(README の Agent の例をコピー)

  3. 3

    対話型 CLI でエージェントを実行する

    adk run path/to/my_agent

使う前に知っておきたいこと

  • Gemini 向けに最適化されており、一部の機能では Google Cloud または Gemini の認証情報が必要です。
  • Python 3.11 以降が必要です。
  • main の開発版には、実験的な変更やバグが含まれている場合があります。

トピック

よくある質問

adk-python とは?
Google製のコードファーストなPythonフレームワーク。Geminiに最適化されつつ、モデルを問わずAIエージェントの構築・評価・デプロイに使えます。 Agent Development Kit(ADK)は、ソフトウェア開発の実践手法をAIエージェントの作成に取り入れた、モジュール式のPythonフレームワークです。エージェントのロジック、ツール、オーケストレーションをPythonで直接定義できるため、テストやバージョン管理が容易です。Geminiに最適化されていますが、ほかのモデルやフレームワークにも対応しています。
adk-python は無料で使えますか?ライセンスは?
adk-python は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
adk-python は今もメンテナンスされていますか?
活発にメンテナンス中。adk-python の最終コミットは 2026年10月20日 です。
adk-python は何に使えますか?
特化型エージェントが異なるサブタスクを担当するマルチエージェントアプリケーションの構築 OpenAPIまたはMCPツール経由で外部APIを呼び出すGeminiベースのエージェントの作成 再現性のあるevalsetファイルを使ったエージェントの動作テストと評価 エージェントをコンテナとしてCloud Runにデプロイする、またはDockerでローカル実行する
adk-python のインストール方法は?
PyPI から安定版をインストールする: pip install google-adk root_agent を含むエージェントファイルを作成する(README の Agent の例をコピー) 対話型 CLI でエージェントを実行する: adk run path/to/my_agent
adk-python はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/google/adk-python

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト