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 marcação de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL .
Make the MongoDB docs better! We value your opinion. Share your feedback for a chance to win $100.
MongoDB Branding Shape
Click here >
Menu Docs

Integrar o MongoDB com n8n

Você pode integrar o MongoDB ao n8n para criar automações e fluxos de trabalho de agente usando sua interface visual sem código. Esta página fornece uma visão geral da integração e descreve os diferentes tipos de nós que você pode usar em seus fluxos de trabalho.

Para instalar o n8n, consulte a documentação n8n ou execute o seguinte comando utilizando npm para começar rapidamente:

npx n8n

Para saber como criar um agente de IA básico usando n8n e MongoDB, consulte Criar um agente de IA com MongoDB e n8n.

Importante

Todos os nós n8n do MongoDB exigem que você configure suas credenciais do MongoDB em n8n. Para saber mais, consulte Credenciais MongoDB.

O nó do MongoDB permite automatizar o trabalho no MongoDB e integrar o MongoDB com outros nós em seus fluxos de trabalho n8n.

Use o nó do MongoDB em qualquer um dos seus fluxos de trabalho n8personalizados.

O nó MongoDB suporta as seguintes operações:

categoria
(operação)
Descrição

Operações de documentos

Documentos agregados

Execute operações de agregação para processar e transformar dados usando agregação pipelines do MongoDB .

Encontrar documentos

Consulte e recupere documentos de suas coleções MongoDB com opções de filtragem flexíveis.

Insira documentos

Adicione novos documentos às suas collections do MongoDB .

Atualize documentos

Modifique documentos existentes em suas collections.

Exclua documentos

Remova documentos de suas coleções.

Localizar e substituir documentos

Pesquise documentos e substitua-os por novo conteúdo.

Encontrar e atualizar documentos

Pesquise documentos e atualize campos específicos.

Operações de índice de pesquisa

Crie índices de pesquisa

Crie novos índices de pesquisa e pesquisa vetorial em suas coleções.

Listar índices de pesquisa

Recupere informações sobre índices de pesquisa existentes.

Atualizar índices de pesquisa

Modifique as configurações de índice de pesquisa existentes.

Índices de pesquisa

Remova os índices de pesquisa que não são mais necessários.

Dica

Para saber mais, consulte n8n documentação do nó do MongoDB

O nó MongoDB Atlas permite que você use o MongoDB pesquisa vetorial em seus fluxos de trabalho de agentes.

Observação

Antes de começar a usar este nó, configure o índice de pesquisa vetorial do MongoDB.

Use o nó MongoDB Vector Store nos seguintes padrões de fluxo de trabalho:

Conecte-se diretamente a um agente de IA como uma ferramenta para executar o RAG agente.

AI Agent (tools connector) → MongoDB Vector Store

Para obter um tutorial, consulte Criar um agente de IA com MongoDB e n8n.

Para saber mais sobre os agentes de IA em n8n, consulte Nó do agente de IA.

Use o MongoDB Atlas Vector Store como um nó regular para inserir ou recuperar documentos em seus fluxos de trabalho personalizados:

Trigger → MongoDB Vector Store (Insert/Get) → Next Node

Para saber mais, consulte Nós.

Use o nó como um recuperador em uma cadeia de resposta a perguntas:

Question and Answer Chain → Vector Store Retriever → MongoDB Vector Store

Para saber mais sobre P e R em n8n, consulte nó de cadeia de perguntas e respostas.

Use o nó como uma ferramenta de resposta a perguntas para um agente de IA :

AI Agent → Vector Store Question Answer Tool → MongoDB Vector Store

Para saber mais sobre a ferramenta de resposta a perguntas em n8n, consulte o nó Ferramenta de resposta a perguntas do Vector Store.

O nó MongoDB Vector Store suporta os seguintes modos de operação. O modo de recuperação de documento só está disponível em determinados padrões de fluxo de trabalho.

Modo de operação
Descrição

Obtenha muitos

Recupere vários documentos usando a pesquisa de similaridade com base em um prompt. Retorna documentos com pontuações de similaridade.

Insira documentos

Adicione novos documentos com incorporações vetoriais à sua coleção.

Recuperar documentos (como armazenamento de vetor para cadeia/ferramenta)

Disponível apenas quando você usa o nó como recuperador ou ferramenta. Deve ser conectado a um nó de recuperação ou nó raiz.

Recuperar documentos (como ferramenta para o agente de IA)

Disponível apenas quando você usa o nó como uma ferramenta para um agente de IA. O agente usa esse armazenamento de vetor quando o nome e a descrição são relevantes para o prompt.

Configure o nó do MongoDB Vector Store com os parâmetros a seguir.

categoria
Contexto
Modo de operação
Descrição

Parâmetros comuns

MongoDB Collection

Todos

Nome da collection MongoDB a ser usada.

Vector Index Name

Todos

Nome do índice Vector Search na sua collection do MongoDB .

Embedding Field

Todos

Nome do campo em seus documentos que contém as incorporações vetoriais.

Metadata Field

Todos

Nome do campo em seus documentos que contém os metadados de texto.

Parâmetros específicos do modo

Name

Recuperar documentos (como ferramenta para o agente de IA)

Nome da ferramenta de armazenamento de vetor para o agente de IA .

Description

Recuperar documentos (como ferramenta para o agente de IA)

Explicação para o LLM sobre o que essa ferramenta faz.

Limit

Recuperar documentos (como ferramenta para o agente de IA)

Número de resultados a serem recuperados do armazenamento de vetores.

Opções adicionais

Metadata Filter

Obtenha muitos, recupere documentos (como ferramenta para o agente de IA), Recupere documentos (como o Vector Store para cadeia/ferramenta)

Filtre resultados com base em critérios de metadados.

Rerank Results

Obtenha muitos, recupere documentos (como ferramenta para o agente de IA), Recupere documentos (como o Vector Store para cadeia/ferramenta)

Habilitar a reclassificação de resultados (requer a conexão de um nó de reclassificação).

Dica

O nó Memória de bate-papo do MongoDB permite que você use o MongoDB como um armazenamento de memória para armazenar o histórico de bate-papo em seus fluxos de trabalho de IA. Isso permite um contexto de conversa persistente nas execuções do fluxo de trabalho.

Você deve usar o nó Memória de bate-papo MongoDB como um subnó adicionando-o à seção Memory de um nó de agente de IA. Para obter um tutorial, consulte Criar um agente de IA com MongoDB e n8n.

Observação

Se você adicionar vários nós de memória de bate-papo do MongoDB ao seu fluxo de trabalho, todos os nós acessarão a mesma instância de memória por padrão. Para instâncias de memória separadas, use IDs de sessão diferentes em cada nó de memória.

Configure o nó de memória de bate-papo do MongoDB com esses parâmetros.

Parâmetro
Descrição

ID da sessão

Método para determinar como a chave de sessão é identificada. Você pode definir a chave de sessão por meio de um trigger conectado ou pode definir a chave manualmente.

Chave de sessão

Identificador único para a sessão de chat.

Nome da collection

Nome da coleção para armazenar o histórico de bate-papo. O MongoDB cria a collection se ela não existir. Padrão é n8n_chat_histories.

Nome do banco de dados

Nome do banco de dados para armazenar o histórico de bate-papo. Se não for fornecido, n8n usa o banco de dados a partir das credenciais.

Comprimento da janela de contexto

Número de interações anteriores a serem consideradas para contexto.

Para saber mais sobre n8n, utilize os seguintes recursos: