Executar uma query de pesquisa vetorial do MongoDB

Visão geral

Neste guia, você pode aprender a realizar pesquisas em seus documentos usando o recurso Pesquisa Vetorial do MongoDB. O Laravel MongoDB fornece uma API para executar queries de pesquisa do MongoDB Vector Search diretamente com seus modelos. Este guia descreve como criar índices de pesquisa vetorial do MongoDB e fornece exemplos de como usar a integração Laravel para realizar pesquisas.

Para saber mais sobre a pesquisa vetorial do MongoDB, consulte a Visão geral na documentação do Atlas. A API de pesquisa vetorial do MongoDB usa internamente o operador de agregação $vectorSearch para executar as query. Para saber mais sobre este operador, consulte a referência $vectorSearch na documentação do Atlas.

Crie um índice de Vector Search do MongoDB

Você pode criar um índice do MongoDB Search de uma das seguintes maneiras:

• Chame o método create() na fachada Schema e passe o método assistente vectorSearchIndex() com os detalhes da criação do índice. Para saber mais sobre essa estratégia, consulte a seção Gerencie índices do MongoDB Search e do MongoDB Vector Search do guia "Construtor de esquema".

• Acesse uma coleção e, em seguida, chame o método createSearchIndex() da biblioteca PHP do MongoDB . Você deve especificar a opção type como 'vectorSearch', conforme mostrado no código a seguir:

  $collection = DB::connection('mongodb')->getCollection('movies');
  $collection->createSearchIndex([
      'fields' => [
          [
              'type' => 'vector',
              'numDimensions' => 4,
              'path' => 'embeddings',
              'similarity' => 'cosine'
          ],
      ],
  ], ['name' => 'vector_index', 'type' => 'vectorSearch']);

Executar queries

Nesta seção, você pode aprender como usar a API de pesquisa vetorial do MongoDB na integração com o Laravel. A Integração Laravel fornece o método vectorSearch() como um método construtor de query e como um método de modelo Eloquent. Você pode usar o método vectorSearch() para executar query de pesquisa do MongoDB Vector Search em documentos em suas coleções.

Você deve passar os seguintes parâmetros para o método vectorSearch() :

O código a seguir usa o índice vector criado na seção anterior Criar um índice de pesquisa vetorial do MongoDB para executar uma query do MongoDB pesquisa vetorial na coleção movies:

$movies = Book::vectorSearch(
    index: 'vector',
    path: 'vector_embeddings',
    // Vector representation of the query `coming of age`
    queryVector: [-0.0016261312, -0.028070757, ...],
    limit: 3,
);

[
   { "title": "Sunrising",
     "plot": "A shy teenager discovers confidence and new friendships during a transformative summer camp experience."
   },
   { "title": "Last Semester",
     "plot": "High school friends navigate love, identity, and unexpected challenges before graduating together."
   }
]

Você pode utilizar o método vectorSearch() para executar muitos tipos de queries de pesquisa do MongoDB Search. Dependendo da query desejada, você pode passar os seguintes parâmetros opcionais para vectorSearch():

Para saber mais sobre esses parâmetros, consulte a seção Campos da referência do operador $vectorSearch na documentação do Atlas.