Migrating to Zep’s Graph Memory

With the introduction of Zep 1.0, many substantial changes are coming to the Zep engine and Zep APIs. Zep memory is now powered by our open source dynamic knowledge graph builder, Graphiti. However, no direct use of Graphiti is required in Zep, as we provide all allowed graph endpoints as part of the Zep API.

How to become a graph-enabled user?

All new accounts created with Zep will automatically be graph-enabled users. Furthermore, all free-tier legacy users are currently having their data migrated to the new graph-based memory. Once this process is complete, we will enable the graph-based memory for the free-tier users as well. Finally, all paid users will be migrated to using graph-based memory by the end of the year. If you are a paid customer and wish to opt-in to the graph-based memory sooner, please contact us.

Do I need to manually migrate my data?

No, we will handle all data migration for you.

What functionality is being deprecated?

The documentation has been updated to reflect the new functionality, so you can find more information about the changes in the API in the relevant section.

Here is a list of the deprecated functionality:

  • Creating custom facts
  • Customizing Fact Generation
  • The Collections endpoints
  • JSON path filtering in our search API
  • The get_session_facts endpoint

get_session_facts has been replaced by user.get_facts for graph-based users as facts will no longer be stored on the sessions going forward.

What is changing with the sessions API?

As mentioned before, get_session_facts will not be available for graph-based users. In addition, the search sessions API will not support the summary scope for graph-based users. Searching sessions for graph-based users will now only work with a user id, as facts are no longer stored on sessions.

Since session facts are being deprecated, adding facts to the session will no longer work.

What else won’t be available for graph-based users on launch?

Finally, the delete fact by uuid endpoint will not be available for graph-based users on launch, but we are working to make this and other graph-based functionality available soon.

Where can I learn about the new graph functionality?

The best place to start learning about the new graph functionality is the Understanding the Graph page. After that, going through the rest of our documentation will be helpful as it has been updated with information on the graph.