Docs Menu
Docs Home
/

보야지 AI 퀵 스타트

이 가이드 에서는Voyage AI 사용하여 첫 번째 벡터 임베딩을 생성하고 기본 애플리케이션 빌드 방법을 학습 .

이 튜토리얼의 실행 가능한 버전을 Python 노트북으로 사용합니다.

Voyage AI 모델에 액세스 하려면 MongoDB Atlas UI 에서 모델 API 키를 생성합니다.

1

Atlas 를 처음 사용하는 경우 조직 과 프로젝트 생성됩니다.

자세히 학습 Atlas 계정 만들기를 참조하세요.

2
  1. Atlas 프로젝트 의 탐색 모음에서 AI Models 을 선택합니다.

  2. Create model API key를 클릭합니다.

  3. API 키에 이름을 지정한 다음 Create를 클릭합니다.

자세히 학습 모델 API 키를 참조하세요.

3

API 키를 복사하여 안전한 위치 에 저장 . 그런 다음 터미널에서 API 키를 환경 변수로 내보내어 Voyage 클라이언트 액세스 할 수 있습니다.

export VOYAGE_API_KEY="<your-model-api-key>"
set VOYAGE_API_KEY=<your-model-api-key>

이 섹션에서는Voyage AI 임베딩 모델과 Python 클라이언트 사용하여 벡터 임베딩을 생성합니다.

Voyage AI 임베딩 다이어그램
클릭하여 확대
1

터미널에서 다음 명령을 실행하여 프로젝트 생성하고 Voyage AI Python 클라이언트 설치합니다.

mkdir mongodb-voyage-quickstart
cd mongodb-voyage-quickstart
pip install --upgrade voyageai
2

프로젝트 에 quickstart.py 라는 파일 만들고 다음 코드를 붙여넣습니다. 이 코드는Voyage AI 클라이언트 초기화하고, 샘플 텍스트를 정의하며, 클라이언트 사용하여Voyage API 액세스 하여 voyage-4-large 모델로 벡터 임베딩을 생성합니다.

자세한 내용은 Python 클라이언트를 참조하거나 전체 API 사양을 살펴보세요.

import voyageai
# Initialize Voyage client
vo = voyageai.Client()
# Sample texts
texts = [
"hello, world",
"welcome to voyage ai!"
]
# Generate embeddings
result = vo.embed(
texts,
model="voyage-4-large"
)
print(f"Generated {len(result.embeddings)} embeddings")
print(f"Each embedding has {len(result.embeddings[0])} dimensions")
print(f"First embedding (truncated): {result.embeddings[0][:5]}...")
3

터미널에서 다음 명령을 실행하여 임베딩을 생성합니다.

python quickstart.py
Generated 2 embeddings
Each embedding has 1024 dimensions
First embedding (truncated): [-0.02806740067899227, 0.05503412336111069, 0.0038576999213546515, -0.04668188467621803, 0.007834268733859062]...

이제 벡터 임베딩을 생성하는 방법을 알게 되었으므로 기본 RAG 애플리케이션 빌드 Voyage AI 모델을 사용하여 AI 검색 구현 방법을 학습 . RAG를 사용하면 LLM이 답변을 생성하기 전에 데이터에서 관련 정보를 검색하여 컨텍스트 인식 응답을 생성할 수 있습니다.

참고

RAG 애플리케이션을 사용하려면 LLM에 액세스 해야 합니다. 이 튜토리얼에서는 Atronic 또는 OpenAI를 사용하는 예제를 제공하지만 원하는 LLM 제공자 사용할 수 있습니다.

기본 Voyage AI RAG 다이어그램
클릭하여 확대

이제 Voyage AI 사용하여 첫 번째 애플리케이션 만들었으므로 다음 섹션을 확장하여 이 빠른 시작에서 다루는 개념에 대해 자세히 학습 .

학습을 계속하려면 다음 리소스를 참조하세요.

스킬 레벨
문서 리소스

기본

중급

돌아가기

서론

이 페이지의 내용