Sessions

Sessions represent a conversation. Each User can have multiple sessions, and each session is a sequence of chat messages.

Chat messages are added to sessions using memory.add, which both adds those messages to the session history and ingests those messages into the user-level knowledge graph. The user knowledge graph contains data from all of that user’s sessions to create an integrated understanding of the user.

Adding a Session

SessionIDs are arbitrary identifiers that you can map to relevant business objects in your app, such as users or a conversation a user might have with your app. Before you create a session, make sure you have created a user first. Then create a session with:

1
client = Zep(
2
    api_key=API_KEY,
3
)
4
session_id = uuid.uuid4().hex # A new session identifier
5
6
client.memory.add_session(
7
    session_id=session_id,
8
    user_id=user_id,
9
)

Getting a Session

1
session = client.memory.get_session(session_id)
2
print(session.dict())

Deleting a Session

Deleting a session deletes it and its associated messages. It does not however delete the associated data in the user’s knowledge graph. To remove data from the graph, see deleting data from the graph.

1
client.memory.delete(session_id)

Listing Sessions

You can list all Sessions in the Zep Memory Store with page_size and page_number parameters for pagination.

1
# List the first 10 Sessions
2
result = client.memory.list_sessions(page_size=10, page_number=1)
3
for session in result.sessions:
4
    print(session)