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 Vector Search do MongoDB . Para obter assistência direta com problemas de Vector Search 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.

If your cluster runs a version of MongoDB earlier than 6.0.11 or 7.0.2, you must upgrade the MongoDB version of the 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.

  • Ensure that your MongoDB Vector Search has finished building. When you create or update a MongoDB Vector Search index, the index the index is in an initial sync state. When it finishes building, you can start querying the data in your collection.

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

If an index on field exists, ensure you have created this index as a MongoDB Vector Search index, not a MongoDB Search index. If no index on field exists, create one. To learn more about implementing RAG with MongoDB Vector Search and LangChain, see Answer Questions on Your Data.

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.