GoogleCloudPlatform/cymbal-air-toolbox-demo

어떤 프로젝트인가요?

핵심 기능

• 01LLM이 도구를 동적으로 선택하는 LangGraph 기반 에이전트 오케스트레이션
• 02인증과 권한 부여를 처리하는 MCP Toolbox를 통한 데이터베이스 접근
• 03데이터베이스 데이터를 바탕으로 답변을 생성하는 RAG
• 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와 별도의 앱 실행 안내를 따라야 합니다.

포함된 컬렉션

토픽

자주 묻는 질문

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은(는) 아직 유지보수되고 있나요?

6개월 이내 업데이트. 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