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

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