Zep Memory v3Install

Summary

Manage and retrieve AI agent memory using Zep Cloud v3 by specifying the conversation thread and user IDs, optionally including recent chat messages and user context blocks (facts, summary, entities).

Inputs

• Thread ID (required) — The ID of the conversation thread to access or create. Can be a static string or an expression, for example, {{ $json.sessionId }}.
• User ID (required) — The unique identifier of the user involved in the conversation. Can be a static string or an expression, for example, {{ $json.userId }}.
• Context Window — Specifies the number of recent messages to include in the chat history returned to the AI agent. Setting to 0 means unlimited messages, which is not recommended. Defaults to 10.
• Use Context Block — Flag to determine whether to retrieve user context information like facts, summary, and entities from Zep. Defaults to true.

Output shape

An object containing 'context' (a string with user context block data) and 'chat_history' (an array of recent chat messages structured for AI agent memory).

The output includes filtered and validated messages limited by the 'Context Window' parameter. If the specified thread does not exist, the node will create the necessary user and thread records. Outputs are intended for use as AI memory inputs and are emitted on the 'ai_memory' output channel.