AI 에이전트의 경우: 문서 인덱스는 https://www.mongodb.com/ko-kr/docs/llms.txt에서 사용할 수 있으며, 모든 페이지의 마크다운 버전은 어떤 URL 경로에 .md를 추가하여 사용할 수 있습니다.

자연어 MongoDB 쿼리에 Vertex AI 확장 사용

참고

Vertex AI 확장 기능은 미리보기 버전이며 변경될 수 있습니다. 이 기능에 접근하려면 Google Cloud 담당자에게 문의하세요.

Vertex AI MongoDB Vector Search와 함께 사용하여 RAG를 구현 것 외에도,Vertex AI 확장을 사용하여 Vertex AI 모델을 사용하여 Atlas 와 상호 작용 방법을 추가로 사용자 지정할 수 있습니다. 이 튜토리얼에서는 언어 사용하여 Atlas 에서 실시간 으로 데이터를 쿼리 할 수 있는 Vertex AI 확장을 만듭니다.

Vertex AI 확장 기능 및 MongoDB Atlas를 사용한 워크플로 다이어그램

이 튜토리얼에서는 다음 구성 요소를 사용하여 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 리포지토리를 참조하세요.

시작하기 전에 다음이 필요합니다.

이 섹션에서는 Vertex AI 확장 기능과 Atlas 클러스터 간의 API 엔드포인트 역할을 하는 Google Cloud Run 함수를 생성합니다. 이 함수는 인증을 처리하고, Atlas 클러스터에 연결하며, Vertex AI의 요청에 따라 데이터베이스 작업을 수행합니다.

1

Google Cloud Platform 콘솔에서 Cloud Run 페이지를 열고 Write a function를 클릭합니다.

2
  1. 함수를 배포 하려는 함수 이름과 Google Cloud Platform 리전 지정합니다.

  2. Runtime(으)로 제공되는 최신 Python 버전을 선택합니다.

  3. Authentication section에서 Allow unauthenticated invocations를 선택합니다.

  4. 나머지 설정에는 기본값 을 사용한 다음 Next을(를) 클릭합니다.

자세한 구성 단계는 Cloud Run 문서를 참조하세요.

3

다음 코드를 해당 파일에 붙여넣습니다.

4
  1. Entry Point 의 이름을 mongodb_crud(으)로 변경합니다.

  2. 함수를 배포하려면 Deploy 를 클릭합니다.

  3. 클라우드 함수를 로컬에서 트리거하기 위한 HTTPS 엔드포인트를 복사하고 저장합니다.

  4. 함수의 Details 페이지로 이동하여 함수에서 사용되는 서비스 계정 이름을 복사하고 저장합니다.

이 섹션에서는 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에서 데이터 쿼리에 사용할 수 있는 자연어 쿼리 두 가지입니다.