Repolode
投稿する
GoogleCloudPlatform

GoogleCloudPlatform/cymbal-air-toolbox-demo

LangGraphとRAGを使い、MCP Toolbox経由でGoogle Cloudのデータベースを検索する、架空の航空会社向けカスタマーサービスエージェントのデモです。

GitHub で見る公式サイト
スター
350
フォーク
123
未解決の Issue
53
最終コミット
3 か月前

これは何？

Google Cloudのデータベースを利用するエージェント型カスタマーサービスアプリケーションのリファレンス実装です。架空の航空会社Cymbal Airと、その拠点であるサンフランシスコ国際空港をシナリオにしています。アシスタントは旅行者のフライトに関する手続きを支援し、近くのコーヒーショップやターミナル内の店舗、指定都市へのフライトなど、空港についての質問にも答えます。

エージェントのオーケストレーションにはLangGraphを使用しています。固定された呼び出しチェーンに従うのではなく、LLMがどのツールをどの順番で呼び出すかを選択します。各ツールは、フライトの検索や空港施設の一覧表示など、あらかじめ定義されたデータベースクエリに対応します。Retrieval Augmented Generationにより、データベースに保存されたデータに基づいて回答を生成します。

データベースへのアクセスには、データベース操作をツールとして公開し、認証と認可を処理するミドルウェアサーバーのMCP Toolboxを使用するため、エージェントがデータベースに直接接続することはありません。データベース層は差し替え可能とされており、デモにはtools.yaml設定を使ってCloud SQL互換のデータベースやその他のGoogle Cloudデータベースをセットアップする手順が含まれています。

主な機能

  • 01LLMがツールを動的に選択する、LangGraphによるエージェントのオーケストレーション。
  • 02認証と認可を処理するMCP Toolbox経由のデータベースアクセス。
  • 03データベースのデータに基づいて回答を生成するRetrieval Augmented Generation。
  • 04find_flightsやlist_amenitiesなど、データベースクエリに対応する事前定義済みツール。
  • 05tools.yamlファイルでツールを設定でき、ローカルまたはCloud Runで実行可能。

ユースケース

  • クラウドデータベースを検索するカスタマーサービスエージェントの構築方法を学ぶ。
  • 独自のデータベースとMCP Toolboxを使うエージェント型アプリの出発点にする。
  • ミドルウェア層を通じてエージェントのデータベースアクセスを制限する方法を検証する。

クイックスタート

  1. 1

    リポジトリをクローンする

    git clone https://github.com/GoogleCloudPlatform/cymbal-air-toolbox-demo.git
  2. 2

    MCP Toolbox バイナリをダウンロードする（README に記載された Linux amd64 の例）

    curl -O https://storage.googleapis.com/genai-toolbox/v$VERSION/linux/amd64/toolbox
  3. 3

    Database Setup Guide に従って、データベースと tools.yaml の初期設定を行う

  4. 4

    Toolbox サーバーをローカルで実行する

    ./toolbox --tools-file "tools.yaml"

使う前に知っておきたいこと

  • README には、これはデモであり、Google が公式にサポートする製品ではないと記載されています。
  • 実行するには、まず Google Cloud データベースと MCP Toolbox サーバーをセットアップする必要があります。
  • セットアップには複数の手順があり、Database Setup Guide と別途用意されたアプリの実行手順に従う必要があります。

収録されている特集

オープンソースの AI エージェント・フレームワークとアプリMCP サーバーデータベースと SQL ツール

トピック

#agent#langgraph#rag#mcp#google-cloud#postgresql#llm#demo#agents#ai

よくある質問

cymbal-air-toolbox-demo とは？
LangGraphとRAGを使い、MCP Toolbox経由でGoogle Cloudのデータベースを検索する、架空の航空会社向けカスタマーサービスエージェントのデモです。 Google Cloudのデータベースを利用するエージェント型カスタマーサービスアプリケーションのリファレンス実装です。架空の航空会社Cymbal Airと、その拠点であるサンフランシスコ国際空港をシナリオにしています。アシスタントは旅行者のフライトに関する手続きを支援し、近くのコーヒーショップやターミナル内の店舗、指定都市へのフライトなど、空港についての質問にも答えます。
cymbal-air-toolbox-demo は無料で使えますか？ライセンスは？
cymbal-air-toolbox-demo は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
cymbal-air-toolbox-demo は今もメンテナンスされていますか？
半年以内に更新あり。cymbal-air-toolbox-demo の最終コミットは 2026年8月14日 です。
cymbal-air-toolbox-demo は何に使えますか？
クラウドデータベースを検索するカスタマーサービスエージェントの構築方法を学ぶ。 独自のデータベースとMCP Toolboxを使うエージェント型アプリの出発点にする。 ミドルウェア層を通じてエージェントのデータベースアクセスを制限する方法を検証する。
cymbal-air-toolbox-demo のインストール方法は？
リポジトリをクローンする: git clone https://github.com/GoogleCloudPlatform/cymbal-air-toolbox-demo.git MCP Toolbox バイナリをダウンロードする（README に記載された Linux amd64 の例）: curl -O https://storage.googleapis.com/genai-toolbox/v$VERSION/linux/amd64/toolbox Database Setup Guide に従って、データベースと tools.yaml の初期設定を行う Toolbox サーバーをローカルで実行する: ./toolbox --tools-file "tools.yaml"
cymbal-air-toolbox-demo はどこで入手できますか？
ソースコードとインストール手順は GitHub にあります：https://github.com/GoogleCloudPlatform/cymbal-air-toolbox-demo

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト