このハンズオンでは、Google ADK (Agent Development Kit) for Goを使ってAIエージェントを作成する方法を学びます。 基本的なGoの文法などは、このハンズオンでは扱いません。

ADKについては、ADK公式ドキュメントを参照してください。

このハンズオンを行うには、以下の準備が必要です。

• Go 1.25以上のインストール
• Google AI Studio で API キーを取得し、環境変数 GOOGLE_API_KEY に設定

export GOOGLE_API_KEY="your-api-key"

このハンズオンを行うと以下のことが学べます。

• ADK Goの基本的な使い方
• LLMエージェントの作成方法
• 組み込みツール（Google検索）の使い方
• カスタムツールの作成方法
• MCPサーバーの作成と利用方法

一方、学べないことは以下のとおりです。

• Goの開発環境のインストール方法
• IDEやエディタの設定
• 基本的な文法
• 生成AIやLLMの仕組み
• プロンプトエンジニアリング

skeletonディレクトリ以下に問題があり、4つのステップに分けられています。 STEP 1からSTEP 4までステップごとに進めていくことで、ADK Goに関する知識が学べます。

各ステップに、READMEが用意されていますので、まずはREADMEを読みます。 READMEには、そのステップを理解するための解説が書かれています。

READMEを読んだら、ソースコードを開きTODOコメントが書かれている箇所をコメントに従って修正して行きます。 TODOコメントをすべて修正し終わったら、READMEに書かれた実行例に従ってプログラムをコンパイルして実行します。

途中でわからなくなった場合は、solutionディレクトリ以下に解答例を用意していますので、そちらをご覧ください。

また、NotebookLMでハンズオンの内容について質問することもできます。

• STEP 1: はじめてのエージェント（解答例）
• STEP 2: Google検索ツールを使う（解答例）
• STEP 3: カスタムツールを作る（解答例）
• STEP 4: MCPサーバーを作る（解答例）

この資料を元にハンズオンを開催するために@tenntennの許可などはいりません。 好きに開催してください。 @tenntennの行ける範囲であれば、開催するから解説して欲しいという依頼もウェルカムです。

なお、forkして変更してもらっても構いませんが、できればPRをいただけると嬉しいです。 資料に間違えを発見した方もissueやPRを頂ければ対応します。