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

The "Get Memory Context" operation of the Zep AI node retrieves relevant conversational context stored in memory for a specified session. This allows users to fetch accumulated conversation data, including contextual information, facts, and entities associated with a unique session ID.

This operation is beneficial in scenarios where an application needs to maintain or recall the state of a conversation over time, such as chatbots, virtual assistants, or any AI-driven system that requires continuity in interactions. For example, a customer support bot can use this to retrieve previous conversation context to provide more personalized and coherent responses.

Properties

Name Meaning
Session ID Unique identifier for the conversation session (e.g., "session-abc123"). Required to specify which session's memory context to retrieve.

Output

The output JSON object contains the following fields:

  • sessionId: The session ID used to retrieve the memory context.
  • context: A string representing the relevant conversation context retrieved from memory.
  • facts: An array of fact objects related to the session's memory.
  • entities: An array of entity objects associated with the session.
  • response: The full raw response returned by the API call, containing all available data.

This output provides structured access to the conversation's memory context, useful for further processing or decision-making in workflows.

Dependencies

  • Requires an API key credential for authenticating requests to the Zep AI service.
  • The node makes HTTP requests to the base URL https://api.getzep.com.
  • Proper configuration of the API authentication credential within n8n is necessary.

Troubleshooting

  • Common Issues:

    • Invalid or missing Session ID will result in failure to retrieve context.
    • Network connectivity issues may prevent successful API calls.
    • Expired or incorrect API credentials will cause authentication errors.

  • Error Messages:

    • "Unknown operation": Indicates the selected operation is not supported; ensure "Get Memory Context" is chosen.
    • API errors related to authentication or invalid parameters will be returned from the Zep API and surfaced by the node.

  • Resolution Tips:

    • Verify the Session ID is correct and corresponds to an existing session.
    • Check API key validity and permissions.
    • Ensure network access to https://api.getzep.com is allowed.
    • Enable "Continue On Fail" in the node settings to handle errors gracefully during execution.

Links and References

Discussion