ADK用Pythonクイックスタート¶
このガイドでは、Agent Development Kit (ADK) for Pythonを使い始める方法について説明します。開始する前に、次のものがインストールされていることを確認してください。
- Python 3.10以降
- パッケージインストールのための
pip
インストール¶
次のコマンドを実行してADKをインストールします。
推奨: Python仮想環境の作成とアクティブ化
Python仮想環境を作成します。
Python仮想環境をアクティブ化します。
エージェントプロジェクトを作成する¶
adk createコマンドを実行して、新しいエージェントプロジェクトを開始します。
エージェントプロジェクトを探索する¶
作成されたエージェントプロジェクトは次の構造を持ち、agent.pyファイルにはエージェントのメイン制御コードが含まれています。
エージェントプロジェクトを更新する¶
agent.pyファイルにはroot_agentの定義が含まれており、これはADKエージェントの唯一の必須要素です。エージェントが使用するツールを定義することもできます。生成されたagent.pyコードを更新して、エージェントが使用するget_current_timeツールを含めるようにします。これは次のコードに示されています。
from google.adk.agents.llm_agent import Agent
# モックツールの実装
def get_current_time(city: str) -> dict:
"""指定された都市の現在時刻を返します。"""
return {"status": "success", "city": city, "time": "午前10時30分"}
root_agent = Agent(
model='gemini-3-pro-preview',
name='root_agent',
description="指定された都市の現在時刻を伝えます。",
instruction="あなたは都市の現在時刻を伝えるのに役立つアシスタントです。この目的のために'get_current_time'ツールを使用してください。",
tools=[get_current_time],
)
APIキーを設定する¶
このプロジェクトはAPIキーを必要とするGemini APIを使用します。まだGemini APIキーをお持ちでない場合は、Google AI StudioのAPIキーページでキーを作成してください。
ターミナルウィンドウで、APIキーを.envファイルに環境変数として書き込みます。
ADKで他のAIモデルを使用する
ADKは多くの生成AIモデルの使用をサポートしています。ADKエージェントで他のモデルを構成する方法の詳細については、モデルと認証を参照してください。
エージェントを実行する¶
adk runコマンドを使用して対話型コマンドラインインターフェースでADKエージェントを実行するか、adk webコマンドを使用してADKが提供するADKウェブユーザーインターフェースを使用して実行できます。これらのオプションの両方で、エージェントをテストして対話できます。
コマンドラインインターフェースで実行する¶
adk runコマンドラインツールを使用してエージェントを実行します。
ウェブインターフェースで実行する¶
ADKフレームワークは、エージェントをテストして対話するために使用できるウェブインターフェースを提供します。次のコマンドを使用してウェブインターフェースを起動できます。
Note
my_agent/フォルダを含む親ディレクトリからこのコマンドを実行してください。たとえば、エージェントがagents/my_agent/内にある場合は、agents/ディレクトリからadk webを実行してください。
このコマンドは、エージェント用のチャットインターフェースを備えたウェブサーバーを起動します。ウェブインターフェースは(http://localhost:8000)でアクセスできます。左上隅でエージェントを選択し、リクエストを入力します。
次へ: エージェントを構築する¶
ADKがインストールされ、最初のエージェントが実行中になったので、ビルドガイドを使用して独自のエージェントを構築してみてください。