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

Solução de problemas

Este documento fornece conselhos para solucionar problemas com a pesquisa vetorial do MongoDB. Para obter assistência direta com problemas de pesquisa vetorial do MongoDB, você pode iniciar uma discussão sobre as comunidades do MongoDB no Reddit ou no Stack Overflow, ou entrar em contato com o suporte.

Para usar o estágio do pipeline $vectorSearch para consultar seu cluster, seu cluster deve executar o MongoDB 7.0.2+. Se você invocar $vectorSearch em uma versão incompatível do MongoDB, poderá ver o seguinte erro:

OperationFailure: $vectorSearch is not allowed with the current
configuration. You may need to enable the corresponding feature
flag.

Para verificar a versão do MongoDB do seu cluster:

1
  1. Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.

  2. Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.

  3. Na barra lateral, clique em Clusters sob o título Database.

A página Clusters é exibida.

2

Localize o painel de informações do cluster em que você deseja usar o $vectorSearch .

3

Consulte o número Version na seção inferior do painel de informações.

Se o cluster executar uma versão do MongoDB anterior a 6.0.11 ou 7.0.2, você deve atualizar a versão MongoDB do cluster.

Para obter recomendações sobre como melhorar o desempenho da query, consulte Benchmark for MongoDB Vector Search.

Se $vectorSearch queries não retornarem resultados, execute as seguintes ações:

  • Certifique-se de que está a utilizar o mesmo modelo de incorporação para os seus dados e para a sua query. Se você incorporar sua query usando um modelo diferente do que usa para incorporar seus dados, $vectorSearch não conseguirá identificar as correspondências.

  • Certifique-se de que sua pesquisa vetorial do MongoDB tenha terminado de ser construída. Quando você cria ou atualizar um índice do MongoDB pesquisa vetorial, o índice do índice está em um estado de sincronização inicial. Quando terminar de ser criado, você poderá começar a consultar os dados em sua coleção.

Ao usar o LangChain para realizar a RAG com pré-filtragem, você pode encontrar o seguinte erro:

Error during the document retrieval or generation process:
MongoServerError: PlanExecutor error during aggregation :: caused
by :: Path 'field' needs to be indexed as token

Se houver um índice no field, certifique-se de ter criado esse índice como um índice do MongoDB pesquisa vetorial, e não um índice do MongoDB Search. Se não existir nenhum índice em field, crie um. Para saber mais sobre a implementação do RAG com o MongoDB Vector Search e o LangChain, consulte Responder a perguntas sobre seus dados.

Ao tentar criar um índice do MongoDB Vector Search programaticamente, você pode encontrar um erro Command not found. Esse erro ocorre por um dos dois motivos:

Atualmente, a Vector Search do MongoDB suporta filtragem apenas em campos com valores booleanos, data, número, ObjectId, string e UUID. Para saber mais, consulte Sobre o tipo filter.