Docs
Data
Memory Add Node

Memory Add Node

Loading node sections...

Overview

The Memory Add Node is a data storage component that stores and manages information in memory for use across workflow executions. This node enables persistent data storage and retrieval within workflows.

memory-add.png

Node Type Information

TypeDescriptionStatus
Batch TriggerStarts the flow on a schedule or batch event. Ideal for periodic data processing.❌ False
Event TriggerStarts the flow based on external events (e.g., webhook, user interaction).❌ False
ActionExecutes a task or logic as part of the flow (e.g., API call, transformation).âś… True

This node is an **Action** node that stores data in memory for persistent use across workflow executions.

Features

Key Functionalities
  1. Persistent Storage: Store and manage contextual information that persists across workflow executions.

  2. User & Session Management: Support for both user-level and session-specific memory storage with unique identifiers.

  3. Metadata Support: Attach additional metadata to stored memories.

Benefits
  1. Persistence: Maintain contextual information across multiple workflow executions.

  2. Scalability: Efficiently store and retrieve large amounts of contextual data.

  3. Flexibility: Support for both user-level and session-level memory storage.

What can I build?

  1. Chatbots that remember conversation history and user preferences.

  2. Personalized recommendation systems based on user interactions.

  3. Knowledge management systems with contextual information retrieval.

Setup

Configure the Memory Node

  1. Select the Memory Add Node in your workflow.
  2. Configure the unique user identifier.
  3. Choose or create a memory collection.
  4. Set up the embedding and generative models.
  5. Define optional session ID and metadata.
  6. Add the Memory Value
  7. Deploy the project.

Configuration Reference

ParameterDescriptionExample Value
Unique IdIdentifier for the user whose memory is being stored29fcd52e-0813-4fa2-821c-1428a05636ba
Session IdOptional identifier for specific user sessions2 (Defaults to Global)
Memory StoreThe collection where memories will be storedMemoryStore
Memory ValueThe actual data from which facts to be retrieved and updated in memoryI like cats
Embedding Model NameModel used for converting text to vectorstext-embedding-ada-002
Generative Model NameModel used for processing stored informationgpt-3.5-turbo
MetadataAdditional JSON data to store with the memory{"source": "chat"}

Low-Code Example

- nodeId: memoryNode_858
    nodeType: memoryNode
    nodeName: Memory Add
    values:
      uniqueId: '{{triggerNode_1.output.userId}}'
      sessionId: ''
      memoryValue:
        - role: user
          content: User likes to watch Pokemon
      memoryCollection: finalTest
      embeddingModelName:
        type: embedder/text
        model_name: default
        credentialId: some-id
        provider_name: openai
        credential_name: NEW PROVIDER
      generativeModelName:
        type: generator/text
        model_name: default
        credentialId: Some Credential Id
        provider_name: openai
        credential_name: Testing OpenAI

Output

-memoryActions: An array of objects representing actions or operations performed on the memory, which may be empty if no actions are recorded. -extractedFacts: An array of strings containing facts or insights derived from the input data and added to the memory.

Example Output

{
    "memoryActions": [],
    "extractedFacts": [
      "User expressed a positive opinion about lamatic."
    ]
  }

Common Issues and Debugging

  1. Memory Not Being Stored

    • Verify the Unique Id is properly configured and not empty
    • Check that the Memory Collection name matches exactly across nodes
    • Ensure the Memory Value contains valid content.
    • Confirm the embedding model is accessible and running

Troubleshooting Steps

  1. Check Node Configuration

    • Verify all required fields are filled
  2. Monitor Workflow Logs

    • Look for error messages in the execution logs
    • Check for timeout or rate limit errors
  3. Test Memory Operations

    • Use the workflow testing feature to verify storage
    • Confirm immediate retrieval after storage
    • Test with simple data before complex implementations

Was this page useful?

Questions? We're here to help

Subscribe to updates