Skip to navigation
Build with ContextIngest

Threads

Understanding conversation threading in Zep

Overview

Threads represent a conversation. Each User can have multiple threads, and each thread is a sequence of chat messages.

Chat messages are added to threads using thread.add_messages, which adds the messages to the thread history and ingests them into the user’s Context Graph. The user Context Graph contains data from all of that user’s threads.

Relationship Between Users and Threads

threadIds 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 thread, make sure you have created a user first.

Automatic graph warming

When you create a new thread, Zep sends a warm-up request for the user’s Context Graph in the background. This request prepares the graph data for retrieval.

The operation runs asynchronously and does not block the thread creation response. Zep sends this request when you create a thread for a user with an existing graph.

For manual graph warming, see Warming the User Cache.

Next Steps

Now that you understand how Threads work, you can: