Agent Development Kit（ADK）へ入門してローカル環境で動作を確認する

instruction="""
あなたは親切なアシスタントです。

# タスク
ユーザーの質問に正確に回答してください。

# 制約
- 日本語で回答する
- 簡潔にまとめる
- 不明な場合は正直に伝える
"""

tools=[get_weather, get_current_time, search_database]

def search_products(
    query: str,                           # 必須パラメータ
    category: str = "all",                # オプショナルパラメータ
    max_results: Optional[int] = None     # None許容パラメータ
) -> dict:
    """
    商品を検索します。

    Args:
        query: 検索キーワード
        category: 商品カテゴリ（デフォルト: all）
        max_results: 最大結果数

    Returns:
        検索結果を含む辞書
    """
    # 実装
    return {"status": "success", "results": [...]}

adk-sample/
├── .venv/                    # Python仮想環境
└── multi_tool_agent/         # エージェントパッケージ
    ├── __init__.py           # パッケージ初期化
    ├── agent.py              # エージェント定義
    └── .env                  # 環境変数

mkdir -p adk-sample/multi_tool_agent
cd adk-sample

# uvのインストール（未インストールの場合）
curl -LsSf https://astral.sh/uv/install.sh | sh
source $HOME/.local/bin/env

# 仮想環境の作成
uv venv

uv pip install google-adk

uv pip show google-adk

gcloud auth application-default login

GOOGLE_GENAI_USE_VERTEXAI=TRUE
GOOGLE_CLOUD_PROJECT=your-project-id
GOOGLE_CLOUD_LOCATION=asia-northeast1

from . import agent

"""
天気・時刻エージェント

ADKの基本的な使い方を示すサンプルエージェントです。
- ツール（関数）の定義方法
- エージェントの作成方法
- 外部API（Open-Meteo）の利用
を学べます。
"""

import datetime
from zoneinfo import ZoneInfo
import requests
from google.adk.agents import Agent

# =============================================================================
# ツール（Tool）の定義
# =============================================================================
# ツールは、エージェントが実行できる「機能」です。
# 通常のPython関数として定義し、docstringで説明を書きます。
# LLMはこのdocstringを読んで、いつこのツールを使うべきか判断します。

# 天気コードから日本語の天気説明へのマッピング
# https://open-meteo.com/en/docs の WMO Weather interpretation codes 参照
WEATHER_CODE_MAP = {
    0: "快晴",
    1: "晴れ",
    2: "一部曇り",
    3: "曇り",
    45: "霧",
    48: "着氷性の霧",
    51: "弱い霧雨",
    53: "霧雨",
    55: "強い霧雨",
    56: "弱い着氷性の霧雨",
    57: "強い着氷性の霧雨",
    61: "弱い雨",
    63: "雨",
    65: "強い雨",
    66: "弱い着氷性の雨",
    67: "強い着氷性の雨",
    71: "弱い雪",
    73: "雪",
    75: "強い雪",
    77: "霧雪",
    80: "弱いにわか雨",
    81: "にわか雨",
    82: "激しいにわか雨",
    85: "弱いにわか雪",
    86: "強いにわか雪",
    95: "雷雨",
    96: "雹を伴う弱い雷雨",
    99: "雹を伴う強い雷雨",
}

def get_weather(city: str) -> dict:
    """
    指定された都市の現在の天気情報を取得します。
    Open-Meteo API（無料・APIキー不要）を使用してリアルタイムの天気データを取得します。

    Args:
        city: 天気を取得したい都市名（例: "東京", "大阪", "New York", "London"）

    Returns:
        天気情報を含む辞書（気温、天気、湿度、風速など）
    """
    try:
        # Step 1: 都市名から緯度・経度を取得（Open-Meteo Geocoding API）
        geocoding_url = "https://geocoding-api.open-meteo.com/v1/search"
        geo_params = {
            "name": city,
            "count": 1,
            "language": "ja",
            "format": "json"
        }

        geo_response = requests.get(geocoding_url, params=geo_params, timeout=10)
        geo_response.raise_for_status()
        geo_data = geo_response.json()

        if "results" not in geo_data or len(geo_data["results"]) == 0:
            return {
                "status": "error",
                "message": f"都市 '{city}' が見つかりませんでした。別の都市名を試してください。"
            }

        location = geo_data["results"][0]
        latitude = location["latitude"]
        longitude = location["longitude"]
        city_name = location.get("name", city)
        country = location.get("country", "")

        # Step 2: 天気情報を取得（Open-Meteo Weather API）
        weather_url = "https://api.open-meteo.com/v1/forecast"
        weather_params = {
            "latitude": latitude,
            "longitude": longitude,
            "current": "temperature_2m,relative_humidity_2m,weather_code,wind_speed_10m,apparent_temperature",
            "timezone": "auto"
        }

        weather_response = requests.get(weather_url, params=weather_params, timeout=10)
        weather_response.raise_for_status()
        weather_data = weather_response.json()

        current = weather_data["current"]
        weather_code = current["weather_code"]
        weather_description = WEATHER_CODE_MAP.get(weather_code, f"不明 (コード: {weather_code})")

        return {
            "status": "success",
            "city": city_name,
            "country": country,
            "weather": weather_description,
            "weather_code": weather_code,
            "temperature": f"{current['temperature_2m']}°C",
            "apparent_temperature": f"{current['apparent_temperature']}°C",
            "humidity": f"{current['relative_humidity_2m']}%",
            "wind_speed": f"{current['wind_speed_10m']} km/h",
            "coordinates": {
                "latitude": latitude,
                "longitude": longitude
            },
            "data_source": "Open-Meteo API"
        }

    except requests.exceptions.Timeout:
        return {
            "status": "error",
            "message": "天気情報の取得がタイムアウトしました。しばらく待ってから再度お試しください。"
        }
    except requests.exceptions.RequestException as e:
        return {
            "status": "error",
            "message": f"天気情報の取得中にエラーが発生しました: {str(e)}"
        }
    except Exception as e:
        return {
            "status": "error",
            "message": f"予期しないエラーが発生しました: {str(e)}"
        }

def get_current_time(timezone: str = "Asia/Tokyo") -> dict:
    """
    指定されたタイムゾーンの現在時刻を取得します。

    Args:
        timezone: タイムゾーン名（例: "Asia/Tokyo", "America/New_York"）
                  デフォルトは "Asia/Tokyo"

    Returns:
        現在時刻の情報を含む辞書
    """
    try:
        tz = ZoneInfo(timezone)
        now = datetime.datetime.now(tz)
        return {
            "status": "success",
            "timezone": timezone,
            "datetime": now.strftime("%Y-%m-%d %H:%M:%S"),
            "date": now.strftime("%Y年%m月%d日"),
            "time": now.strftime("%H時%M分%S秒"),
            "day_of_week": ["月", "火", "水", "木", "金", "土", "日"][now.weekday()],
        }
    except Exception as e:
        return {
            "status": "error",
            "message": f"タイムゾーン '{timezone}' は無効です: {str(e)}",
        }

# =============================================================================
# エージェントの定義
# =============================================================================
# Agent クラスを使ってエージェントを作成します。
# - name: エージェントの識別名
# - model: 使用するLLMモデル
# - description: エージェントの説明（マルチエージェント時に使用）
# - instruction: エージェントの振る舞いを定義するプロンプト
# - tools: エージェントが使用できるツールのリスト

root_agent = Agent(
    name="weather_time_agent",
    model="gemini-2.5-flash",
    description="天気と時刻の情報を提供するアシスタント",
    instruction="""
あなたは親切で丁寧な日本語アシスタントです。
ユーザーからの質問に対して、利用可能なツールを使って正確な情報を提供してください。

対応できること:
- 世界中の都市の天気情報（リアルタイムデータ）
- 現在の日時（様々なタイムゾーン対応）

回答する際のルール:
1. 必ず日本語で回答してください
2. 情報は簡潔にまとめてください
3. ツールから得られた情報を元に回答してください
4. 天気情報には気温、天気、湿度などを含めてください
5. エラーが発生した場合は、ユーザーにわかりやすく説明してください
""",
    tools=[get_weather, get_current_time],
)

def get_weather(city: str) -> dict:
    """
    指定された都市の現在の天気情報を取得します。
    Open-Meteo API（無料・APIキー不要）を使用してリアルタイムの天気データを取得します。

    Args:
        city: 天気を取得したい都市名（例: "東京", "大阪", "New York", "London"）

    Returns:
        天気情報を含む辞書（気温、天気、湿度、風速など）
    """

# 仮想環境を有効化
source .venv/bin/activate

# Web UIを起動
adk web

INFO:     Started server process [31015]
INFO:     Waiting for application startup.

+-----------------------------------------------------------------------------+
| ADK Web Server started                                                      |
|                                                                             |
| For local testing, access at http://127.0.0.1:8000.                         |
+-----------------------------------------------------------------------------+

INFO:     Application startup complete.
INFO:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)