Pular para conteúdo

As páginas sem tradução abrem em inglês e são identificadas como inglês.

Esta página é uma tradução automática da página em inglês, que prevalece. Machine-translated from the English page, which is authoritative.

Adaptador do n8n

O pacote da comunidade n8n armazena o histórico de conversas e fatos duráveis em uma implantação do Loom por meio do SDK TypeScript. Os nós não adicionam nenhum serviço de armazenamento nem cache local.

Interfaces e armazenamento

LoomMemory.supplyData retorna o BufferWindowMemory do framework, apoiado por uma implementação LoomChatHistory de BaseListChatMessageHistory. A serialização das mensagens usa o formato de mensagem armazenada do framework. A janela altera o contexto enviado a um modelo, enquanto as mensagens mais antigas continuam disponíveis para leituras posteriores e para limpeza explícita.

Cada mensagem é uma memória episodic, com um timestamp e um sufixo aleatório em sua chave. As gravações episódicas preservam mensagens repetidas sem mesclagem semântica. A organização, o namespace e o nome do agente Loom delimitam o escopo do histórico. O usuário e um resumo (digest) dos identificadores de workflow/sessão fornecem os demais campos de identidade. As leituras percorrem as páginas de memory.list, eliminam duplicatas de páginas sobrepostas quando as linhas projetadas são filtradas, ordenam por chave e usam memory.get para valores truncados. clear exclui apenas esses itens. Gravadores concorrentes não têm transação que abranja um turno inteiro.

O nó de ação do Loom chama memory.set, memory.search e knowledge.search. Suas entradas fornecem a organização, o namespace, o nome do agente e, opcionalmente, o usuário. O servidor deriva a proveniência a partir do token e da operação e aplica as concessões de namespace.

Empacotamento

O pacote inclui o SDK e as bibliotecas do framework para evitar conflitos de dependências em tempo de execução com outros nós da comunidade. Seu build inclui os arquivos de licença dessas bibliotecas. n8n-workflow é a dependência peer fornecida pelo host. As dependências de desenvolvimento fixam as interfaces usadas pelos testes; elas não são adicionadas às dependências do servidor nem do SDK do Loom.

O pacote tem como alvo o n8n auto-hospedado, com a configuração da CLI oficial de nós para esse alvo. Ele não afirma ter sido verificado no Cloud. O workflow de tag de release faz o build e verifica o pacote antes de publicar com um npm trusted publisher e provenance; nenhum token de registro é armazenado no repositório.

Invariantes

  • O adaptador envia dados somente para a URL do Loom presente em sua credencial do n8n.
  • As concessões do token autorizam o acesso; um parâmetro de usuário é um filtro, não uma autorização.
  • A limpeza da conversa não exclui os fatos duráveis criados pelo nó de ação.
  • Recusas do SDK ou do servidor fazem o nó falhar, ou viram itens de erro com continue-on-fail.
  • O adaptador não cria tabelas e usa os caminhos de exclusão já existentes do Loom.

Pontos de entrada no código-fonte

  • integrations/n8n/nodes/LoomMemory/LoomChatHistory.ts: persistência de mensagens.
  • integrations/n8n/nodes/LoomMemory/LoomMemory.node.ts: adaptador de memória do framework.
  • integrations/n8n/nodes/Loom/Loom.node.ts: ações de memória durável e de documentos.
  • .github/workflows/n8n-publish.yml: verificações e publicação confiável.

Configuração do framework