【AIエージェント】ADKを使用してAIエージェントを作成する方法

2025年12月9日

Google が公開している ADK（Agent Development Kit）は、エージェント構築を容易にするためのツールキットです。LLM による推論と、ツール（関数）実行を自然に連携できる仕組みを提供しており、複雑なエージェントを簡潔に記述・管理できます。本記事では、この ADK を使って将棋・オセロ・チェスのニュースを収集し、ユーザーの質問に応じて必要な情報を返すエージェントを実装します。

はじめに

Google が公開している ADK（Agent Development Kit）は、エージェント構築を容易にするためのツールキットです。LLM による推論と、ツール（関数）実行を自然に連携できる仕組みを提供しており、複雑なエージェントを簡潔に記述・管理できます。

本記事では、この ADK を使って将棋・オセロ・チェスのニュースを収集し、ユーザーの質問に応じて必要な情報を返すエージェントを実装します。

環境構築

開発では次のものを使用します。

OpenAI API キー（Gemini の方が適している想定だが、本記事では代替として OpenAI を使用）
Python
VSCode などのコードエディタ
PowerShell

早速、環境を構築していきます。

１，uvのインストール

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

まず最初に行っているのが、

のインストールです。 powershellを通じてインストールします。

２，プロジェクトフォルダの作成

./agent_dev

次に、作業用のプロジェクトディレクトリとして

agent_dev

フォルダを作ります。このディレクトリ以下にエージェントのコードなどを記載していきます。

３，uvによる環境準備

uv init
uv venv
.\\.venv\\Scripts\\Activate.ps1

ここでは

を使って、Python プロジェクトの初期化と仮想環境の作成、その有効化を行っています。powershellで先ほど作成したプロジェクトフォルダに移動した後に実行してください。

４，パッケージのインストール

uv pip install google-adk
uv pip install feedparser

ここでは、エージェントの実装に必要な Python パッケージを仮想環境内にインストールしています。 google-adkはADKを使用するためのパッケージです。feedparserは将棋・チェスのニュース取得に使用するライブラリです。

５，ディレクトリ構成

続いて、以下のようにディレクトリを構築してください。.venv以下はすでに作成されていると思うのでshogi_info_agent以下を構築します。

agent_dev
 └─ .venv/
 └─ shogi_info_agent/
      ├─ __init__.py
      ├─ agent.py
      └─ .env

６，OpenAI APIキーを設定（.env）

OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxx
PYTHONUTF8=1

ここでは、OpenAIを使用するために、APIキーを環境変数に設定します。

ここまで準備すれば、あとは agent.py に処理を書くだけでエージェントが動作します。

エージェントの作成

それでは、以下のようにagent.pyに記載していきます。

コードの解説

全体像として、3つのtoolを定義し、エージェントがこのtoolを使用して回答を生成する形になっています。３つのtoolはそれぞれ「get_shogi_news」「get_othello_news」「get_chess_news」の関数に対応し、それぞれ将棋のニュースを取得する関数、オセロのニュースを取得する関数、チェスのニュースを取得する関数に対応します。

ここで作成した、toolをエージェントが適宜選択しながら回答を生成するような形です。

以下の箇所がエージェントに対応しています。このエージェントでは、openai/gpt-4o-miniの中核モデルとして、これに対して、最下の箇所で3つのtoolを付与しているようになります。