Generar incrustaciones automáticamente mediante MongoDB Vector Search

This feature is in Private Preview. The feature and the corresponding documentation might change at any time during the Preview period. Therefore, do not use this feature in Production. To learn more, see Preview Features. To enable this feature for your M10 or higher cluster in your development or test environment, contact your account team. There are no charges for using this feature during the Preview period. However, standard charges for Atlas clusters still apply. To learn more, see the MongoDB Pricing page.

You can configure MongoDB Vector Search to automatically generate and manage vector embeddings for the text data in your cluster. You can create a one-click AI semantic search index in your M10 or higher Atlas cluster and use Voyage AI embedding models, simplifying indexing, updating, and querying with vectors.

When you enable Automated Embedding, MongoDB Vector Search automatically generates embeddings using the specified embedding model at index-time for the specified text field in your Atlas collection and at query-time for your text string in your query against the field indexed for automated embeddings.

Considerations

Importante

You can use MongoDB Vector Search Automated Embedding on any M10 or higher cluster on any cloud provider. However, the service that handles the inference process for generating vector embeddings runs on Google Cloud. This means that your data is sent to Google Cloud for embedding generation and retrieval, regardless of your cluster's cloud provider. We provide enterprise grade security and therefore, your data is only stored in your cluster.

Los modelos de incrustación se ejecutan en una plataforma de inferencia compartida y multiinquilino. Por lo tanto, durante el período de vista previa, debe usar conjuntos de datos con menos de 100k documentos y ejecutar consultas solo para evaluar la función, no para realizar pruebas de carga. Contacte con su equipo de cuentas si tiene un caso de uso con límites superiores.

Aunque no hay límites estrictos de velocidad para tu carga de trabajo, hay límites globales. Si tus queries devuelven un error de límite de velocidad (error 409), realiza un backoff y vuelve a intentarlo en el código de tu aplicación. Esto permite que tu aplicación gestione adecuadamente los límites de velocidad y garantice su funcionalidad continua.

Requisitos previos

To enable vector search using Automated Embedding, you must have the following:

M10 or higher cluster
Una colección con un campo de texto que desea indexar para incrustaciones automáticas.
Uno de los siguientes clientes:
- Interfaz de usuario de Atlas para crear índices
- mongosh for creating indexes and running queries
- Controlador 6.6.0 de nodo o superior para crear índices y ejecutar consultas
- Controlador 4.7 de Python o superior para crear índices y ejecutar consultas
Utilice el siguiente menú desplegable para configurar el cliente para los procedimientos de esta página.
Seleccionar el lenguaje

Índice de búsqueda vectorial de MongoDB para incrustación automatizada

Las siguientes secciones describen la sintaxis y los campos del índice de búsqueda vectorial de MongoDB para habilitar la generación automática de embeddings para campos de texto, y le guiarán a través de los pasos para configurar su índice para la incrustación automática.

Acceso requerido

Necesitas el Project Data Access Admin or higher role to create and manage MongoDB Vector Search indexes.

Sintaxis del índice

La siguiente es la sintaxis para habilitar la generación automática de incrustaciones:

1 {
2   "fields": [
3     {
4       "type": "text",
5       "path": "<field-name>",
6       "model": "voyage-3-large | voyage-3.5 | voyage-3.5-lite"
7     }
8   ]
9 }

Campos de índices

Se requieren los siguientes campos en la definición del índice:

Campo	Tipo	Descripción
`type`	string	El tipo del campo. Para el embedding automatizado, esto debe ser `text`.
`path`	string	The name of the field in the collection that you want to index for Automated Embedding.
`model`	string	El modelo de incrustación de Voyage AI que se usará para generar las incrustaciones del índice. Puede especificar uno de los siguientes modelos: `voyage-3-large` - Highest-quality retrieval across languages and domains. `voyage-3.5` - Balanced model for multilingual use and general-purpose retrieval accuracy. `voyage-3.5-lite` - Lightweight, faster model optimized for latency and lower cost. Tras crear el índice, si cambia el modelo de incrustación posteriormente, MongoDB Vector Search genera nuevas incrustaciones para el conjunto de datos. Mientras MongoDB Vector Search genera las incrustaciones, puede continuar consultando utilizando las incrustaciones antiguas. Cuando las incrustaciones antiguas se reemplazan con incrustaciones del nuevo modelo, MongoDB Vector Search las elimina.

Considerations

The index fields for Automated Embedding are mutually exclusive with the following vector type index fields:

numDimensions
similarity
quantization

Si su colección ya tiene incrustaciones, debe usar los vector campos de tipo para indexarlas. Para obtener más información sobre la indexación de campos con incrustaciones, consulte Cómo indexar campos para la búsqueda vectorial.

Puede crear un índice con los tipos text y vector si desea indexar un campo de texto para generar incrustaciones automáticamente y también indexar un campo con sus propias incrustaciones. MongoDB Vector Search generará automáticamente incrustaciones para consultas únicamente en el campo indexado como tipo text. Debe especificar incrustaciones en la consulta para buscar en el campo indexado como tipo vector.

También puede indexar campos para prefiltrar sus datos mediante el tipo de búsqueda filter vectorial de MongoDB. El prefiltrado reduce la cantidad de documentos con los que se realizan comparaciones de similitud, lo que puede disminuir la latencia de las consultas y aumentar la precisión de los resultados de búsqueda. Para obtener más información sobre el prefiltrado de sus datos, consulte Acerca del filter tipo.

Crear un índice para la incrustación automatizada

The following procedure walks through the steps for enabling automated embeddings in your MongoDB Vector Search index. If you loaded the sample_mflix.movies dataset, the example in the procedure demonstrates how to enable Automated Embedding for the fullplot field in the collection.

En Atlas, vaya a la Clusters Página para su proyecto.

Si aún no se muestra, seleccione la organización que contiene su proyecto deseado en el menú Organizations de la barra de navegación.
Si aún no aparece, selecciona el proyecto deseado en el menú Projects de la barra de navegación.
En la barra lateral, haz clic en Clusters en la sección Database.

La página de clústeres se muestra.

En Atlas, vaya a la Search & Vector Search página de su clúster.

Puedes ir a la página de búsqueda de MongoDB desde la opción Search & Vector Search o desde el Data Explorer.

Si aún no aparece, se debe seleccionar la organización que contiene el proyecto en el menú Organizations de la barra de navegación.
Si aún no se muestra, seleccione su proyecto en el menú Projects de la barra de navegación.
En la barra lateral, haz clic en Search & Vector Search en la sección Database.
Si no tienes clústeres, haz clic en Create cluster para crear uno. Para obtener más información, consulta Crear un clúster.
Si el proyecto tiene varios clústeres, se debe seleccionar el clúster que se desea usar en el menú desplegable Select cluster y luego se debe hacer clic en Go to Search.
Aparece la página de Búsqueda y Búsqueda Vectorial.

Si aún no aparece, se debe seleccionar la organización que contiene el proyecto en el menú Organizations de la barra de navegación.
Si aún no se muestra, seleccione su proyecto en el menú Projects de la barra de navegación.
En la barra lateral, haz clic en Data Explorer en la sección Database.
Expanda la base de datos y seleccione la colección.
Haga clic en la pestaña Indexes para la colección.
Haga clic en el enlace Search and Vector Search en el banner.
Aparece la página de Búsqueda y Búsqueda Vectorial.

Se debe iniciar la configuración del índice.

Realiza las siguientes selecciones en la página y luego haz clic en Next.

Search Type	Seleccione el tipo de índice Vector Search.
Index Name and Data Source	Especifique la siguiente información: Index Name: <INDEX-NAME> Database and Collection: <DATABASE-NAME> <COLLECTION-NAME>
Configuration Method	Seleccione JSON Editor.

Ejemplo

Por ejemplo, ingrese movies_automated_embeddings como nombre del índice y seleccione sample_mflix y movies del menú desplegable Database and Collection.

Define tu índice.

En el editor JSON, ingrese la siguiente definición de índice:

1 {
2   "fields": [
3     {
4       "type": "text",
5       "path": "<FIELD-NAME>",
6       "model": "voyage-3-large | voyage-3.5 | voyage-3.5-lite"
7     }
8   ]
9 }

Ejemplo

Por ejemplo, para crear un índice que habilite incrustaciones automatizadas usando el modelo voyage-3-large para el campo fullplot de la colección, ingrese lo siguiente:

1 {
2   "fields": [
3     {
4       "type": "text",
5       "path": "fullplot",
6       "model": "voyage-3-large"
7     }
8   ]
9 }

Crea tu índice.

Haga clic en Next.
Revise la configuración de su índice y haga clic en Create Vector Search Index.

Nota

La creación del índice puede tardar un tiempo. Durante la creación, la columna Status de la interfaz de usuario de Atlas muestra Pending. Al finalizar la creación, la columna Status de la interfaz de usuario de Atlas muestra Ready.

Conéctate al clúster Atlas usando `mongosh`.

Para obtener más información, consulte Conectarse a un clúster a través de mongosh.

Cambie a la base de datos que contiene la colección para la que desea crear el índice.

Para cambiar, ejecute el siguiente comando:

use <DATABASE-NAME>

Aquí, <DATABASE-NAME> es el nombre de la base de datos que desea utilizar.

Ejemplo

Por ejemplo, para cambiar a la base de datos sample_mflix, que contiene la colección movies, ejecuta el siguiente comando:

use sample_mflix

Ejecute el `db.collection.createSearchIndex()` método.

El método db.collection.createSearchIndex() tiene la siguiente sintaxis:

1 db.<COLLECTION-NAME>.createSearchIndex(
2   "<INDEX-NAME>",
3   "vectorSearch", 
4   {
5     "fields": [
6       {
7         "type": "text",
8         "path": "<FIELD-NAME>",
9         "model": "voyage-3-large | voyage-3.5 | voyage-3.5-lite"
10       },
11       {
12         "type": "filter",
13         "path": "<FIELD-NAME>"
14       },
15       ...
16     ]
17   }
18 );

Ejemplo

Por ejemplo, para crear un índice que permita incorporaciones automáticas mediante el uso del modelo voyage-3-large para el campo fullplot en la colección, ejecute el siguiente comando en su terminal:

1 db.movies.createSearchIndex(
2   "movies_automated_embeddings",
3   "vectorSearch",
4   {
5     "fields": [
6       {
7         "type": "text",
8         "path": "fullplot",
9         "model": "voyage-3-large"
10       }
11     ]
12   }
13 );

Inicia el proyecto de Node.js.

Ejecute los siguientes comandos en su terminal para crear un nuevo directorio llamado auto-embeddings-project e inicializar su proyecto:

mkdir auto-embeddings-project
cd auto-embeddings-project
npm init -y

Crea el `.js` archivo.

touch <file-name>.js

Ejemplo

Por ejemplo, cree un archivo llamado create_index.js.

touch create_index.js

Define the index in the `.js` file.

1 const { MongoClient } = require("mongodb");
2 
3 // connect to your Atlas deployment
4 const uri =  "<CONNECTION-STRING>";
5 const client = new MongoClient(uri);
6 
7 async function run() {
8     try {
9       const database = client.db("<DATABASE-NAME>");
10       const collection = database.collection("<COLLECTION-NAME>");
11 
12       // define your MongoDB Vector Search index
13       const index = {
14         "name": "<INDEX-NAME>",
15         "type": "vectorSearch",
16         "definition": {
17           "fields": [
18             {
19               "type": "vector",
20               "path": "<FIELD-NAME>",
21               "model": "voyage-3-large | voyage-3.5 | voyage-3.5-lite"
22             },
23           ]
24         }
25       }
26       // run the helper method
27       await collection.createSearchIndex("<INDEX-NAME>", index);
28     } finally {
29       await client.close();
30     }
31 }
32 run().catch(console.dir);

Ejemplo

Por ejemplo, para crear un índice que permita incorporaciones automáticas mediante el uso del modelo voyage-3-large para el campo fullplot en el espacio de nombres sample_mflix.movies, copie y pegue lo siguiente en el archivo create_index.js:

1 const { MongoClient } = require("mongodb");
2 
3 // connect to your Atlas deployment
4 const uri =  "<CONNECTION-STRING>";
5 const client = new MongoClient(uri);
6 
7 async function run() {
8   try {
9     const database = client.db("sample_mflix");
10     const collection = database.collection("movies");
11 
12     // define your MongoDB Vector Search index
13     const index = {
14       "name": "movies_automated_embeddings",
15       "type": "vectorSearch",
16       "definition": {
17       "fields": [
18         {
19           "type": "text",
20           "path": "fullplot",
21           "model": "voyage-3-large"
22         }
23       ]
24     }
25   }
26   // run the helper method
27   await collection.createSearchIndex(index);
28   } finally {
29     await client.close();
30   }
31 }
32 run().catch(console.dir);

Sustituye los siguientes valores y guarda el archivo.

`<CONNECTION-STRING>`	La cadena de conexión para su clúster Atlas.
`<DATABASE-NAME>`	El nombre de la base de datos que contiene la colección para la que desea crear el índice.
`<COLLECTION-NAME>`	El nombre de la colección para la que desea crear el índice.
`<FIELD-NAME>`	The name of the field in the collection that you want to index for Automated Embedding.
`<INDEX-NAME>`	El nombre del índice que desea crear.

Ejecuta el siguiente comando para crear el índice.

node <file-name>.js

Ejemplo

Por ejemplo, para crear el índice definido en el archivo create_index.js, ejecute el siguiente comando en su terminal:

node create_index.js

Crea un `.py` archivo.

touch <file-name>.py

Ejemplo

Por ejemplo, cree un archivo llamado create_index.py.

touch create_index.py

Define the index in the `.py` file.

1 from pymongo import MongoClient
2 from pymongo.operations import SearchIndexModel
3 
4 client = pymongo.MongoClient("<CONNECTION-STRING>")
5 db = client["<DATABASE-NAME>"]
6 collection = db["<COLLECTION-NAME>"]
7 
8 search_index_model = SearchIndexModel(
9   definition={
10     "fields": [
11       {
12         "type": "text",
13         "path": "<FIELD-NAME>",
14         "model": "voyage-3-large | voyage-3.5 | voyage-3.5-lite" 
15       }
16     ]
17   },
18   name="<INDEX-NAME>",
19   type="vectorSearch",
20 )
21 result = collection.create_search_index(model=search_index_model)
22 print(result)

Ejemplo

1 from pymongo import MongoClient
2 from pymongo.operations import SearchIndexModel
3 
4 client = MongoClient("<CONNECTION-STRING>")
5 db = client["sample_mflix"]
6 collection = db["movies"]
7 
8 search_index_model = SearchIndexModel(
9   definition={
10     "fields": [
11       {
12         "type": "text",
13         "path": "fullplot",
14         "model": "voyage-3-large"
15       }
16     ]
17   },
18     name="movies_automated_embeddings",
19     type="vectorSearch",
20 )
21 result = collection.create_search_index(model=search_index_model)
22 print(result)

Sustituye los siguientes valores y guarda el archivo.

`<CONNECTION-STRING>`	La cadena de conexión para su clúster Atlas.
`<database-name>`	El nombre de la base de datos que contiene la colección para la que desea crear el índice.
`<collection-name>`	El nombre de la colección para la que desea crear el índice.
`<field-name>`	The name of the field in the collection that you want to index for Automated Embedding.
`<index-name>`	El nombre del índice que desea crear.

Ejecuta el siguiente comando para crear el índice.

python <file-name>.py

Ejemplo

Por ejemplo, para crear el índice definido en el archivo create_index.py, ejecute el siguiente comando en su terminal:

python create_index.py

Consulta de búsqueda vectorial de MongoDB con incrustación automatizada

After you create an index with Automated Embedding, you can run text queries against the indexed field. MongoDB Vector Search automatically generates embeddings for the text string in your query using the same embedding model specified in the index. It uses the embeddings to search the index for documents that are semantically similar to the specified query text.

The following sections describe the $vectorSearch pipeline syntax and fields for automatically generating embeddings for your query text against the field indexed for Automated Embedding and demonstrate how to run semantic search queries against the fields indexed for Automated Embedding.

Sintaxis de consulta

The following syntax demonstrates how to run a query against a field indexed for Automated Embedding:

1 {
2   "$vectorSearch": {
3     "index": "<index-name>",
4     "limit": <number-of-results>,
5     "numCandidates": <number-of-candidates>,
6     "path": "<field-to-search>",
7     "query": "<query-string>"
8   }
9 }

Campos de consulta

Los siguientes campos son necesarios para una consulta de búsqueda vectorial de MongoDB que utilice incrustaciones automatizadas:

Campo	Tipo	Necesidad	Descripción
`exact`	booleano	Condicional	Este campo es obligatorio si se omite `numCandidates`. Se excluye mutuamente con `numCandidates`. Flag that specifies whether to run ENN or ANN search. Value can be one of the following: `false` - para ejecutar la búsqueda de ANN `true` - para ejecutar la búsqueda de ENN Si se omite, es por defecto `false`.
`index`	string	Requerido	Nombre del índice de búsqueda vectorial de MongoDB que se utilizará. La búsqueda vectorial de MongoDB no devuelve resultados si escribe mal el nombre del índice o si el índice especificado no existe ya en el clúster.
`limit`	Número	Requerido	Número de documentos (solo de tipo `int`) que se devolverán en los resultados. Este valor no puede superar el valor de `numCandidates` si especifica `numCandidates`.
`numCandidates`	Número	Condicional	Este campo es obligatorio si `exact` es `false` o se omite. Mutuamente excluyente con `exact`. Número de vecinos más cercanos a utilizar durante la búsqueda. El valor debe ser menor o igual a (`<=`) `10000`. No puede especificar un número inferior al número de documentos a devolver (`limit`).
`path`	string	Requerido	Campo de tipo vector indexado para la búsqueda.
`query`	string	Requerido	Texto para el cual se generarán automáticamente incrustaciones y se realizará la búsqueda semántica.

Considerations

You can run an ANN or ENN query against the indexed field. To learn more, see ANN Search and ENN Search.

You can't specify vector embeddings in your query against fields indexed for Automated Embedding. Instead, you must run a natural language query against the field. When you run a natural language query against the field indexed for Automated Embedding, MongoDB Vector Search automatically generates the embeddings for the query text using the same embedding model as the indexed field. It then uses the generated embeddings to perform a semantic search against the indexed field.

Opcionalmente, puede especificar filter campos en su consulta para prefiltrar los documentos en los que MongoDB Vector Search realiza la búsqueda semántica. Para obtener más información, consulte Prefiltrado de MongoDB Vector Search.

También puede recuperar opcionalmente la puntuación de los documentos en los resultados. Para obtener más información, consulte Puntuación de búsqueda vectorial de MongoDB.

Ejecutar una consulta mediante incrustación automatizada

No se pueden ejecutar consultas de búsqueda vectorial de MongoDB en la interfaz de usuario de Atlas. Use o un controlador compatible para ejecutar mongosh consultas.

Conéctate al clúster Atlas usando `mongosh`.

Para obtener más información, consulte Conectarse a un clúster a través de mongosh.

Cambie a la base de datos que contiene la colección para la que desea ejecutar la consulta.

use <database-name>

Ejemplo

Por ejemplo, para cambiar a la base de datos sample_mflix, ejecute el siguiente comando en su terminal:

use sample_mflix

Run the `db.collection.aggregate()` method with the `$vectorSearch` stage.

El método db.collection.aggregate() tiene la siguiente sintaxis:

1 db.<COLLECTION-NAME>.aggregate([
2   {
3     "$vectorSearch": {
4       "index": "<INDEX-NAME>", 
5       "path": "<FIELD-NAME>", 
6       "query": "<QUERY-TEXT>", 
7       "numCandidates": <NUMBER-OF-CANDIDATES-TO-CONSIDER>, 
8       "limit": <NUMBER-OF-DOCUMENTS-TO-RETURN>
9     }
10   }
11 ])

Ejemplo

Por ejemplo, para ejecutar una consulta en el campo fullplot en la colección movies para una búsqueda semántica de películas semánticamente similares a young heroes caught in epic struggles between light and darkness, copie, pegue y ejecute la siguiente consulta.

1 db.movies.aggregate([
2   {
3     "$vectorSearch": {
4       "index": "movies_automated_embeddings", 
5       "path": "fullplot", 
6       "query": "young heroes caught in epic struggles between light and darkness", 
7       "numCandidates": 1000, 
8       "limit": 10
9     }
10   },
11   {
12     "$project": {
13       "_id": 0, 
14       "title": 1, 
15       "fullplot": 1, 
16       "score": {"$meta": "vectorSearchScore"}
17     }
18   }
19 ])

1 [
2    {
3        title: 'Day Watch',
4        fullplot: 'Anton belongs to the Forces of the Light as well as his powerful girlfriend and apprentice, but his son is a powerful teenager from the Darkness and Anton protects him. When the balance between Light and Darkness is affected by the death of some evil vampires, Anton is framed and accused of the murders, and he chases an ancient chalk that has the power of changing the destiny of its owner.',
5        score: 0.5449697971343994
6    },
7    {
8        title: 'Dungeons & Dragons',
9        fullplot: "The Empire of Izmer has long been a divided land. The Mages - an elite group of magic-users - rule whilst the lowly commoners are powerless. Izmer's young Empress, Savina, wants equality and prosperity for all, but the evil Mage Profion is plotting to depose her and establish his own rule. The Empress possesses a scepter which controls Izmer's Golden Dragons. To challenge her rule, Profion must have the scepter, and tricks the Council of Mages into believing Savina is unfit to hold it. Knowing that Profion will bring death and destruction to Izmer, Savina must find the legendary Rod of Savrille, a mythical rod that has the power to control Red Dragons, a species even mightier than the Gold. Enter two thieves, Ridley and Snails, who unwittingly become instrumental in Savina's search for the Rod. Joined by a feisty Dwarf named Elwood, and helped by the Empress's expert tracker, the Elf Norda, the young heroes go in search of the Rod of Savrille. From the deadly maze of the Thieves Guild at Antius to an Elven Village, secret grotto and abandoned castles, Ridley and his band must outwit Profion's chief henchman Damodar at every turn while, back in Izmer, Profion prepares to do battle with the Empress. All depends on the Rod, but the outcome of the race to reach it first is far from certain, and Izmar's very survival hangs in the balance.",
10        score: 0.5414832830429077
11    },
12    {
13        title: 'Brave Story',
14        fullplot: 'A young boy attempts to change his destiny by entering a magic gateway to another world; but on his quest to find the Tower of Fortune and be granted any wish, he must conjure up all his bravery to battle demons, his friends, and ultimately himself.',
15        score: 0.5404887795448303
16    },
17    {
18        title: 'Justin and the Knights of Valour',
19        fullplot: 'Justin lives in a kingdom where bureaucrats rule and knights have been ousted. His dream is to be become one of the Knights of Valour, like his grandfather was, but his father Reginald, the chief counsel to the Queen, wants his son to follow in his footsteps and become a lawyer. After an inspiring visit to his beloved Grandmother and bidding farewell to his supposed lady-love Lara, Justin leaves home and embarks on a quest to become a knight. Along the way he meets the beautiful, feisty Talia, a quirky wizard called Melquiades, and the handsome Sir Clorex and is mentored by three monks; Blucher, Legantir and Braulio, who teach and test him in the ancient ways of the Knights of Valour. Whilst an unlikely candidate for knighthood, Justin must rise to the challenge quickly when banished former knight Sir Heraclio and his army, lead by Sota, return and threaten to destroy the Kingdom.',
20        score: 0.5374966859817505
21    },
22    {
23        title: 'Forest Warrior',
24        fullplot: 'John McKenna is a spiritual being who is able to transform into bear, wolf or eagle. He lives in the forests of Tanglewood and has dedicated his life to protect them. One day a gang of evil lumberjacks led by Travis Thorne arrive Tanglewood to chop the forest down. McKenna cannot let this happen, and together with his new friends - Lords of the Tanglewood, a band of children who love to play in the forest - he battles against Thorne and his evil gang.',
25        score: 0.5331881642341614
26    },
27    {
28        title: 'Forest Warrior',
29        fullplot: 'John McKenna is a spiritual being who is able to transform into bear, wolf or eagle. He lives in the forests of Tanglewood and has dedicated his life to protect them. One day a gang of evil lumberjacks led by Travis Thorne arrive Tanglewood to chop the forest down. McKenna cannot let this happen, and together with his new friends - Lords of the Tanglewood, a band of children who love to play in the forest - he battles against Thorne and his evil gang.',
30        score: 0.5331881642341614
31    },
32    {
33        title: 'Catatan (Harian) si Boy',
34        fullplot: "A circle of friends risking their Friendship, Trust, Love and Hope in search of a legend. A young and privileged teenager with a golden heart, beset with challenges and tribulations we face today with the goal to open many young people's mind with inspirations and hopes that drive them in achieving their dreams. To get out of their comfort zone and finish what they started.",
35        score: 0.5322973728179932
36    },
37    {
38        title: 'Bionicle: Mask of Light',
39        fullplot: "In a land of living machines, two young ones are chosen to seek the legendary Mask of Light to reveal the savior of all the lands from the dark forces of the Makuta. During the course of their adventure, they will call on the heroes of their people, the great Toa. These Toa, masters of nature's forces such as Fire, Wind, Earth & Water, try to protect the chosen ones as they seek their destiny.",
40        score: 0.5315042734146118
41    },
42    {
43        title: 'Fear No Evil',
44        fullplot: 'High school student turns out to be personification of Lucifer. Two arch angels in human form (as women) take him on.',
45        score: 0.5295513868331909
46    },
47    {
48        title: 'Tales of Vesperia: The First Strike',
49        fullplot: 'In a mythical kingdom, the mighty Imperial Knights harness a magical substance known as Aer to power their weapons and protect humanity from the monsters of the forest. But something strange is afoot. The Aer is somehow changing, causing the wilderness to waste away and stirring the woodland beasts to attack with greater frequency. As danger creeps steadily closer to civilization, two young recruits - Flynn, the rigid son of a fallen hero, and the rebellious and brash Yuri - must ride with their fellow Imperial Knights to distant ruins in hopes of uncovering the truth behind the transforming Aer. Some will not survive the thrilling journey. Some will be betrayed. If Flynn and Yuri cannot overcome their differences and learn to fight together, all will be lost for the people of the realm.',
50        score: 0.5276793241500854
51    }
52 ]

Crea un `.js` archivo.

Ejemplo

Por ejemplo, cree un archivo llamado automated-embeddings-query.js.

touch automated-embeddings-query.js

Define la consulta en el archivo.

1 const { MongoClient } = require("mongodb");
2 
3 // connect to your Atlas cluster
4 const uri = "<CONNECTION-STRING>";
5 
6 const client = new MongoClient(uri);
7 
8 async function run() {
9     try {
10         await client.connect();
11 
12         // set namespace
13         const database = client.db("<DATABASE-NAME>");
14         const coll = database.collection("<COLLECTION-NAME>");
15 
16         // define pipeline
17         const agg = [
18             {
19               '$vectorSearch': {
20                 'index': '<INDEX-NAME>',
21                 'path': '<FIELD-NAME>',
22                 'query': "<QUERY-TEXT>",
23                 'numCandidates': <NUMBER-OF-CANDIDATES-TO-CONSIDER>,
24                 'limit': <NUMBER-OF-DOCUMENTS-TO-RETURN>
25               }
26             }
27           ];
28         // run pipeline
29         const result = coll.aggregate(agg);
30 
31         // print results
32         await result.forEach((doc) => console.dir(JSON.stringify(doc)));
33     } finally {
34         await client.close();
35     }
36 }
37 run().catch(console.dir);

Ejemplo

Por ejemplo, en el archivo automated-embeddings-query.js, copie y pegue el siguiente código para definir una consulta en el campo fullplot de la colección movies para una búsqueda semántica de películas semánticamente similares a young heroes caught in epic struggles between light and darkness.

1 const { MongoClient } = require("mongodb");
2 
3 // connect to your Atlas cluster
4 const uri = "<CONNECTION-STRING>";
5 
6 const client = new MongoClient(uri);
7 
8 async function run() {
9     try {
10         await client.connect();
11 
12         // set namespace
13         const database = client.db("sample_mflix");
14         const coll = database.collection("movies");
15 
16         // define pipeline
17         const agg = [
18             {
19               '$vectorSearch': {
20                 'index': 'movies_automated_embeddings',
21                 'path': 'fullplot',
22                 'query': "young heroes caught in epic struggles between light and darkness",
23                 'numCandidates': 100,
24                 'limit': 10
25               }
26             }, {
27               '$project': {
28                 '_id': 0,
29                 'fullplot': 1,
30                 'title': 1,
31                 'score': {
32                   '$meta': 'vectorSearchScore'
33                 }
34               }
35             }
36           ];
37         // run pipeline
38         const result = coll.aggregate(agg);
39 
40         // print results
41         await result.forEach((doc) => console.dir(JSON.stringify(doc)));
42     } finally {
43         await client.close();
44     }
45 }
46 run().catch(console.dir);

Reemplace lo siguiente en la consulta.

`<CONNECTION-STRING>`	Cadena de conexión del clúster.
`<DATABASE-NAME>`	Nombre de la base de datos que contiene la colección.
`<COLLECTION-NAME>`	Nombre de la colección que contiene el campo indexado.
`<INDEX-NAME>`	Nombre del índice.
`<FIELD-NAME>`	Nombre del campo indexado.
`<QUERY-TEXT>`	Cadena de texto para la cual se generarán incrustaciones y se usará en la búsqueda semántica.
`<NUMBER-OF-CANDIDATES-TO-CONSIDER>`	Número de vecinos más cercanos a considerar.
`<NUMBER-OF-DOCUMENTS-TO-RETURN>`	Número de documentos a devolver en los resultados.

Ejecuta la query.

node <FILE-NAME>.js

Aquí <FILE-NAME> es el nombre del archivo .js que usted creó.

Ejemplo

Por ejemplo, para ejecutar la consulta de ejemplo en el archivo automated-embeddings-query.js, ejecute el siguiente comando:

node automated-embeddings-query.js

'{"title":"Day Watch","fullplot":"Anton belongs to the Forces of the Light as well as his powerful girlfriend and apprentice, but his son is a powerful teenager from the Darkness and Anton protects him. When the balance between Light and Darkness is affected by the death of some evil vampires, Anton is framed and accused of the murders, and he chases an ancient chalk that has the power of changing the destiny of its owner.","score":0.5449697971343994}'
`{"title":"Dungeons & Dragons","fullplot":"The Empire of Izmer has long been a divided land. The Mages - an elite group of magic-users - rule whilst the lowly commoners are powerless. Izmer's young Empress, Savina, wants equality and prosperity for all, but the evil Mage Profion is plotting to depose her and establish his own rule. The Empress possesses a scepter which controls Izmer's Golden Dragons. To challenge her rule, Profion must have the scepter, and tricks the Council of Mages into believing Savina is unfit to hold it. Knowing that Profion will bring death and destruction to Izmer, Savina must find the legendary Rod of Savrille, a mythical rod that has the power to control Red Dragons, a species even mightier than the Gold. Enter two thieves, Ridley and Snails, who unwittingly become instrumental in Savina's search for the Rod. Joined by a feisty Dwarf named Elwood, and helped by the Empress's expert tracker, the Elf Norda, the young heroes go in search of the Rod of Savrille. From the deadly maze of the Thieves Guild at Antius to an Elven Village, secret grotto and abandoned castles, Ridley and his band must outwit Profion's chief henchman Damodar at every turn while, back in Izmer, Profion prepares to do battle with the Empress. All depends on the Rod, but the outcome of the race to reach it first is far from certain, and Izmar's very survival hangs in the balance.","score":0.5414832830429077}`
'{"title":"Brave Story","fullplot":"A young boy attempts to change his destiny by entering a magic gateway to another world; but on his quest to find the Tower of Fortune and be granted any wish, he must conjure up all his bravery to battle demons, his friends, and ultimately himself.","score":0.5404887795448303}'
'{"title":"Justin and the Knights of Valour","fullplot":"Justin lives in a kingdom where bureaucrats rule and knights have been ousted. His dream is to be become one of the Knights of Valour, like his grandfather was, but his father Reginald, the chief counsel to the Queen, wants his son to follow in his footsteps and become a lawyer. After an inspiring visit to his beloved Grandmother and bidding farewell to his supposed lady-love Lara, Justin leaves home and embarks on a quest to become a knight. Along the way he meets the beautiful, feisty Talia, a quirky wizard called Melquiades, and the handsome Sir Clorex and is mentored by three monks; Blucher, Legantir and Braulio, who teach and test him in the ancient ways of the Knights of Valour. Whilst an unlikely candidate for knighthood, Justin must rise to the challenge quickly when banished former knight Sir Heraclio and his army, lead by Sota, return and threaten to destroy the Kingdom.","score":0.5374966859817505}'
'{"title":"Forest Warrior","fullplot":"John McKenna is a spiritual being who is able to transform into bear, wolf or eagle. He lives in the forests of Tanglewood and has dedicated his life to protect them. One day a gang of evil lumberjacks led by Travis Thorne arrive Tanglewood to chop the forest down. McKenna cannot let this happen, and together with his new friends - Lords of the Tanglewood, a band of children who love to play in the forest - he battles against Thorne and his evil gang.","score":0.5331881642341614}'
'{"title":"Forest Warrior","fullplot":"John McKenna is a spiritual being who is able to transform into bear, wolf or eagle. He lives in the forests of Tanglewood and has dedicated his life to protect them. One day a gang of evil lumberjacks led by Travis Thorne arrive Tanglewood to chop the forest down. McKenna cannot let this happen, and together with his new friends - Lords of the Tanglewood, a band of children who love to play in the forest - he battles against Thorne and his evil gang.","score":0.5331881642341614}'
`{"title":"Catatan (Harian) si Boy","fullplot":"A circle of friends risking their Friendship, Trust, Love and Hope in search of a legend. A young and privileged teenager with a golden heart, beset with challenges and tribulations we face today with the goal to open many young people's mind with inspirations and hopes that drive them in achieving their dreams. To get out of their comfort zone and finish what they started.","score":0.5322973728179932}`
`{"title":"Bionicle: Mask of Light","fullplot":"In a land of living machines, two young ones are chosen to seek the legendary Mask of Light to reveal the savior of all the lands from the dark forces of the Makuta. During the course of their adventure, they will call on the heroes of their people, the great Toa. These Toa, masters of nature's forces such as Fire, Wind, Earth & Water, try to protect the chosen ones as they seek their destiny.","score":0.5315042734146118}`
'{"title":"Fear No Evil","fullplot":"High school student turns out to be personification of Lucifer. Two arch angels in human form (as women) take him on.","score":0.5295513868331909}'
'{"title":"Tales of Vesperia: The First Strike","fullplot":"In a mythical kingdom, the mighty Imperial Knights harness a magical substance known as Aer to power their weapons and protect humanity from the monsters of the forest. But something strange is afoot. The Aer is somehow changing, causing the wilderness to waste away and stirring the woodland beasts to attack with greater frequency. As danger creeps steadily closer to civilization, two young recruits - Flynn, the rigid son of a fallen hero, and the rebellious and brash Yuri - must ride with their fellow Imperial Knights to distant ruins in hopes of uncovering the truth behind the transforming Aer. Some will not survive the thrilling journey. Some will be betrayed. If Flynn and Yuri cannot overcome their differences and learn to fight together, all will be lost for the people of the realm.","score":0.5276793241500854}'

Crea un `.py` archivo.

Ejemplo

Por ejemplo, cree un archivo llamado automated-embeddings-query.js.

touch automated-embeddings-query.py

Define la consulta en el archivo.

1 import pymongo
2 
3 # connect to your Atlas cluster
4 client = pymongo.MongoClient("<CONNECTION-STRING>")
5 
6 # define pipeline
7 pipeline = [
8   {
9     '$vectorSearch': {
10       'index': '<INDEX-NAME>', 
11       'path': '<FIELD-NAME>', 
12       'query': '<QUERY-TEXT>', 
13       'numCandidates': <NUMBER-OF-CANDIDATES-TO-CONSIDER>,
14       'limit': <NUMBER-OF-DOCUMENTS-TO-RETURN>
15     }
16   }
17 ]
18 
19 # run pipeline
20 result = client["<DATABASE-NAME>"]["<COLLECTION-NAME>"].aggregate(pipeline)
21 
22 # print results
23 for i in result:
24     print(i)
25

Ejemplo

Por ejemplo, en el archivo automated-embeddings-query.py, copie y pegue el siguiente código para definir una consulta en el campo fullplot de la colección movies para una búsqueda semántica de películas semánticamente similares a young heroes caught in epic struggles between light and darkness.

1 import pymongo
2 
3 # connect to your Atlas cluster
4 client = pymongo.MongoClient("<CONNECTION-STRING>")
5 
6 # define pipeline
7 pipeline = [
8   {
9     '$vectorSearch': {
10       'index': 'movies_automated_embeddings',
11       'path': 'fullplot',
12       'query': "young heroes caught in epic struggles between light and darkness",
13       'numCandidates': 100,
14       'limit': 10
15     },
16   },
17   {
18     '$project': {
19       '_id': 0,
20       'title': 1,
21       'fullplot': 1,
22       'score': {'$meta': 'vectorSearchScore'}
23     }
24   }
25 ]
26 
27 # run pipeline
28 result = client["sample_mflix"]["movies"].aggregate(pipeline)
29 
30 # print results
31 for i in result:
32     print(i)
33

Reemplace lo siguiente en la consulta.

`<CONNECTION-STRING>`	Cadena de conexión del clúster.
`<DATABASE-NAME>`	Nombre de la base de datos que contiene la colección.
`<COLLECTION-NAME>`	Nombre de la colección que contiene el campo indexado.
`<INDEX-NAME>`	Nombre del índice.
`<FIELD-NAME>`	Nombre del campo indexado.
`<QUERY-TEXT>`	Cadena de texto para la cual se generarán incrustaciones y se usará en la búsqueda semántica.
`<NUMBER-OF-CANDIDATES-TO-CONSIDER>`	Número de vecinos más cercanos a considerar.
`<NUMBER-OF-DOCUMENTS-TO-RETURN>`	Número de documentos a devolver en los resultados.

Ejecuta la query.

python <FILE-NAME>.py

Aquí <FILE-NAME> es el nombre del archivo .py que usted creó.

Ejemplo

Por ejemplo, para ejecutar la consulta de ejemplo en el archivo automated-embeddings-query.py, ejecute el siguiente comando:

python automated-embeddings-query.js

{'title': 'Day Watch', 'fullplot': 'Anton belongs to the Forces of the Light as well as his powerful girlfriend and apprentice, but his son is a powerful teenager from the Darkness and Anton protects him. When the balance between Light and Darkness is affected by the death of some evil vampires, Anton is framed and accused of the murders, and he chases an ancient chalk that has the power of changing the destiny of its owner.', 'score': 0.5449697971343994}
{'title': 'Dungeons & Dragons', 'fullplot': "The Empire of Izmer has long been a divided land. The Mages - an elite group of magic-users - rule whilst the lowly commoners are powerless. Izmer's young Empress, Savina, wants equality and prosperity for all, but the evil Mage Profion is plotting to depose her and establish his own rule. The Empress possesses a scepter which controls Izmer's Golden Dragons. To challenge her rule, Profion must have the scepter, and tricks the Council of Mages into believing Savina is unfit to hold it. Knowing that Profion will bring death and destruction to Izmer, Savina must find the legendary Rod of Savrille, a mythical rod that has the power to control Red Dragons, a species even mightier than the Gold. Enter two thieves, Ridley and Snails, who unwittingly become instrumental in Savina's search for the Rod. Joined by a feisty Dwarf named Elwood, and helped by the Empress's expert tracker, the Elf Norda, the young heroes go in search of the Rod of Savrille. From the deadly maze of the Thieves Guild at Antius to an Elven Village, secret grotto and abandoned castles, Ridley and his band must outwit Profion's chief henchman Damodar at every turn while, back in Izmer, Profion prepares to do battle with the Empress. All depends on the Rod, but the outcome of the race to reach it first is far from certain, and Izmar's very survival hangs in the balance.", 'score': 0.5414832830429077}
{'title': 'Brave Story', 'fullplot': 'A young boy attempts to change his destiny by entering a magic gateway to another world; but on his quest to find the Tower of Fortune and be granted any wish, he must conjure up all his bravery to battle demons, his friends, and ultimately himself.', 'score': 0.5404887795448303}
{'title': 'Justin and the Knights of Valour', 'fullplot': 'Justin lives in a kingdom where bureaucrats rule and knights have been ousted. His dream is to be become one of the Knights of Valour, like his grandfather was, but his father Reginald, the chief counsel to the Queen, wants his son to follow in his footsteps and become a lawyer. After an inspiring visit to his beloved Grandmother and bidding farewell to his supposed lady-love Lara, Justin leaves home and embarks on a quest to become a knight. Along the way he meets the beautiful, feisty Talia, a quirky wizard called Melquiades, and the handsome Sir Clorex and is mentored by three monks; Blucher, Legantir and Braulio, who teach and test him in the ancient ways of the Knights of Valour. Whilst an unlikely candidate for knighthood, Justin must rise to the challenge quickly when banished former knight Sir Heraclio and his army, lead by Sota, return and threaten to destroy the Kingdom.', 'score': 0.5374966859817505}
{'title': 'Forest Warrior', 'fullplot': 'John McKenna is a spiritual being who is able to transform into bear, wolf or eagle. He lives in the forests of Tanglewood and has dedicated his life to protect them. One day a gang of evil lumberjacks led by Travis Thorne arrive Tanglewood to chop the forest down. McKenna cannot let this happen, and together with his new friends - Lords of the Tanglewood, a band of children who love to play in the forest - he battles against Thorne and his evil gang.', 'score': 0.5331881642341614}
{'title': 'Forest Warrior', 'fullplot': 'John McKenna is a spiritual being who is able to transform into bear, wolf or eagle. He lives in the forests of Tanglewood and has dedicated his life to protect them. One day a gang of evil lumberjacks led by Travis Thorne arrive Tanglewood to chop the forest down. McKenna cannot let this happen, and together with his new friends - Lords of the Tanglewood, a band of children who love to play in the forest - he battles against Thorne and his evil gang.', 'score': 0.5331881642341614}
{'title': 'Catatan (Harian) si Boy', 'fullplot': "A circle of friends risking their Friendship, Trust, Love and Hope in search of a legend. A young and privileged teenager with a golden heart, beset with challenges and tribulations we face today with the goal to open many young people's mind with inspirations and hopes that drive them in achieving their dreams. To get out of their comfort zone and finish what they started.", 'score': 0.5322973728179932}
{'title': 'Bionicle: Mask of Light', 'fullplot': "In a land of living machines, two young ones are chosen to seek the legendary Mask of Light to reveal the savior of all the lands from the dark forces of the Makuta. During the course of their adventure, they will call on the heroes of their people, the great Toa. These Toa, masters of nature's forces such as Fire, Wind, Earth & Water, try to protect the chosen ones as they seek their destiny.", 'score': 0.5315042734146118}
{'title': 'Fear No Evil', 'fullplot': 'High school student turns out to be personification of Lucifer. Two arch angels in human form (as women) take him on.', 'score': 0.5295513868331909}
{'title': 'Tales of Vesperia: The First Strike', 'fullplot': 'In a mythical kingdom, the mighty Imperial Knights harness a magical substance known as Aer to power their weapons and protect humanity from the monsters of the forest. But something strange is afoot. The Aer is somehow changing, causing the wilderness to waste away and stirring the woodland beasts to attack with greater frequency. As danger creeps steadily closer to civilization, two young recruits - Flynn, the rigid son of a fallen hero, and the rebellious and brash Yuri - must ride with their fellow Imperial Knights to distant ruins in hopes of uncovering the truth behind the transforming Aer. Some will not survive the thrilling journey. Some will be betrayed. If Flynn and Yuri cannot overcome their differences and learn to fight together, all will be lost for the people of the realm.', 'score': 0.5276793241500854}

1	{
2	"fields": [
3	{
4	"type": "text",
5	"path": "<field-name>",
6	"model": "voyage-3-large \| voyage-3.5 \| voyage-3.5-lite"
7	}
8	]
9	}

1	{
2	"fields": [
3	{
4	"type": "text",
5	"path": "fullplot",
6	"model": "voyage-3-large"
7	}
8	]
9	}

1	db.<COLLECTION-NAME>.createSearchIndex(
2	"<INDEX-NAME>",
3	"vectorSearch",
4	{
5	"fields": [
6	{
7	"type": "text",
8	"path": "<FIELD-NAME>",
9	"model": "voyage-3-large \| voyage-3.5 \| voyage-3.5-lite"
10	},
11	{
12	"type": "filter",
13	"path": "<FIELD-NAME>"
14	},
15	...
16	]
17	}
18	);

1	db.movies.createSearchIndex(
2	"movies_automated_embeddings",
3	"vectorSearch",
4	{
5	"fields": [
6	{
7	"type": "text",
8	"path": "fullplot",
9	"model": "voyage-3-large"
10	}
11	]
12	}
13	);

1	const { MongoClient } = require("mongodb");
2
3	// connect to your Atlas deployment
4	const uri = "<CONNECTION-STRING>";
5	const client = new MongoClient(uri);
6
7	async function run() {
8	try {
9	const database = client.db("<DATABASE-NAME>");
10	const collection = database.collection("<COLLECTION-NAME>");
11
12	// define your MongoDB Vector Search index
13	const index = {
14	"name": "<INDEX-NAME>",
15	"type": "vectorSearch",
16	"definition": {
17	"fields": [
18	{
19	"type": "vector",
20	"path": "<FIELD-NAME>",
21	"model": "voyage-3-large \| voyage-3.5 \| voyage-3.5-lite"
22	},
23	]
24	}
25	}
26	// run the helper method
27	await collection.createSearchIndex("<INDEX-NAME>", index);
28	} finally {
29	await client.close();
30	}
31	}
32	run().catch(console.dir);

1	from pymongo import MongoClient
2	from pymongo.operations import SearchIndexModel
3
4	client = pymongo.MongoClient("<CONNECTION-STRING>")
5	db = client["<DATABASE-NAME>"]
6	collection = db["<COLLECTION-NAME>"]
7
8	search_index_model = SearchIndexModel(
9	definition={
10	"fields": [
11	{
12	"type": "text",
13	"path": "<FIELD-NAME>",
14	"model": "voyage-3-large \| voyage-3.5 \| voyage-3.5-lite"
15	}
16	]
17	},
18	name="<INDEX-NAME>",
19	type="vectorSearch",
20	)
21	result = collection.create_search_index(model=search_index_model)
22	print(result)

1	from pymongo import MongoClient
2	from pymongo.operations import SearchIndexModel
3
4	client = MongoClient("<CONNECTION-STRING>")
5	db = client["sample_mflix"]
6	collection = db["movies"]
7
8	search_index_model = SearchIndexModel(
9	definition={
10	"fields": [
11	{
12	"type": "text",
13	"path": "fullplot",
14	"model": "voyage-3-large"
15	}
16	]
17	},
18	name="movies_automated_embeddings",
19	type="vectorSearch",
20	)
21	result = collection.create_search_index(model=search_index_model)
22	print(result)

1	{
2	"$vectorSearch": {
3	"index": "<index-name>",
4	"limit": <number-of-results>,
5	"numCandidates": <number-of-candidates>,
6	"path": "<field-to-search>",
7	"query": "<query-string>"
8	}
9	}

1	db.<COLLECTION-NAME>.aggregate([
2	{
3	"$vectorSearch": {
4	"index": "<INDEX-NAME>",
5	"path": "<FIELD-NAME>",
6	"query": "<QUERY-TEXT>",
7	"numCandidates": <NUMBER-OF-CANDIDATES-TO-CONSIDER>,
8	"limit": <NUMBER-OF-DOCUMENTS-TO-RETURN>
9	}
10	}
11	])

1	db.movies.aggregate([
2	{
3	"$vectorSearch": {
4	"index": "movies_automated_embeddings",
5	"path": "fullplot",
6	"query": "young heroes caught in epic struggles between light and darkness",
7	"numCandidates": 1000,
8	"limit": 10
9	}
10	},
11	{
12	"$project": {
13	"_id": 0,
14	"title": 1,
15	"fullplot": 1,
16	"score": {"$meta": "vectorSearchScore"}
17	}
18	}
19	])

1	[
2	{
3	title: 'Day Watch',
4	fullplot: 'Anton belongs to the Forces of the Light as well as his powerful girlfriend and apprentice, but his son is a powerful teenager from the Darkness and Anton protects him. When the balance between Light and Darkness is affected by the death of some evil vampires, Anton is framed and accused of the murders, and he chases an ancient chalk that has the power of changing the destiny of its owner.',
5	score: 0.5449697971343994
6	},
7	{
8	title: 'Dungeons & Dragons',
9	fullplot: "The Empire of Izmer has long been a divided land. The Mages - an elite group of magic-users - rule whilst the lowly commoners are powerless. Izmer's young Empress, Savina, wants equality and prosperity for all, but the evil Mage Profion is plotting to depose her and establish his own rule. The Empress possesses a scepter which controls Izmer's Golden Dragons. To challenge her rule, Profion must have the scepter, and tricks the Council of Mages into believing Savina is unfit to hold it. Knowing that Profion will bring death and destruction to Izmer, Savina must find the legendary Rod of Savrille, a mythical rod that has the power to control Red Dragons, a species even mightier than the Gold. Enter two thieves, Ridley and Snails, who unwittingly become instrumental in Savina's search for the Rod. Joined by a feisty Dwarf named Elwood, and helped by the Empress's expert tracker, the Elf Norda, the young heroes go in search of the Rod of Savrille. From the deadly maze of the Thieves Guild at Antius to an Elven Village, secret grotto and abandoned castles, Ridley and his band must outwit Profion's chief henchman Damodar at every turn while, back in Izmer, Profion prepares to do battle with the Empress. All depends on the Rod, but the outcome of the race to reach it first is far from certain, and Izmar's very survival hangs in the balance.",
10	score: 0.5414832830429077
11	},
12	{
13	title: 'Brave Story',
14	fullplot: 'A young boy attempts to change his destiny by entering a magic gateway to another world; but on his quest to find the Tower of Fortune and be granted any wish, he must conjure up all his bravery to battle demons, his friends, and ultimately himself.',
15	score: 0.5404887795448303
16	},
17	{
18	title: 'Justin and the Knights of Valour',
19	fullplot: 'Justin lives in a kingdom where bureaucrats rule and knights have been ousted. His dream is to be become one of the Knights of Valour, like his grandfather was, but his father Reginald, the chief counsel to the Queen, wants his son to follow in his footsteps and become a lawyer. After an inspiring visit to his beloved Grandmother and bidding farewell to his supposed lady-love Lara, Justin leaves home and embarks on a quest to become a knight. Along the way he meets the beautiful, feisty Talia, a quirky wizard called Melquiades, and the handsome Sir Clorex and is mentored by three monks; Blucher, Legantir and Braulio, who teach and test him in the ancient ways of the Knights of Valour. Whilst an unlikely candidate for knighthood, Justin must rise to the challenge quickly when banished former knight Sir Heraclio and his army, lead by Sota, return and threaten to destroy the Kingdom.',
20	score: 0.5374966859817505
21	},
22	{
23	title: 'Forest Warrior',
24	fullplot: 'John McKenna is a spiritual being who is able to transform into bear, wolf or eagle. He lives in the forests of Tanglewood and has dedicated his life to protect them. One day a gang of evil lumberjacks led by Travis Thorne arrive Tanglewood to chop the forest down. McKenna cannot let this happen, and together with his new friends - Lords of the Tanglewood, a band of children who love to play in the forest - he battles against Thorne and his evil gang.',
25	score: 0.5331881642341614
26	},
27	{
28	title: 'Forest Warrior',
29	fullplot: 'John McKenna is a spiritual being who is able to transform into bear, wolf or eagle. He lives in the forests of Tanglewood and has dedicated his life to protect them. One day a gang of evil lumberjacks led by Travis Thorne arrive Tanglewood to chop the forest down. McKenna cannot let this happen, and together with his new friends - Lords of the Tanglewood, a band of children who love to play in the forest - he battles against Thorne and his evil gang.',
30	score: 0.5331881642341614
31	},
32	{
33	title: 'Catatan (Harian) si Boy',
34	fullplot: "A circle of friends risking their Friendship, Trust, Love and Hope in search of a legend. A young and privileged teenager with a golden heart, beset with challenges and tribulations we face today with the goal to open many young people's mind with inspirations and hopes that drive them in achieving their dreams. To get out of their comfort zone and finish what they started.",
35	score: 0.5322973728179932
36	},
37	{
38	title: 'Bionicle: Mask of Light',
39	fullplot: "In a land of living machines, two young ones are chosen to seek the legendary Mask of Light to reveal the savior of all the lands from the dark forces of the Makuta. During the course of their adventure, they will call on the heroes of their people, the great Toa. These Toa, masters of nature's forces such as Fire, Wind, Earth & Water, try to protect the chosen ones as they seek their destiny.",
40	score: 0.5315042734146118
41	},
42	{
43	title: 'Fear No Evil',
44	fullplot: 'High school student turns out to be personification of Lucifer. Two arch angels in human form (as women) take him on.',
45	score: 0.5295513868331909
46	},
47	{
48	title: 'Tales of Vesperia: The First Strike',
49	fullplot: 'In a mythical kingdom, the mighty Imperial Knights harness a magical substance known as Aer to power their weapons and protect humanity from the monsters of the forest. But something strange is afoot. The Aer is somehow changing, causing the wilderness to waste away and stirring the woodland beasts to attack with greater frequency. As danger creeps steadily closer to civilization, two young recruits - Flynn, the rigid son of a fallen hero, and the rebellious and brash Yuri - must ride with their fellow Imperial Knights to distant ruins in hopes of uncovering the truth behind the transforming Aer. Some will not survive the thrilling journey. Some will be betrayed. If Flynn and Yuri cannot overcome their differences and learn to fight together, all will be lost for the people of the realm.',
50	score: 0.5276793241500854
51	}
52	]

1	const { MongoClient } = require("mongodb");
2
3	// connect to your Atlas cluster
4	const uri = "<CONNECTION-STRING>";
5
6	const client = new MongoClient(uri);
7
8	async function run() {
9	try {
10	await client.connect();
11
12	// set namespace
13	const database = client.db("<DATABASE-NAME>");
14	const coll = database.collection("<COLLECTION-NAME>");
15
16	// define pipeline
17	const agg = [
18	{
19	'$vectorSearch': {
20	'index': '<INDEX-NAME>',
21	'path': '<FIELD-NAME>',
22	'query': "<QUERY-TEXT>",
23	'numCandidates': <NUMBER-OF-CANDIDATES-TO-CONSIDER>,
24	'limit': <NUMBER-OF-DOCUMENTS-TO-RETURN>
25	}
26	}
27	];
28	// run pipeline
29	const result = coll.aggregate(agg);
30
31	// print results
32	await result.forEach((doc) => console.dir(JSON.stringify(doc)));
33	} finally {
34	await client.close();
35	}
36	}
37	run().catch(console.dir);

1	import pymongo
2
3	# connect to your Atlas cluster
4	client = pymongo.MongoClient("<CONNECTION-STRING>")
5
6	# define pipeline
7	pipeline = [
8	{
9	'$vectorSearch': {
10	'index': '<INDEX-NAME>',
11	'path': '<FIELD-NAME>',
12	'query': '<QUERY-TEXT>',
13	'numCandidates': <NUMBER-OF-CANDIDATES-TO-CONSIDER>,
14	'limit': <NUMBER-OF-DOCUMENTS-TO-RETURN>
15	}
16	}
17	]
18
19	# run pipeline
20	result = client["<DATABASE-NAME>"]["<COLLECTION-NAME>"].aggregate(pipeline)
21
22	# print results
23	for i in result:
24	print(i)
25

Considerations

Importante

Requisitos previos

Índice de búsqueda vectorial de MongoDB para incrustación automatizada

Acceso requerido

Sintaxis del índice

Campos de índices

Considerations

Crear un índice para la incrustación automatizada

En Atlas, vaya a la .leafygreen-ui-8n27nz{font-style:normal;font-weight:700;}Clusters Página para su proyecto.

En Atlas, vaya a la Search & Vector Search página de su clúster.

Se debe iniciar la configuración del índice.

Ejemplo

Define tu índice.

Ejemplo

Crea tu índice.

Nota

Conéctate al clúster Atlas usando mongosh.

Cambie a la base de datos que contiene la colección para la que desea crear el índice.

Ejemplo

Ejecute el db.collection.createSearchIndex() método.

Ejemplo

Inicia el proyecto de Node.js.

Crea el .js archivo.

Ejemplo

Define the index in the .js file.

Ejemplo

Sustituye los siguientes valores y guarda el archivo.

Ejecuta el siguiente comando para crear el índice.

Ejemplo

Crea un .py archivo.

Ejemplo

Define the index in the .py file.

Ejemplo

Sustituye los siguientes valores y guarda el archivo.

Ejecuta el siguiente comando para crear el índice.

Ejemplo

Consulta de búsqueda vectorial de MongoDB con incrustación automatizada

Sintaxis de consulta

Campos de consulta

Considerations

Ejecutar una consulta mediante incrustación automatizada

Conéctate al clúster Atlas usando mongosh.

Cambie a la base de datos que contiene la colección para la que desea ejecutar la consulta.

Ejemplo

Run the db.collection.aggregate() method with the $vectorSearch stage.

Ejemplo

Crea un .js archivo.

Ejemplo

Define la consulta en el archivo.

Ejemplo

Reemplace lo siguiente en la consulta.

Ejecuta la query.

Ejemplo

Crea un .py archivo.

Ejemplo

Define la consulta en el archivo.

Ejemplo

Reemplace lo siguiente en la consulta.

Ejecuta la query.

Ejemplo

En Atlas, vaya a la Clusters Página para su proyecto.

Conéctate al clúster Atlas usando `mongosh`.

Ejecute el `db.collection.createSearchIndex()` método.

Crea el `.js` archivo.

Define the index in the `.js` file.

Crea un `.py` archivo.

Define the index in the `.py` file.

Conéctate al clúster Atlas usando `mongosh`.

Run the `db.collection.aggregate()` method with the `$vectorSearch` stage.

Crea un `.js` archivo.

Crea un `.py` archivo.