Memory

Add memory store

The Memory tool enables your agents to store, retrieve, and manage conversation memories across workflows. It acts as a persistent memory store that agents can access to maintain conversation context, recall facts, or track actions over time.

With the Memory tool, you can:

  • Add new memories: Store relevant information, events, or conversation history by saving agent or user messages into a structured memory database
  • Retrieve memories: Fetch specific memories or all memories tied to a conversation, helping agents recall previous interactions or facts
  • Delete memories: Remove outdated or incorrect memories from the database to maintain accurate context
  • Append to existing conversations: Update or expand on existing memory threads by appending new messages with the same conversation identifier

Sim’s Memory block is especially useful for building agents that require persistent state—helping them remember what was said earlier in a conversation, persist facts between tasks, or apply long-term history in decision-making. By integrating Memory, you enable richer, more contextual, and more dynamic workflows for your agents.

Usage Instructions

Integrate Memory into the workflow. Can add, get a memory, get all memories, and delete memories.

Tools

memory_add

Add a new memory to the database or append to existing memory with the same ID.

Input

ParameterTypeRequiredDescription
conversationIdstringNoConversation identifier (e.g., user-123, session-abc). If a memory with this conversationId already exists, the new message will be appended to it.
idstringNoLegacy parameter for conversation identifier. Use conversationId instead. Provided for backwards compatibility.
rolestringYesRole for agent memory (user, assistant, or system)
contentstringYesContent for agent memory

Output

ParameterTypeDescription
successbooleanWhether the memory was added successfully
memoriesarrayArray of memory objects including the new or updated memory
errorstringError message if operation failed

memory_get

Retrieve memory by conversationId. Returns matching memories.

Input

ParameterTypeRequiredDescription
conversationIdstringNoConversation identifier (e.g., user-123, session-abc). Returns memories for this conversation.
idstringNoLegacy parameter for conversation identifier. Use conversationId instead. Provided for backwards compatibility.

Output

ParameterTypeDescription
successbooleanWhether the memory was retrieved successfully
memoriesarrayArray of memory objects with conversationId and data fields
messagestringSuccess or error message
errorstringError message if operation failed

memory_get_all

Retrieve all memories from the database

Input

ParameterTypeRequiredDescription

Output

ParameterTypeDescription
successbooleanWhether all memories were retrieved successfully
memoriesarrayArray of all memory objects with key, conversationId, and data fields
messagestringSuccess or error message
errorstringError message if operation failed

memory_delete

Delete memories by conversationId.

Input

ParameterTypeRequiredDescription
conversationIdstringNoConversation identifier (e.g., user-123, session-abc). Deletes all memories for this conversation.
idstringNoLegacy parameter for conversation identifier. Use conversationId instead. Provided for backwards compatibility.

Output

ParameterTypeDescription
successbooleanWhether the memory was deleted successfully
messagestringSuccess or error message
errorstringError message if operation failed

On this page

Start building today
Trusted by over 60,000 builders.
Build Agentic workflows visually on a drag-and-drop canvas or with natural language.
Get started