# Improve session recall accuracy

> The built-in session search tool has been upgraded from a single-pass lookup to a two-step process: the agent first calls search_past_sessions() to retrieve lightweight previews of recent sessions…

- Published: 2026-03-04
- Author: Agno Team
- Category: Changelog
- Canonical: https://agno-com-nine.vercel.app/articles/improve-session-recall-accuracy
- Markdown: https://agno-com-nine.vercel.app/articles/improve-session-recall-accuracy.md

The built-in session search tool has been upgraded from a single-pass lookup to a two-step process: the agent first calls `search_past_sessions()` to retrieve lightweight previews of recent sessions, then selectively fetches the full conversation for a specific session with `read_past_session(session_id)`.

This reduces unnecessary data loading and gives the agent a clearer, more structured path to locating relevant history.

Details**:**

- `search_past_sessions()` returns per-run previews across recent sessions without loading full message histories
- `read_past_session(session_id)` fetches the complete conversation for a targeted session on demand
- Control scope with `num_past_sessions_to_search` (default 20) and `num_past_session_runs_in_search` (default 3) to tune preview depth
- Session history is scoped per user — agents cannot surface another user's sessions
- Enable with `search_past_sessions=True` on the `Agent`; no other changes required

See [cookbook](https://github.com/agno-agi/agno/blob/main/cookbook/02_agents/05_state_and_session/search_session_history.py) for reference.