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.
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
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.
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