참고
Vertex AI 확장 기능은 미리보기 버전이며 변경될 수 있습니다. 이 기능에 접근하려면 Google Cloud 담당자에게 문의하세요.
Vertex AI MongoDB Vector Search와 함께 사용하여 RAG를 구현 것 외에도,Vertex AI 확장을 사용하여 Vertex AI 모델을 사용하여 Atlas 와 상호 작용 방법을 추가로 사용자 지정할 수 있습니다. 이 튜토리얼에서는 언어 사용하여 Atlas 에서 실시간 으로 데이터를 쿼리 할 수 있는 Vertex AI 확장을 만듭니다.

배경
이 튜토리얼에서는 다음 구성 요소를 사용하여 Atlas에서 자연어 쿼리를 활성화합니다.
Google Cloud Platform Vertex AI SDK 를 사용하여 AI 모델을 관리 하고 Vertex AI 에 대한 사용자 지정 확장을 활성화 . 이 튜토리얼에서는 Gemini 1.5 프로 모델.
Google Cloud Run으로 Vertex AI와 Atlas 간의 API 엔드포인트 역할을 하는 함수를 배포합니다.
OpenAPI 3 언어 쿼리가 MongoDB 작업에 매핑되는 방식을 정의하는 MongoDB API 사양입니다. 자세한 학습 은 OpenAPI 사양을 참조하세요.
Vertex AI Extensions 를 사용하면 Vertex AI 의 Atlas 와 실시간 상호 활성화 있으며 언어 쿼리가 처리되는 방식을 구성할 수 있습니다.
MongoDB API 키를 저장 하는Google Cloud Platform Secrets 관리자 .
참고
상세한 코드와 설정 지침은 이 예시의 GitHub 리포지토리를 참조하세요.
전제 조건
시작하기 전에 다음이 필요합니다.
MongoDB Atlas 계정. Google Cloud Platform Marketplace 를 사용하거나 새 계정을 등록하세요.
샘플 데이터세트 가 로드된 Atlas 클러스터. 자세한 내용은 Atlas Infinite 또는 Atlas Core 클러스터 생성을 참조하세요.
Google Cloud Platform 프로젝트.
OpenAPI 사양을 저장하기 위한 Google Cloud Platform 스토리지 버킷입니다.
프로젝트에 대해 다음 API가 활성화 되었습니다.
Cloud Build API
Cloud Functions API
Cloud Logging API
클라우드 Pub/Sub API
Colab Enterprise 환경입니다.
Google Cloud 실행 함수 생성
이 섹션에서는 Vertex AI 확장 기능과 Atlas 클러스터 간의 API 엔드포인트 역할을 하는 Google Cloud Run 함수를 생성합니다. 이 함수는 인증을 처리하고, Atlas 클러스터에 연결하며, Vertex AI의 요청에 따라 데이터베이스 작업을 수행합니다.
새 함수를 만듭니다.
Google Cloud Platform 콘솔에서 Cloud Run 페이지를 열고 Write a function를 클릭합니다.
함수를 구성합니다.
함수를 배포 하려는 함수 이름과 Google Cloud Platform 리전 지정합니다.
Runtime(으)로 제공되는 최신 Python 버전을 선택합니다.
Authentication section에서 Allow unauthenticated invocations를 선택합니다.
나머지 설정에는 기본값 을 사용한 다음 Next을(를) 클릭합니다.
자세한 구성 단계는 Cloud Run 문서를 참조하세요.
Vertex AI 확장 기능 생성
이 섹션에서는 Gemini 1.5 Pro 모델을 사용하여 Atlas에서 데이터에 대한 자연어 쿼리를 가능하게 하는 Vertex AI 확장 기능을 만듭니다. 이 확장 기능은 OpenAPI 사양과 사용자가 생성한 Cloud Run 함수를 사용하여 자연어를 데이터베이스 작업에 매핑하고 Atlas에서 데이터를 쿼리합니다.
이 확장 기능을 구현하려면 Python 코드 스니펫을 개별적으로 실행할 수 있는 대화형 Python 노트북을 사용합니다. 이 튜토리얼에서는 Colab Enterprise 환경에서 mongodb-vertex-ai-extension.ipynb이라는 노트북을 만듭니다.
자연어 쿼리 실행
In Vertex AI에서 왼쪽 탐색 메뉴의 Extensions 를Extensions 클릭합니다. MongoDB Vertex API Interpreter라는 새 확장 기능이 확장 목록에 표시됩니다.
다음 예시는 Atlas에서 데이터 쿼리에 사용할 수 있는 자연어 쿼리 두 가지입니다.

