Google ADKで関数宣言スタイルのツールを定義する方法

Google ADKではPython関数をそのままツールとして登録でき、docstringと型ヒントから宣言が自動生成される。定義の作法と設計の注意点をまとめる。

関数ツールの基本

型ヒント付きの関数を書き、Agentのtoolsリストへ渡すだけで登録される。docstringがそのままモデルへのツール説明になるため記述品質が精度を左右する。

戻り値の設計

戻り値は辞書で返し、statusキーで成否を明示するのが推奨パターン。モデルが結果を解釈しやすい構造にする。

長時間処理の扱い

クローラーのような長時間ツールは同期実行だとタイムアウトの温床になる。ジョブ投入と状態確認の2ツールに分割する設計が安定する。