AI agents for Zep

Find a user

Looks up a person by the ID your own system gives them (user_id) and returns Zep's record.

List threads

Lists conversation threads, newest first, optionally only one person's (user_uuid), each with its uuid and when it was made.

Get context for a thread

Returns, in context, a ready-to-use text block of what matters for the thread's latest messages: the relevant facts and entities from the person's knowledge graph with their dates.

Read a thread's messages

Returns a thread's messages, newest first by default, each with role, name, content and when it was said.

Search facts in a graph

Searches a knowledge graph (a person's, by their graph_uuid, or a shared one) for the facts most relevant to a question, like "Where does Jane work?".

Get context from a graph

Builds, in context, a text block of what a knowledge graph knows about a question (facts, entities, episodes and summaries), up to max_characters, for a person's graph or a shared one.

Create a user

Adds a person to Zep under the ID your own system gives them, with an optional name, email and metadata, and creates their knowledge graph.

Start a thread

Starts a conversation thread for a person (by the user's Zep uuid from find_user or create_user).

Add messages to a thread

Saves new messages of a conversation to a thread; Zep learns facts about the person from them in the background (a task follows it).

Add data to a graph

Adds text, a JSON record or a chat message to a knowledge graph (a person's, by graph_uuid, or a shared one), from which Zep extracts entities and facts in the background.