The Sessions page (route /sessions, under the DATA section of the sidebar) lists agent runs that read or wrote to your tenant’s Cognee memory. Each session captures the observations, tool calls, tokens, and cost for one agent conversation. This page replaces the older combined Activity page.
The header shows a one-line summary of the selected time range — for example, Agent runs that wrote to your memory · 142 sessions · 96% success · $3.21. Aggregate stats (total sessions, success rate, and total spend in USD to two decimals) are pulled from GET /v1/sessions/stats?range=, and the list itself comes from GET /v1/sessions (paged).
Time range
A segmented control in the header filters sessions and stats by time range:
| Range | Window |
|---|
| 24h | Last 24 hours |
| 7d | Last 7 days |
| 30d | Last 30 days (default) |
| all | All sessions |
Sessions list
The page uses a two-pane layout. The left pane lists up to 100 sessions; the right pane shows the detail for the selected session.
Each row in the list shows:
- A colored status dot indicating the run state.
- A short session id.
- The last-activity or started date.
- The model used.
Status values and their colors:
| Status | Color |
|---|
completed | Green |
running | Purple |
failed | Red |
abandoned | Gray |
Session detail
Selecting a row loads the session from GET /v1/sessions/{session_id} into the right pane, which opens with a set of stat cards:
- Observations — Message count for the session.
- Tool calls — Number of tool invocations.
- Tokens — Tokens in plus tokens out.
- Cost — Spend in USD to four decimals (e.g.
$0.0123).
- Duration — Total run time.
Transcript
Below the stat cards, the transcript lists the session’s question-and-answer turns. Each turn is tagged either Recall (purple) or Remember (green):
- A turn is Recall when its question matches a recall trace — the agent read from memory.
- Otherwise the turn is a Remember — the agent wrote to memory.
Click a turn to expand it and reveal the answer, and use the copy-answer button to copy it. Each turn has feedback thumbs (positive or negative) and an optional feedback text field. When a session has more than two turns, an in-transcript search appears so you can filter turns.
A Tool invocations bar chart counts traces by function, so you can see which tools the agent used most. A Recent activity feed lists the latest traces, each with a green or red status dot, the function name, and either feedback or an error message.
How sessions get populated
Sessions appear when an agent calls POST /v1/recall (reads) and POST /v1/remember/entry (writes) with a consistent session_id.
Use a session id of the form agent name + a unix timestamp, and reuse it across the whole conversation so every recall and remember call lands in the same session.
session_id = f"support-agent-{int(time.time())}"
# read from memory
recall(session_id=session_id, query="What did the customer order?")
# write to memory
remember_entry(session_id=session_id, content="Customer requested a refund.")
search-ui-, so they are easy to distinguish from agent sessions in the list.
Empty state
When no sessions exist for the selected range, the page shows:
When an agent connects to Cognee and reads or writes memory, its session will appear here with tools used, observations, and cost.
To start sending data, connect an agent through the Integrations flow, which deep-links back here with a Go to Sessions → button.
Looking for chat conversations instead of agent runs? See the Search page, whose sessions carry the search-ui- prefix. 
