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

Visão geral do embedding automatizado

Você pode configurar o MongoDB Vector Search para gerar e gerenciar automaticamente vector embeddings para os dados de texto em seu cluster Atlas. Quando você ativa a Incorporação automatizada, o MongoDB **Vector Search** gera automaticamente **embeddings** usando o **embedding model** da Voyage AI especificado no momento do **índice** para o **campo** de texto especificado em sua **coleção** e no momento da **query** para a **string** de texto em sua **query**.

A Automated embedding simplifica o processo de criação de pesquisa semântica. Você não precisa gerar, armazenar ou gerenciar vector embeddings por conta própria. O Atlas lida com a geração de embedding, atualizações e query nativamente.

Observação

Quando você usa o Automated Embedding, o MongoDB pesquisa vetorial armazena embedding vetoriais gerados em seu cluster.

Ao usar o Automated Embedding em cluster dedicado (M10+), você deve habilitar o dimensionamento automático do armazenamento. Se o cluster ficar sem espaço em disco, o MongoDB Vector Search pausará a geração de embedding e o índice fará a transição para o estado Stale. Assim que o espaço em disco for liberado, o MongoDB pesquisa vetorial retomará a geração de embedding.

Você pode implantar o MongoDB Vector Search e ativar a pesquisa semântica inteligente com IA em seus dados de texto por meio da Incorporação automatizada nos índices do MongoDB Vector Search. As funcionalidades de incorporação automatizada do MongoDB transformam o processo tradicionalmente complexo de implementação de pesquisa vetorial em uma solução de etapa única. Em vez de gerenciar a infraestrutura de incorporação, a seleção de modelo e o código de integração separados, agora você pode implementar a pesquisa semântica por meio de uma simples configuração de campo .

Quando você configura índices do MongoDB Vector Search, ele gera automaticamente incorporações vetoriais para dados de texto em sua coleção, usando sua seleção de um modelo de incorporação Voyage AI de última geração, mantém as incorporações em sincronização à medida que seus dados são alterados e também suporta uso de queries de texto em linguagem natural. Essas incorporações vetoriais capturam relacionamentos significativos em seus dados e permitem a pesquisa com base em intenção, em vez de palavras-chave.

Importante

As incorporações automatizadas estão disponíveis como um recurso de visualização. O recurso e a documentação correspondente podem mudar a qualquer momento durante o período de Pré-visualização. Não use este recurso em seu ambiente de produção. No momento, não usamos nenhum dado de cliente desse recurso para treinar nossos modelos. Para saber mais, consulte Visualizar recursos.

Para habilitar a embedding automatizada, crie um índice do MongoDB pesquisa vetorial usando o tipo autoEmbed . O tipo de autoEmbed especifica o campo para o qual você deseja habilitar a Automated embedding e o embedding model que deseja utilizar. Você também pode incluir um ou mais campos para pré-filtrar seus dados usando o tipo filter.

1{
2 "fields": [
3 {
4 "type": "autoEmbed",
5 "modality": "text",
6 "path": "<field-to-index>",
7 "model": "<embedding-model>"
8 },
9 {
10 "type": "filter",
11 "path": "<field-to-index>"
12 },
13 ...
14 ]
15}

Para aprender mais sobre a sintaxe e os campos do índice, consulte Como indexar campos para a pesquisa vetorial.

A pesquisa vetorial do MongoDB gera automaticamente embeddings para documents novos e existentes que você insere ou atualiza.

Depois de criar o índice, você pode executar suas query. O MongoDB pesquisa vetorial gera automaticamente embeddings para seu texto de query usando o mesmo embedding model especificado no índice. Opcionalmente, você pode especificar um embedding model diferente usando a opção model no estágio de pipeline $vectorSearch, mas o embedding model especificado deve ser compatível com o embedding model usado no momento do índice.

1[
2 {
3 "$vectorSearch": {
4 "index": "<index-name>",
5 "path": "<field-to-index>",
6 "query": "<query-text>",
7 "model": "<embedding-model>"
8 }
9 },
10 {
11 "$project": {
12 "_id": 0,
13 "<field-to-index>": 1,
14 "score": { "$meta": "vectorSearchScore" }
15 }
16 }
17]

Para saber mais, consulte Executar consultas ANN e ENN de pesquisa vetorial.

Observação

O recurso está disponível para implantações do MongoDB Search e do MongoDB Vector Search usando Docker, tarball ou um gerenciador de pacote e para implantações usando o MongoDB Drivers for Kubernetes Operator com MongoDB.8 2 ou posterior Community Edition. A funcionalidade de incorporação automatizada ainda não está disponível para o MongoDB Enterprise Edition.

Com uma alteração simples de configuração, você pode ativar a pesquisa semântica, o RAG e a memória para os agentes de IA sem escrever código de incorporação, gerenciar a infraestrutura do modelo ou lidar com pipelines vetoriais. Ou seja, ao implantar o MongoDB Community Edition com o processo de MongoDB Search e Vector Search,, mongot você pode fornecer as chaves da API Voyage AI para usar na geração de incorporações, de preferência uma para operações de indexação e outra para operações de query de diferentes projetos.

Após a implantação:

  1. Na sua coleção, escolha o campo de texto para o qual deseja habilitar a pesquisa semântica.

  2. Na lista de modelos de incorporação disponíveis, escolha um modelo de incorporação.

  3. Em sua definição de índice do MongoDB Vector Search, configure a Incorporação automatizada usando o tipo autoEmbed.

Para saber mais sobre como configurar o índice do MongoDB pesquisa vetorial para embedding automatizado, consulte Como indexar campos para o pesquisa vetorial.

MongoDB Vector Search gera automaticamente incorporações para documentos novos e existentes que você insere ou atualizar usando as chaves de API especificadas ao inicializar o MongoDB Community Edition.

Para query, use a opção query.text no estágio de pipeline $vectorSearch. A pesquisa vetorial do MongoDB gera embedding para a query de texto usando o mesmo modelo de embedding na definição do índice. Você pode especificar um modelo de embedding diferente usando a opção model no estágio de pipeline $vectorSearch, mas o modelo de embedding especificado deve ser compatível com o modelo de embedding usado no momento do índice. O MongoDB Vector Search usa a chave de API de query que você forneceu durante a inicialização do MongoDB Community para gerar os embedding no momento da query. Para aprender mais, consulte Executar query ANN e ENN de pesquisa vetorial.

Você incorre em cobranças por gerar incorporações usando as chaves de API. Para saber mais, consulte Gerenciar faturamento.

Para automatizar embedding e executar uma query de amostra, consulte MongoDB pesquisa vetorial Quick Start Tutorial.

Embora seja possível usar uma única chave de API para gerar incorporações no momento do índice e no momento da query, recomendamos que você use chaves de API separadas para evitar que as operações de query afetem negativamente as operações de indexação.

Você pode gerar chaves de API das seguintes maneiras:

Depois de criar as chaves, você deve especificar as chaves que deseja usar para incorporação automatizada ao configurar mongot durante a implantação com o MongoDB Community Edition. O MongoDB Vector Search usa a chave de API do Voyage AI que você forneceu durante a implantação do mongot para gerar automaticamente incorporações para seus dados no índice e para seu texto de query no momento da query.

Índices de incorporação automatizados geram vector embeddings de forma assíncrona e persistem no cluster MongoDB em um banco de dados de reserva separado. Cada índice de embedding Automatizada tem exatamente uma Coleção de embeddings gerada correspondente. A coleção de incorporações gerada é armazenada em um banco de dados interno dedicado no mesmo cluster.

Para aprender mais, consulte Coleção de incorporações geradas.

O MongoDB Vector Search se integra aos modelos de incorporação de última geração da Voyage IA, cada um otimizado para casos de uso específicos:

Modelo de incorporação
Descrição
Preço por 1M de tokens

voyage-4-lite

Otimizado para aplicativos de alto volume e sensíveis ao custo.

$0.02

voyage-4

(Recomendado) Desempenho balanceado para pesquisa geral de texto.

$0.06

voyage-4-large

Máxima precisão para relacionamentos semânticos complexos.

$0.12

voyage-code-4

(Recomendado para código) especializado em pesquisa de código e documentação técnica.

$0.12

voyage-code-3

Modelo legado especializado em pesquisa de código e documentação técnica. Em vez disso, use voyage-code-4.

$0.18

Observação

voyage-code-4 requer um sistema Atlas . Em implementações autogerenciadas, utilize o voyage-code-3 para pesquisa de código e documentação técnica.

Para aprender mais, consulte Models para embedding automatizada.

modelo de incorporação

Embedding models são algoritmos que convertem dados em vector embeddings que capturam o significado semântica ou subjacente dos dados. Estes vetores habilitam a pesquisa vetorial.

Para saber mais sobre os modelos de incorporação para incorporação automatizada, consulte Modelos disponíveis.

incorporações de vetor

Uma incorporação de vetor é uma array de números, com cada dimensão representando uma funcionalidade ou atributo diferente de seus dados. Os vetores podem ser usados para representar qualquer tipo de dados, de texto, imagens e vídeo a dados não estruturados. Você cria incorporações vetoriais passando seus dados por um modelo de incorporação e pode armazenar essas incorporações em um banco de dados que oferece suporte a incorporações vetoriais, como o MongoDB.

Para aprender mais sobre o armazenamento de embeddings para Automated Embedding, consulte Coleção de embeddings gerada.

tokens

No contexto de modelos de embedding e LLMs, os tokens são as unidades fundamentais de texto, como palavras, subpalavras ou caracteres que o modelo processa para criar embeddings ou gerar texto. Os tokens são como você é cobrado pelo uso de modelos de embedding e LLMs.

Para aprender mais sobre tokens para Automated embedding, consulte Gerenciar Faturamento para Automated embedding.

limites de taxa

Os limites de taxa são restrições impostas pelos fornecedores de API sobre o número de solicitações que um usuário pode fazer dentro de um período de tempo específico, geralmente medido em tokens por minuto (TPM) ou solicitações por minuto (RPM). Esses limites garantem o uso leal, evitam violações e mantêm a estabilidade e o desempenho do serviço para todos os usuários.

Para saber mais sobre os limites de taxa de Automated embedding, consulte Limites de taxa.

quantização

A quantization reduz a precisão das vector embeddings para diminuir o uso de memória e armazenamento, com desvantagens na precisão da pesquisa. Para Automated embedding, o MongoDB Vector Search suporta os seguintes tipos de quantization:

Quantization Type
Descrição

float

Armazena as vector embeddings como valores float de 32bits.

scalar

Reduz cada vector dimension de 32-bit float para 8-bit inteiros.

binary

Reduz cada dimensions para um único bit e redefine os principais resultados.

binaryNoRescore

Reduz cada vector dimensions para um único bit sem reclassificar.

Para saber mais sobre a quantization para Automated embedding, consulte Sobre a quantization.

número de dimensões

O número de dimensions especifica o comprimento do vetor de embedding para cada document ( quantos números estão na array ). Higher dimensions capturam mais detalhes semânticas e, em geral, melhoram a precisão da recuperação, mas aumentam os custos de armazenamento e computação (tamanho do índice, uso de RAM e, às vezes, latência).

Para saber mais, consulte SeleçãonumCandidates .

similaridade

A função de similaridade é utilizada para medir a similaridade entre dois vetores ou a proximidade de um vetor de query dos vetores no índice. O MongoDB pesquisa vetorial oferece suporte às seguintes funções de similaridade:

  • cosine - mede a similaridade com base no ângulo entre os vetores. Recomendamos esta função de similaridade para vetores não normalizados, como a quantização scalar.

  • dotProduct - mede a similaridade como cosine, mas leva em consideração a magnitude do vetor. Recomendamos esta função de similaridade para vetores normalizados como quantização float (fidelidade total).

  • euclidean - mede a distância entre as extremidades dos vetores. Recomendamos esta função de similaridade para quantization binary ou binaryNoRescore, onde os vetores são compactados e a distância no espaço Hamming ou Euclideano é o sinal correto.

Para aprender mais sobre as funções de similaridade da Automated embedding, consulte Sobre as funções de similaridade.