Overview
The RoundRobin: Memory Recall node is designed to retrieve and inspect the raw memory state of a conversation previously stored by other RoundRobin nodes in n8n. It allows users to recall conversation data—including messages, roles, and metadata—for debugging, auditing, or further processing within workflows. This node is particularly useful for scenarios where you need to review the history or context of automated conversations, such as chatbots, meeting notes, support chats, or any collaborative workflow that leverages conversational memory.
Practical examples:
- Debugging chatbot flows by inspecting the full message history and role assignments.
- Auditing customer service interactions by recalling stored conversation logs.
- Extracting meeting notes or strategy discussions for reporting or analysis.
Properties
| Display Name | Type | Description |
|---|---|---|
| Recall Options | notice | Informs the user about the purpose of the node (for inspection/debugging of conversation memory). |
| Binary Output Property | string | Name of the binary property from which to read the memory data (default: data). |
| Storage ID | string | Optional custom ID for conversation storage; used if "Use Custom Storage ID" is enabled. |
| Use Custom Storage ID | boolean | Whether to use a custom storage ID instead of the default workflow ID. |
| Include Messages | boolean | Whether to include message history in the output. |
| Include Roles | boolean | Whether to include role definitions in the output. |
| Include Metadata | boolean | Whether to include conversation metadata in the output. |
| Memory Selection | notice | Informs the user to select which conversation memory to retrieve. |
| Conversation Memory | options | Selects which predefined or custom conversation memory to recall. |
| Custom Memory ID | string | If "Custom ID" is selected above, enter the specific memory ID to recall. |
Output
The node outputs an array with a single item containing:
JSON Output Structure
{
"status": "success" | "warning" | "error",
"operation": "recall", // Only present on success
"timestamp": "<ISO timestamp>",
"memoryId": "<ID used for recall>",
"conversation_id": "<conversationId or memoryId>",
"memory": {
"messages": [ /* Array of message objects, if included */ ],
"roles": [ /* Array of role definitions, if included */ ],
"spotCount": <number>, // Only if metadata included
"roundCount": <number>, // Only if metadata included
"maxRounds": <number>, // Only if metadata included
"lastUpdated": "<ISO date>",// Only if metadata included
"title": "<string>", // Only if metadata included
"context": "<string>", // Only if metadata included
"talkingPoints": [ /* Array, only if metadata included */ ],
"isNewConversation": <boolean> // Only if metadata included
}
}
- On success, all requested fields are populated.
- On warning (e.g., no binary data found), the output includes a message and minimal info.
- On error (e.g., invalid binary data), the output includes an error message and available binary properties.
Binary Output
- The node passes through the original binary data unchanged. No new binary data is generated.
Dependencies
- External Storage Manager: The node relies on an external storage manager module (
createStorageManager) to load memory data from binary input. - Input Requirements: The node expects binary data to be present in the specified property (default:
data). This binary data should originate from a compatible RoundRobin node. - No API keys or environment variables are required for this node itself.
Troubleshooting
Common Issues:
- No binary data found:
- Message:
"No memory data found. Nothing to recall."- Cause: The previous node did not provide binary data, or the wrong property was specified.
- Solution: Ensure the node is connected after a compatible RoundRobin node and the correct binary property is set.
- Message:
- Invalid binary data:
- Message:
"No valid binary data found. Please connect this node to a previous RoundRobin node."- Cause: The binary data structure is missing or corrupted.
- Solution: Check that the upstream node outputs valid memory data and that the binary property name matches.
- Message:
- Workflow ID undefined:
- Warning in logs: Falls back to node name if workflow ID is missing.
- Solution: Normally not critical, but ensure your workflow is properly saved and named.
- Warning in logs: Falls back to node name if workflow ID is missing.
Error Handling:
- Any unexpected errors are wrapped and reported as n8n NodeOperationError with a descriptive message.
Links and References
- n8n Documentation: Working with Binary Data
- n8n Custom Nodes Guide
- For more on RoundRobin nodes, refer to your organization's internal documentation or the source repository.