GoogleCloudPlatform/cymbal-air-toolbox-demo

这是什么？

核心功能

• 01使用 LangGraph 编排 Agent，由大模型动态选择工具。
• 02通过 MCP Toolbox 访问数据库，由其负责认证与授权。
• 03采用检索增强生成（RAG），让回答基于数据库数据。
• 04提供 find_flights、list_amenities 等预定义工具，对应具体数据库查询。
• 05通过 tools.yaml 配置工具，可在本地或 Cloud Run 上运行 Toolbox。

适用场景

• 学习如何构建查询云数据库的客服 Agent。
• 基于 MCP Toolbox 和自有数据库，搭建定制化 Agent 应用的起点。
• 探索如何通过中间件层限制 Agent 对数据库的访问。

快速上手

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

   按照数据库设置指南完成一次性的数据库和 tools.yaml 配置

4. 4

   在本地运行 Toolbox 服务器

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

使用前须知

• !README 声明这是演示项目，并非 Google 官方支持的产品。
• !运行前需要先配置 Google Cloud 数据库和 MCP Toolbox 服务器。
• !设置包含多个步骤，依赖数据库设置指南和单独的应用运行说明。

收录于专题

标签

常见问题

cymbal-air-toolbox-demo 是什么？

基于 LangGraph 与 RAG 的客服 Agent 示例，通过 MCP Toolbox 查询 Google Cloud 数据库。 这是一个基于 Google Cloud 数据库构建的 Agent 客服应用参考实现。场景设定为虚构航空公司 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 适合用来做什么？

学习如何构建查询云数据库的客服 Agent。 基于 MCP Toolbox 和自有数据库，搭建定制化 Agent 应用的起点。 探索如何通过中间件层限制 Agent 对数据库的访问。

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 按照数据库设置指南完成一次性的数据库和 tools.yaml 配置 在本地运行 Toolbox 服务器: ./toolbox --tools-file "tools.yaml"

在哪里获取 cymbal-air-toolbox-demo？

源代码和安装说明在 GitHub 上：https://github.com/GoogleCloudPlatform/cymbal-air-toolbox-demo