> ## Documentation Index
> Fetch the complete documentation index at: https://agno-v2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# State And Session

> Examples for session state management, chat history, and session persistence.

| Example | Description |
| - | - |
| [Agentic Session State](https://agno-v2.mintlify.site/examples/agents/state-and-session/agentic-session-state.md) | Let the agent update its own session\_state shopping list with enable\_agentic\_state. |
| [Chat History](https://agno-v2.mintlify.site/examples/agents/state-and-session/chat-history.md) | Persist chat history in Postgres and read it back with get\_chat\_history() between turns. |
| [Dynamic Session State](https://agno-v2.mintlify.site/examples/agents/state-and-session/dynamic-session-state.md) | Update session state inside a tool hook during an agent run. |
| [Last N Session Messages](https://agno-v2.mintlify.site/examples/agents/state-and-session/last-n-session-messages.md) | Search a user's previous sessions with search\_past\_sessions, capped at the last two by num\_past\_sessions\_to\_search. |
| [Persistent Session](https://agno-v2.mintlify.site/examples/agents/state-and-session/persistent-session.md) | Persist agent sessions in Postgres with a fixed session\_id so history carries across runs. |
| [Session Options](https://agno-v2.mintlify.site/examples/agents/state-and-session/session-options.md) | Simple example demonstrating store\_history\_messages option. |
| [Session State Advanced](https://agno-v2.mintlify.site/examples/agents/state-and-session/session-state-advanced.md) | Manage a shopping list in session\_state with tools that add, remove, and list items through RunContext. |
| [Session State Basic](https://agno-v2.mintlify.site/examples/agents/state-and-session/session-state-basic.md) | Maintain a shopping list in session state and update it from a tool through RunContext. |
| [Session State Events](https://agno-v2.mintlify.site/examples/agents/state-and-session/session-state-events.md) | Stream an agent run and read the final session state from RunCompletedEvent. |
| [Session State Manual Update](https://agno-v2.mintlify.site/examples/agents/state-and-session/session-state-manual-update.md) | Modify session state between runs with get\_session\_state() and update\_session\_state(). |
| [Session State Multiple Users](https://agno-v2.mintlify.site/examples/agents/state-and-session/session-state-multiple-users.md) | Maintain state for each user in a multi-user environment. |
| [Session Summary](https://agno-v2.mintlify.site/examples/agents/state-and-session/session-summary.md) | Use the session summary to store the conversation summary. |
| [Metadata Resolution](https://agno-v2.mintlify.site/examples/agents/state-and-session/metadata-resolution.md) | Demonstrates the three-layer metadata resolution for Agents: agent.metadata \< session.metadata \< call-site metadata. |
| [Search Past Sessions](https://agno-v2.mintlify.site/examples/agents/state-and-session/search-past-sessions.md) | Demonstrates the two-step list-then-read pattern for accessing previous sessions. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.