Zep AI icon

Zep AI

AI Tool for interacting with Zep memory and knowledge graph. Provides operations to store/retrieve conversation memory, search knowledge graphs, and manage user context.

Actions9

Add Memory

AI-generated

Overview

This node integrates with the Zep AI platform to manage conversational memory and knowledge graphs. Specifically, the "Add Memory" operation allows users to add conversation messages to a session's memory store on Zep. This is useful for applications that require persistent conversational context, such as chatbots, virtual assistants, or any system that needs to remember past interactions within a session.

For example, a chatbot can use this node to save user and assistant messages during a conversation, enabling more coherent and context-aware responses later in the session.

Properties

Name Meaning
Session ID Unique identifier for the conversation session (e.g., "session-abc123").
Messages Collection of messages to add to memory. Each message includes:
- Role: The role of the message sender (string, e.g., "user", "assistant", "system").
- Role Type: The type of role, selectable from options: User, Assistant, System.
- Content: The actual text content of the message (required).

Output

The output JSON object contains:

  • success: Boolean indicating if the operation was successful.
  • sessionId: The session ID to which messages were added.
  • messagesAdded: Number of messages successfully added.
  • response: The full response returned by the Zep API after adding the memory.

No binary data is output by this operation.

Dependencies

  • Requires an API key credential for authenticating requests to the Zep AI platform.
  • The node makes HTTP POST requests to the Zep API endpoint https://api.getzep.com/api/v2/memory/{sessionId}.
  • Proper configuration of the API key credential in n8n is necessary for authentication.

Troubleshooting

  • Common issues:

    • Missing or invalid Session ID will cause the API call to fail.
    • Providing no messages or empty message content may result in errors or no data being stored.
    • Network connectivity issues or incorrect API credentials will prevent successful communication with the Zep API.

  • Error messages:

    • "Unknown operation: addMemory": Indicates the operation parameter is not set correctly; ensure "Add Memory" is selected.
    • API errors related to authentication typically indicate missing or invalid API keys.
    • JSON parsing errors are unlikely here since input is structured, but malformed inputs in other operations could cause issues.

  • Resolution tips:

    • Verify the Session ID is correctly provided and matches the expected format.
    • Ensure each message has non-empty content.
    • Confirm the API key credential is valid and properly configured in n8n.
    • Check network access to https://api.getzep.com.

Links and References

Discussion