Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.
Docs Menu

Resumen de la incrustación automatizada

Puedes configurar la búsqueda vectorial de MongoDB para generar y gestionar automáticamente los vector embeddings de los datos de texto en tu clúster de Atlas. Cuando habilites el Embedding Automatizado, MongoDB búsqueda vectorial generará automáticamente las incrustaciones utilizando el embedding model de Voyage AI especificado en el índice para el campo de texto especificado en tu colección y en el momento de la query para el string en tu query.

Incrustación automática simplifica el proceso de construcción de búsqueda semántica. No es necesario que generes, almacenes ni gestiones vector embeddings tú mismo. Atlas gestiona la generación de incrustaciones, actualizaciones y consultas de manera nativa.

Nota

Cuando utiliza la incrustación automatizada, MongoDB búsqueda vectorial almacena las incrustaciones vectoriales generadas en su clúster.

Cuando utilice la incrustación automatizada en clústeres dedicados (M10+), debe habilitar el escalado automático del almacenamiento. Si su clúster se queda sin espacio en disco, MongoDB Vector Search detiene la generación de incrustaciones y el índice pasa al estado Stale. Una vez que se libera el espacio en disco, MongoDB búsqueda vectorial reanuda la generación de incrustaciones.

Puedes implementar MongoDB Vector Search y habilitar una búsqueda semántica inteligente potenciada por IA en tus datos de texto mediante la incrustación automatizada en los índices de MongoDB Vector Search. Las capacidades automatizadas de Embedded de MongoDB transforman el proceso tradicionalmente complejo de implementación de búsqueda vectorial en una solución de un solo paso. En lugar de gestionar infraestructura de embedding por separado, elección de modelos y código de integración, ahora puedes implementar una búsqueda semántica mediante la simple configuración de campos.

Cuando configuras los índices de MongoDB Vector Search, este genera automáticamente incrustaciones vectoriales para los datos de texto de tu colección, utilizando tu selección de un modelo de incrustación de vanguardia de Voyage AI, mantiene las incrustaciones sincronizadas a medida que cambian tus datos y también soporta el uso de consultas de texto en lenguaje natural. Estos embeddings vectoriales capturan relaciones significativas en tus datos y permiten búsquedas basadas en la intención en lugar de palabras clave.

Importante

Automated Embeddings is available as a Preview feature. The feature and the corresponding documentation might change at any time during the Preview period. Do not use this feature in your production environment. We do not use any customer data from this feature to train our models at this time. To learn more, see Preview Features.

Para activar la Incrustación automatizada, cree un índice MongoDB de búsqueda vectorial utilizando el tipo autoEmbed. El tipo autoEmbed especifica el campo para el cual deseas habilitar la incrustación automatizada y el embedding model que deseas utilizar. También puede incluir uno o más campo para pre-filtro sus datos utilizando el 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 obtener más información sobre la sintaxis y los campos de índices, consulta Cómo indexar campos para la búsqueda vectorial.

MongoDB Vector Search genera automáticamente incrustaciones para document existentes y nuevos que insertes o actualices.

Una vez que hayas creado el índice, puedes ejecutar tus consultas. MongoDB búsqueda vectorial genera automáticamente incrustaciones para su query text utilizando el mismo embedding model que especificó en el índice. Opcionalmente, puedes especificar un embedding model diferente utilizando la opción model en la etapa del pipeline $vectorSearch, pero el embedding model especificado debe ser compatible con el embedding model utilizado en la indexación.

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 aprender más, consulta Ejecutar queries ANN y ENN de búsqueda vectorial.

Nota

Esta función está disponible para implementaciones de MongoDB Search y MongoDB Vector Search mediante Docker, tarball o un gestor de paquetes, así como para implementaciones que utilicen el operador MongoDB Controllers for Kubernetes con MongoDB 8 2 Community Edition. o posterior. La funcionalidad de incrustación automatizada aún no está disponible para MongoDB Enterprise Edition.

With a simple configuration change, you can enable semantic search, RAG, and memory for AI Agents, without writing embedding code, managing model infrastructure, or handling vector pipelines. That is, when deploying the MongoDB Community Edition with the MongoDB Search and Vector Search process, mongot, you can provide the Voyage AI API keys to use for generating embeddings, ideally one for indexing operations and another for query operations from different projects.

Después de la implementación:

  1. Desde tu colección, elige el campo de texto para el que deseas habilitar la búsqueda semántica.

  2. De la lista de modelos de incrustación disponibles, selecciona un modelo de incrustación.

  3. En tu definición de índice de MongoDB Vector Search, configura Embedding Automatizado usando el tipo autoEmbed.

Para obtener más información sobre cómo configurar el índice de búsqueda vectorial de MongoDB para la incrustación automatizada, consulta Cómo indexar campos para la búsqueda vectorial.

MongoDB búsqueda vectorial genera automáticamente embeddings para los documentos existentes y nuevos que insertes o actualices utilizando las claves API especificadas durante la inicialización de MongoDB Community Edition.

Para las query, utilice la opción query.text en la etapa de pipeline $vectorSearch. MongoDB búsqueda vectorial genera incrustaciones para la query de texto utilizando el mismo modelo de incrustación en la definición del índice. Puede especificar un modelo de incrustación diferente utilizando la opción model en la etapa de pipeline $vectorSearch, pero el modelo de incrustación especificado debe ser compatible con el modelo de incrustación utilizado en el momento del índice. MongoDB búsqueda vectorial utiliza la clave de API de query que proporcionó durante la inicialización de MongoDB Community para generar las incrustaciones en el momento de la query. Para aprender más, consulte Ejecutar búsqueda vectorial ANN y ENN de query.

Usted incurrirá en cargos por generar incrustaciones utilizando las claves de la API. Para obtener más información, consulte Gestionar la facturación.

Para automatizar la incrustación y ejecutar una query de muestra, consulte Tutorial de inicio rápido de búsqueda vectorial de MongoDB.

Aunque puede utilizar una sola clave API para generar embeddings tanto en el momento de indexación como en el de query, recomendamos utilizar claves API separadas para evitar que las operaciones de query impacten negativamente en las operaciones de indexación.

Puedes generar claves API de las siguientes formas:

Después de crear las claves, debe especificar las claves que desea utilizar para la incrustación automatizada al configurar mongot durante la implementación con MongoDB Community Edition. MongoDB Vector Search utiliza la llave API de Voyage AI que proporcionó durante la implementación de mongot para generar automáticamente incrustaciones para sus datos en el índice y para su texto de query en el momento de la query.

Los índices de incrustación automatizados generan vector embeddings de manera asíncrona y se almacenan en el clúster de MongoDB en una base de datos de reserva independiente. Cada índice de incrustación automatizada tiene exactamente una colección generada de incrustaciones correspondiente. La colección de incrustaciones generadas se almacena en una base de datos interna dedicada en el mismo clúster.

Para **aprender** más, consulta Colección de incrustaciones Generadas.

MongoDB Vector Search se integra con los modelos de incrustaciones de última generación de Voyage AI, cada uno optimizado para un caso de uso específico:

Modelo de incrustación
Descripción
Precio por 1M de tokens

voyage-4-lite

Optimizados para aplicaciones de alto volumen y sensibles al costo.

$0.02

voyage-4

(Recomendado) Rendimiento equilibrado para búsqueda de texto general.

$0.06

voyage-4-large

Máxima precisión para relaciones semánticas complejas.

$0.12

voyage-code-4

(Recomendadopara código) Especializado en búsqueda de código y documentación técnica.

$0.12

voyage-code-3

Legacy model specialized for code search and technical documentation. Use voyage-code-4 instead.

$0.18

Nota

voyage-code-4 requires an Atlas deployment. On self-managed deployments, use voyage-code-3 for code search and technical documentation.

Para obtener más información, consulte Modelos para incrustación automática.

modelo de incrustación

embedding models son algoritmos que convierten datos en vector embeddings que capturan el significado semántico o subyacente de sus datos. Estos vectores habilitan la búsqueda vectorial.

To learn more about the embedding models for Automated Embedding, see Available Models.

embeddings vectoriales

Una incrustación vectorial es un arreglo de números, siendo cada dimensión la representación de una funcionalidad o atributo diferente de sus datos. Los vectores se pueden utilizar para representar cualquier tipo de datos, desde texto, imágenes y videos hasta datos no estructurados. Crea representaciones vectoriales pasando tus datos por un modelo de representaciones, y puedes almacenar estas representaciones en una base de datos que soporte representaciones vectoriales como MongoDB.

Para **aprender** más sobre el **almacenamiento** de **incrustaciones** para la incrustación automatizada, consulta **Colección** de **incrustaciones** generadas.

tokens

En el contexto de los modelos de incrustación y los LLM, los tokens son las unidades fundamentales de texto, como palabras, subpalabras o caracteres, que el modelo procesa para crear incrustaciones o generar texto. Los tokens son la forma en que se le factura por el uso de modelos de incrustación y LLM.

Para obtener más información sobre tokens para incrustación automatizada, consulta Gestionar facturación para incrustación automatizada.

límites de velocidad

Los límites de tasa son restricciones impuestas por los proveedores de API respecto a la cantidad de solicitudes que un usuario puede realizar en un período de tiempo específico, a menudo medidos en tokens por minuto (TPM) o solicitudes por minuto (RPM). Estos límites garantizan un uso equitativo, previenen abusos y mantienen la estabilidad y el rendimiento del servicio para todos los usuarios.

Para aprender más información sobre los límites de tasa para la incrustación automatizada, consulta Límites de tasa

cuantización

Quantization reduce la precisión de los vector embeddings para disminuir el uso de memoria y almacenamiento, con compensaciones en la precisión de búsqueda. Para la incrustación automatizada, MongoDB búsqueda vectorial admite los siguientes tipos de quantization:

Tipo de quantization
Descripción

float

Almacena los vector embeddings como valores float de 32bits.

scalar

Reduce cada dimensions del vector de un float de 32bits a un número entero de 8bits.

binary

Reduce cada dimensions vectorial a un solo bit y vuelve a puntuar los mejores resultados.

binaryNoRescore

Reduce cada dimensions del vector a un solo bit sin necesidad de reasignar puntuaciones.

Para obtener más información sobre la quantization para la incrustación Automática, consulta Sobre la Quantization.

número de dimensiones

El número de dimensions especifica la longitud del vector de incrustaciones para cada document (cuántos números hay en el arreglo). Las Higher dimensions capturan más detalles semánticos y, por lo general, mejoran la precisión de la recuperación, pero aumentan los costos de almacenamiento y cálculo (tamaño del índice, uso de RAM y, a veces, latencia).

Para obtener más información, consulta numCandidates Selección.

similitud

La función de similitud se utiliza para medir la similitud entre dos vectores o la cercanía de un vector de consulta con los vectores en el índice. MongoDB búsqueda vectorial es compatible con las siguientes funciones de similaridad:

  • cosine - mide la similitud basándose en el ángulo entre vectores. Recomendamos esta función de similitud para vectores no normalizados como la cuantificación scalar.

  • dotProduct - mide la similitud como cosine, pero tiene en cuenta la magnitud del vector. Recomendamos esta función de similitud para vectores normalizados como la cuantificación de punto flotante (fidelidad completa).

  • euclidean - mide la distancia entre los extremos de los vectores. Recomendamos esta función de similitud para la quantization binary o binaryNoRescore, donde los vectores se comprimen y la distancia en el espacio Hamming o Euclidiano es la señal adecuada.

Para obtener más información sobre las funciones de similitud para la incrustación automatizada, consulte Acerca de las funciones de similitud.