GDG Sri Lanka DevFest 2026 — Google ADK マルチターン個人財務エージェント（gdg-srilanka-26-google-adk-js）

AI/ML
GDG Sri Lanka DevFest 2026 — Google ADK マルチターン個人財務エージェント（gdg-srilanka-26-google-adk-js）

GDG Sri Lanka DevFest 2026 — Google ADK マルチターン個人財務エージェント（gdg-srilanka-26-google-adk-js）

Google ADK と TypeScript で構築された、マルチターンの会話型AIエージェントのサンプルリポジトリ。Gemini 2.5 Flash を用いて会話の文脈を保持し、個人向けファイナンス支援を想定したステートフルなエージェントをデモ。GDG Sri Lanka DevFest 2026 用に作成された実践的な参考実装で、Vue ベースのデモや Bun/Node 向けのテストコードも含む（約300字）。

https://github.com/octalpixel/gdg-srilanka-26-google-adk-js

概要

このリポジトリは「Multi-Turn Personal Finance Agent」と題された、Google ADK（Agent Development Kit）と TypeScript を用いたマルチターン会話エージェントの実装例です。Gemini 2.5 Flash モデルを利用してユーザーの会話文脈を保持し、複数ターンにまたがる問い合わせ・対話を管理できます。GDG Sri Lanka DevFest 2026 向けに作られたデモプロジェクトで、実運用を意識した設計やサンプルコード（デモUI、基盤ライブラリ、Bun/Node 用テスト）を含み、開発者が ADK を使ったステートフルな会話エージェントを学ぶための実践的リソースになっています。

GitHub

リポジトリの統計情報

  • スター数: 28
  • フォーク数: 8
  • ウォッチャー数: 28
  • コミット数: 2
  • ファイル数: 6
  • メインの言語: Vue

主な特徴

  • Google ADK と Gemini 2.5 Flash を用いたマルチターン（状態保持）会話エージェントの実装サンプル
  • TypeScript ベースで、実践的な構成（基盤ライブラリ／デモ／簡単なテスト）を含む
  • Vue を使ったフロントエンドデモ（会話 UI）と、Bun/Node 環境向けのテストファイルを提供
  • GDG DevFest 向けの教育／デモ用途に適した読みやすい構成

技術的なポイント

本プロジェクトの中心は「状態を持ちながら複数ターンを処理する会話エージェント」の構築例です。Google ADK を使うことで、単発のプロンプト応答ではなく、会話履歴やセッション情報を踏まえた対話管理が可能になります。Gemini 2.5 Flash を対話モデルに採用している点は、自然言語理解や生成の品質を担保しつつ、低レイテンシな対話を目指す設計として有効です。

TypeScript による型付けで、エージェントのインターフェースやアクションハンドラ、状態管理ロジックを明確に定義できます。リポジトリ内の adk-foundation ディレクトリは、ADK の共通処理（セッション初期化、コンテキストの永続化、外部API呼び出しのラッパーなど）をまとめる意図が見て取れます。demo ディレクトリは Vue ベースのフロントエンドで、実際のブラウザ上での会話フローやデバッグを容易にします。bun-node-prompt-test.ts の存在は、Bun や Node 環境でのプロンプト発火やモデル呼び出しを軽く検証するためのユーティリティ／テストを示唆します。

実運用を想定すると、以下の点が重要になります。まず、会話コンテキストの管理（メモリ設計）とトークンコストのバランスです。長い履歴をそのままモデルに送るとコストと遅延が増えるため、要約メモリや重要情報のみを残す戦略が必要です。次に、安全性とプライバシー（財務情報を扱う想定のため）は最優先で、ログの取り扱いや第三者API連携時の認証・暗号化を整備する必要があります。最後に、拡張性としては「ツール呼び出し」（外部計算、データ取得、トランザクション実行）を安全に組み込む設計が求められます。本リポジトリは教育・デモ目的の良い出発点であり、これらの実運用要件を追加実装することでプロダクション品質に近づけられます。

プロジェクトの構成

主要なファイルとディレクトリ：

  • .gitignore: file
  • README.md: file
  • adk-foundation: dir
  • bun-node-prompt-test.ts: file
  • demo: dir

…他 1 ファイル

（説明）

  • adk-foundation: ADK 向けの基礎コード（セッション/コンテキスト管理、共通ユーティリティ）
  • demo: Vue を使ったフロントエンドデモ。会話UI と簡易的なデバッグ/操作パネルを想定
  • bun-node-prompt-test.ts: Bun/Node 環境でのプロンプト送受信用のスクリプト／テスト例
  • README.md: 概要、セットアップ手順、使用モデル（Gemini 2.5 Flash）や目的（GDG DevFest 2026）を記載

現状コミット数が少なく、ファイル数も限られているため「雛形／サンプル」としての性格が強いです。実装を拡張する際は、認証・環境変数管理、ログの永続化、対話履歴の要約ロジック、エラー処理を追加することが推奨されます。

まとめ

ADK と Gemini を使ったマルチターン会話エージェントの実践的なサンプルで、学習とプロトタイピングに最適。

リポジトリ情報：

READMEの抜粋：

🤖 Multi-Turn Personal Finance Agent

A production-ready multi-turn conversational AI agent built with Google ADK (Agent Development Kit) and TypeScript. This project demonstrates stateful AI agents that maintain conversation context across multiple turns using the Gemini 2.5 Flash model.

Built for GDG Sri Lanka DevFest 2026 as a comprehensive example of building intelligent, context-aware AI agents.

[TypeScript](https://ww…