Este documento fornece orientação para solução de problemas com o Atlas Vector Search. Para assistência direta com problemas do Atlas Vector Search, inicie uma conversa na MongoDB Developer Community ou entre em contato com o suporte.
Não é possível usar o estágio $vectorSearch no cluster do Atlas
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:
No Atlas, VáGo para a Clusters página do seu projeto.
AVISO: Melhorias de navegação em andamento No momento, estamos implementando uma experiência de navegação nova e aprimorada. Se as etapas a seguir não corresponderem à sua visualização na IU do Atlas, consulte a documentação de pré-visualização.
Se ainda não tiver sido exibido, selecione a organização que contém seu projeto no menu Organizations na barra de navegação.
Se ainda não estiver exibido, selecione o projeto desejado no menu Projects na barra de navegação.
Se ainda não estiver exibido, clique em Clusters na barra lateral.
A página Clusters é exibida.
Localize o painel de informações do cluster em que você deseja usar o $vectorSearch .
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.
Queries lentas
Para obter recomendações sobre como melhorar o desempenho da query, consulte Benchmark para a pesquisa de vetores do Atlas.
$vectorSearch não retorna resultados
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,
$vectorSearchnão conseguirá identificar as correspondências.Certifique-se de que seu Atlas Vector Search tenha terminado de ser construído. Quando você cria ou atualiza um índice do Atlas Vector Search , 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.
Error during document retrieval ao usar filtragem com LangChain
Ao usar o LangChain para executar o 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 Atlas Vector Search, não um índice do Atlas Search. Se não existir nenhum índice em field , crie um. Para saber mais sobre a implementação do RAG com o Atlas Vector Search e o LangChain, consulte Responder a perguntas sobre seus dados.
Command not found ao criar o índice do Atlas Vector Search
Ao tentar criar um índice do Atlas Vector Search programaticamente, você pode encontrar um erro Command not found . Esse erro ocorre por um dos dois motivos:
Você executa o comando em um cluster do Atlas executando uma versão do MongoDB anteriores a 6.0.11 ou 7.0.2. Nesse caso, você deve atualizar a versão do MongoDB do cluster para habilitar o Atlas Vector Search para o cluster.
Você executa o comando em um cluster de camada grátis do
M0. Nesse caso, desde que o cluster esteja executando uma versão compatível do MongoDB, você pode criar um índice do Atlas Vector Search com a UI do Atlas.
Não foi possível filtrar em um determinado campo
Atualmente, o Atlas Vector Search suporta filtragem apenas em campos com valores booleanos, data, número, ObjectId, string e UUID. Para saber mais, consulte Sobre o filter tipo.