Actions3
- Memory Actions
Overview
The Memory Box node allows users to interact with a memory storage API to store, retrieve, and search textual memories. It is useful for scenarios where you want to save pieces of information (memories) for later retrieval or querying, such as building personal knowledge bases, chatbots with context retention, or any application requiring persistent text snippets.
For example, you can use this node to:
- Store notes or messages into a memory bucket.
- Search stored memories by keywords.
- Retrieve all memories or those from a specific bucket.
Properties
| Name | Meaning |
|---|---|
| Memory Text | The text content of the memory to store. This is the main data saved as a memory entry. |
| Bucket ID | Optional identifier of the bucket to store the memory in or retrieve memories from. Buckets group related memories together. |
Output
The node outputs an array of JSON objects representing the memories retrieved or the result of storing a memory. Each item typically contains fields returned by the Memory Box API, such as the stored text and metadata like IDs or timestamps.
If the operation is "store," the output JSON contains the stored memory details confirming successful storage.
If the operation is "search," "getAll," or "getFromBucket," the output is a list of memory entries matching the query or criteria.
No binary data output is produced by this node.
Dependencies
- Requires an API key credential for authenticating with the Memory Box API.
- The node depends on internal helper functions to format memory text and make authenticated HTTP requests to the Memory Box service.
- No additional environment variables are explicitly required beyond the API credential.
Troubleshooting
Common issues:
- Missing or invalid API credentials will cause authentication failures.
- Providing an invalid or non-existent bucket ID may result in empty results or errors.
- Supplying empty or improperly formatted memory text when storing may cause validation errors.
Error messages:
- Errors from the API are propagated; typical messages include authentication errors, invalid parameters, or network issues.
- To resolve, verify API credentials, ensure required properties are set, and check network connectivity.
Links and References
- Memory Box API Documentation (replace with actual URL if available)
- n8n documentation on Creating Custom Nodes