# Memória para o AI Agent do n8n: um nó de comunidade, antes e depois do agente | Niadra

> Como dar memória de cliente a um AI Agent do n8n sem código: o nó de comunidade n8n-nodes-niadra lê o contexto do cliente antes do agente, registra os turnos depois, busca no histórico, registra verificação, transbordo e fim da conversa. Falha aberta por padrão. Instalação, operações e limites.

URL: https://niadra.com/integracoes/n8n

Integração · n8n

# Memória para o AI Agent do n8n.

n8n-nodes-niadra é um nó de comunidade do n8n. Ponha-o antes e depois do seu nó AI Agent, ou entregue-o ao agente como ferramenta, para o agente começar cada conversa sabendo o que o cliente já contou aos outros agentes, e para o que ele diz chegar aos outros também. Sem código.

[Pedir acesso antecipado](/enterprise)[Documentação do adaptador(abre docs.niadra.com)](https://docs.niadra.com/integrations/n8n)

A memória do AI Agent do n8n é a janela de mensagens desta execução, ou um armazenamento por sessão da sua escolha. Ela é do fluxo. O agente de voz de outro fornecedor, o agente de WhatsApp de outro fluxo e o agente que age no ERP não leem o que esse fluxo sabe, e ele não lê o que eles fizeram.

O nó lê o contexto do cliente antes do agente, pelo identificador que o seu gatilho traz (o wa\_id do WhatsApp, o número de quem liga, o seu id de usuário), e registra o que o cliente e o agente disseram depois. Toda operação falha aberta por padrão: com a Niadra lenta ou fora, o nó devolve um resultado vazio com um campo error e o fluxo segue.

## Instalar

No n8n, Settings, Community Nodes, Install, e digite n8n-nodes-niadra. O pacote mora em packages/n8n-nodes-niadra do repositório do SDK de TypeScript e é publicado no npm junto do @niadra/sdk. A credencial Niadra API é uma chave de fonte do seu espaço (nia\_sk\_...): ela nomeia a região e o espaço, então o endereço vem dela; Base URL só para o emulador local.

## Como o adaptador se liga

As cinco primitivas de toda integração da Niadra, nos pontos de extensão deste framework.

Contexto

Get Context devolve o contexto do cliente para o prompt do agente: text, para depois da sua mensagem de sistema, e suffix, com as falas de outros canais, para o fim do prompt.

Turnos

Track Turn registra o que o cliente ou o agente disse, chaveado pelo id da mensagem no provedor, então um passo repetido é registrado uma vez. End registra que a conversa terminou.

Ferramentas

Search History busca em conversas passadas, promessas, ações e objetos de negócio; When recebe o período nas palavras do cliente ("semana passada", "last week"). O nó também pode ser entregue ao AI Agent como ferramenta.

Verificação

Verify registra que o cliente provou quem é: um OTP, um login, o atestado da operadora.

Transbordo

Handoff registra a transferência para uma pessoa ou para outro agente.

## O que o agente recebe

O contexto é compilado quando a memória muda e servido pronto, sem modelo de IA na leitura. O que outro canal disse durante a conversa chega como delta, no fim do prompt.

-   Quem é o cliente, pelo que a conversa já provou: o nível de verificação decide o que entra
-   Fatos, pendências e promessas, com a data e o canal de origem
-   O que outros agentes fizeram por dentro, confirmado pelo sistema de registro
-   Padrões calculados por regra, com as evidências e o prazo
-   As três ferramentas do histórico: buscar, linha do tempo e abrir um item, amarradas ao cliente no seu código
-   Comprovante de cada leitura, encadeado por SHA-256

[Ver o contexto por dentro](/produtos/contexto)

## O que o adaptador não faz

-   Toda operação falha aberta por padrão: com a Niadra lenta ou fora, o nó devolve um resultado vazio com um campo error e o fluxo segue. Desligue Fail Open para parar o fluxo.
-   Amarre Customer Handle aos dados do seu gatilho (o wa\_id do WhatsApp, o número de quem liga, o seu id de usuário), nunca a um valor que o modelo escreva: o cliente nunca é algo que o modelo escolhe.
-   O nó não traz a memória do agente nem a linha do tempo; para isso, use o SDK ou o servidor MCP.
-   Construído e testado contra n8n-workflow 2.16. O desenho do nó e da credencial segue o nó do n8n da Mem0 (MIT), com atribuição em NOTICE.

## Perguntas frequentes

### Como instalo?

No n8n, Settings, Community Nodes, Install, e digite n8n-nodes-niadra. A credencial é uma chave de fonte do seu espaço (nia\_sk\_...): ela nomeia a região e o espaço, então o endereço vem dela. Base URL só para o emulador local.

### Onde o nó entra no fluxo?

Get Context antes do AI Agent, com o Customer Handle vindo do gatilho; Track Turn depois, com a mensagem do cliente e a resposta do agente; End quando a conversa termina. Search History pode ir como ferramenta do agente.

### E se a Niadra não responder no meio do fluxo?

O nó devolve um resultado vazio com um campo error e o fluxo segue: o agente responde sem o contexto, como responde hoje. Se preferir que o fluxo pare, desligue Fail Open no nó.

### Preciso trocar de modelo, de prompt ou de fornecedor?

Não. O adaptador coloca o contexto depois das suas instruções e o delta no fim do prompt, nos pontos de extensão que o framework já tem. O seu modelo, o seu prompt e o seu fornecedor continuam os mesmos, e trocar qualquer um deles depois não apaga a memória.

### Onde ficam os dados e quanto custa?

Os dados ficam numa região só, informada no contrato, cifrados com AES-256-GCM e chave exclusiva por empresa, protegida em HSM FIPS 140-3. O preço é por conversa ou tarefa em que um agente leu a memória: de US$ 2 a 3 a cada mil, conforme o volume, com leituras, buscas e eventos de sistema incluídos. A Niadra está abrindo para empresas por pedido, antes do lançamento.

## Outras integrações

-   [LiveKit Agents](/integracoes/livekit)
-   [Pipecat](/integracoes/pipecat)
-   [Vapi](/integracoes/vapi)
-   [Retell AI](/integracoes/retell)
-   [ElevenLabs Agents Platform](/integracoes/elevenlabs)
-   [Twilio](/integracoes/twilio)
-   [WhatsApp Cloud API](/integracoes/whatsapp)
-   [OpenAI Agents SDK](/integracoes/openai-agents)
-   [LangGraph](/integracoes/langgraph)
-   [LangChain](/integracoes/langchain)
-   [CrewAI](/integracoes/crewai)
-   [Vercel AI SDK](/integracoes/ai-sdk)
-   [As 36 integrações, na documentação(abre docs.niadra.com)](https://docs.niadra.com/integrations/overview)

## Conte o que você está construindo.

E-mail corporativo e duas linhas sobre os seus agentes bastam. Quem responde é quem escreve o código, com uma proposta de acesso antecipado para o seu caso.

[Prefere contar mais sobre a sua empresa? Use o formulário completo](/enterprise)