Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.
Menu Docs

Início rápido da Voyage AI

Neste guia, você aprenderá a gerar suas primeiras incorporações vetoriais com o Voyage IA e a criar um aplicativo básico.

Para acessar os modelos de IA do Voyage, crie uma chave de API de modelo na IU do MongoDB Atlas.

1

Se você é novo no Atlas, ele cria uma organização e um projeto para você.

Para saber mais, consulte Criar uma Conta Atlas.

2
  1. No seu projeto Atlas , selecione AI Model APIs na barra de navegação.

  2. Clique em Create model API key.

  3. Dê um nome à chave API e clique em Create.

Para aprender mais, consulte Gerenciar chaves de API do modelo Voyage AI.

3

Copie a chave API e armazene-a em uma localização segura. Em seguida, exporte a chave API como uma variável de ambiente em seu terminal para que o cliente Voyage possa acessá-la.

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

Nesta seção, você gera incorporações vetoriais usando um modelo de incorporação Voyage AI e o cliente Python.

Diagrama de incorporação do Voyage IA
clique para ampliar
1

Executar os seguintes comandos no seu terminal para criar seu projeto e instalar o cliente Voyage IA Python.

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

Crie um arquivo denominado quickstart.py em seu projeto e cole o seguinte código nele. Este código inicializa o cliente Voyage IA, define textos de exemplo e usa o cliente para acessar a API Voyage para gerar incorporações vetoriais com o modelo voyage-4-large.

Para obter detalhes,consulte Cliente Python ou navegue na especificação completa da 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

Execute o seguinte comando no seu terminal para gerar as incorporações.

python quickstart.py
Generated 2 embeddings
Each embedding has 1024 dimensions
First embedding (truncated): [0.05843968689441681, -0.035438042134046555, -0.059422507882118225, -0.018386829644441605, -0.04523468762636185]...

Agora que você sabe como gerar incorporações vetoriais, crie um aplicativo RAG básico para aprender como usar os modelos de Voyage AI para implementar a pesquisa e a recuperação de IA. O RAG permite que os LLMs gerem respostas sensíveis ao contexto, recuperando informações relevantes de seus dados antes de gerar respostas.

Observação

Aplicativos RAG exigem acesso a um LLM. Este tutorial fornece exemplos usando Athropic ou OpenAI, mas você pode usar qualquer fornecedor de LLM de sua escolha.

Diagrama básico do Voyage IA RAG
clique para ampliar

Agora que você criou seu primeiro aplicativo com o Voyage AI, expanda as seções a seguir para saber mais sobre os conceitos abordados neste início rápido:

Para continuar aprendendo, consulte os seguintes recursos: