Key concepts

Agent memory, Context Graphs, and the Context Lake

Use the quick start guide to build an integration.

Zep delivers agent memory at enterprise scale. Zep builds a Context Graph from chat messages, business data, documents, and JSON.

A Context Graph is a temporal knowledge graph of entities, relationships, and facts for a user or subject. Zep retrieves selected graph data from a governed Context Lake.

Flex Plus and Enterprise accounts can also use Observations.

Governance controls account management and agent access to context.

ConceptDescriptionDocs
Context GraphZep’s temporal Context Graph is the unit of agent memory. Nodes are entities, and edges are facts or relationships. The graph updates as new data arrives.Docs
Zep’s Context BlockAn assembled string that contains relevant context types from a user’s Context Graph.Docs
Context TypesThe distinct primitives Zep produces from a user graph: facts, entities, episodes, thread summaries, observations, and user summary. Choose the type that fits the agent’s task.Docs
Fact InvalidationWhen new data invalidates a prior fact, the time the fact became invalid is stored on that fact’s edge in the Context Graph.Docs
JSON, text, and messageData types that you can ingest into a Context Graph.Docs
Custom Entity/Edge TypesFeature allowing use of Pydantic-like classes to customize creation/retrieval of entities and relations in the Context Graph.Docs
GraphRepresents a standalone Context Graph for storing up-to-date knowledge about an object or system. For storing up-to-date knowledge about a user, a user graph should be used.Docs
User graphA Context Graph that stores context for one application user.Docs
UserA Zep representation of an application user. Each user has a user graph and thread history.Docs
ThreadsConversation threads of a user. By default, all messages added to any thread of that user are ingested into that user’s graph.Docs
DocumentsGrouping for episodes of the same source on a graph. Pass document_id when ingesting chunks of a PDF, export, or channel.Docs
graph.add and thread.add_messagesMethods that add business data and chat messages, respectively.Business data Messages
graph.search & thread.get_user_contextLow level and high level methods respectively for retrieving from the Context Graph.Docs Docs
User summary instructionsUp to five instructions that specify how Zep generates a user summary.Docs
Debug modeTime-limited project mode for capturing per-episode workflow logs. Flex, Flex Plus, and Enterprise accounts also capture LLM reasoning traces for selected ingestion steps.Docs
Agent toolA tool that lets an agent retrieve information from a Context Graph.Docs