Recallio icon

Recallio

Interact with RecallioAI memory API

Actions5

Overview

This node integrates with the RecallioAI memory API to manage and export user memory data. Specifically, the Export Memory operation allows users to export stored memories or graph data associated with a particular user within a specified date range and in a chosen format (JSON or CSV). This is useful for scenarios such as backing up user data, analyzing memory content externally, or migrating data between systems.

Practical examples include:

  • Exporting all memory entries of a user for audit or review.
  • Extracting graph-related data for visualization or further processing.
  • Filtering exported data by date range to focus on specific periods.

Properties

Name Meaning
User ID The unique identifier of the user whose memory data will be exported.
Export Type The type of data to export: either "Memory" (raw memory entries) or "Graph" (graph structure).
Export Format The file format for the exported data: JSON or CSV.
Start Date (Optional) The start date/time to filter exported data from.
End Date (Optional) The end date/time to filter exported data until.

Output

The output contains a single field exportData inside the json object. This field holds the exported memory or graph data returned by the RecallioAI API. The structure of this data depends on the selected export type and format:

  • For JSON format, it will be a JSON object or array representing the exported content.
  • For CSV format, it will be a CSV string representing the exported data.

No binary data output is produced by this operation.

Example output JSON structure:

{
  "exportData": { /* exported memory or graph data */ }
}

Dependencies

  • Requires an API key credential for authenticating with the RecallioAI memory API.
  • Uses the RecallioClient library internally to communicate with the RecallioAI service.
  • The node expects network access to RecallioAI endpoints.

Troubleshooting

  • Common issues:

    • Invalid or missing API key credential will cause authentication failures.
    • Providing an invalid user ID may result in empty or error responses.
    • Incorrect date formats or ranges might lead to no data being exported.
    • Selecting unsupported combinations of export type and format could cause errors.

  • Error messages:

    • Errors thrown by the RecallioAI API are propagated; check the message for details.
    • If the operation parameter is incorrect or missing, the node throws an "Unknown operation" error.

  • Resolutions:

    • Ensure the API key credential is correctly configured and valid.
    • Verify that the user ID exists and has associated memory data.
    • Use valid ISO date-time strings for start and end dates.
    • Confirm that export type and format options are correctly set.

Links and References

Discussion