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.
Make the MongoDB docs better! We value your opinion. Share your feedback for a chance to win $100.
MongoDB Branding Shape
Click here >
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

A embedding automatizada é suportada em clusters Free (M0), tier Flex e dedicado (M10+).

Para usar o embedding automatizado em clusters dedicados (M10+), você deve habilitar o armazenamento e o dimensionamento automático da camada do cluster. O dimensionamento automático é necessário para dimensionar os recursos para a construção de índices iniciais em grandes datasets. Depois que a construção de índice for concluída, o cluster será dimensionado de volta para o seu tier de computação original, considerando que o novo tamanho do índice não exige recursos de armazenamento maiores.

Defina as configurações de dimensionamento automático da seguinte forma:

  • Se o camada do cluster atual for M10 ou M20 (instâncias de CPU com capacidade de intermitência), defina um tamanho máximo de instância de M30 ou superior.

  • Se a camada do cluster atual for M30 ou superior, defina o tamanho máximo da instância para um tier superior ao tier atual.

  • Para clusters que usam o armazenamento NVMe, selecione a opção Dimensionar a camada do cluster NVME quando o armazenamento estiver baixo.

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.

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 queries de pesquisa vetorial.

Observação

O recurso está disponível para implantações do MongoDB Search e do MongoDB Pesquisa Vetorial usando Docker, tarball ou um gerenciador de pacotes e para implantações usando o MongoDB Drivers for Kubernetes Operator com o MongoDB 8.2 ou posterior Community Edition. A funcionalidade de embedding automatizada ainda não está disponível para a 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 do MongoDB Search e Vector Search,, mongot você pode fornecer as chaves da API do 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. O MongoDB pesquisa vetorial gera embeddings para a query de texto usando o mesmo embedding model na definição do índice. Você pode especificar um diferente embedding model 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. A pesquisa vetorial do MongoDB usa a chave de API de query que você forneceu durante a inicialização da MongoDB Community para gerar os embeddings no momento da query. Para saber mais, consulte Executar queries de Vector Search.

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

Para automatizar incorporações e executar uma query de amostra, consulte Tutorial de início rápido do MongoDB Vector Search .

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:

Após criar as chaves, você deve especificar as chaves que deseja utilizar para incorporação automatizada ao configurar o mongot durante a implantação com MongoDB Community Edition. O MongoDB Vector Search usa a chave de API do Voyage IA 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-3

Especificamente para pesquisa de código e documentação técnica.

$0.18

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 incorporados e LLMs, os tokens são as unidades fundamentais de texto, como palavras, subpalavras ou caracteres, que o modelo processa para criar incorporações ou gerar texto. Os tokens são como você é cobrado pelo uso de modelos de incorporação 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.

  • dotProduct - mede a similaridade como cosine, mas leva em conta a magnitude do vetor. Recomendamos esta função de similaridade para fidelidade total ou quantization scalar.

  • 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.