Persistent Session with History Context

This example shows how to use the session history to store conversation history and add it to the context with configurable history limits.

Code

persistent_session_history.py

"""
This example shows how to use the session history to store the conversation history.
add_history_to_context flag is used to add the history to the messages.
num_history_runs is used to set the number of history runs to add to the messages.
"""

from agno.agent import Agent
from agno.db.postgres import PostgresDb
from agno.models.openai import OpenAIResponses
from agno.team import Team

db_url = "postgresql+psycopg://ai:ai@localhost:5532/ai"

db = PostgresDb(db_url=db_url, session_table="sessions")

agent = Agent(model=OpenAIResponses(id="gpt-5.2"))

team = Team(
    model=OpenAIResponses(id="gpt-5.2"),
    members=[agent],
    db=db,
    add_history_to_context=True,
    num_history_runs=2,
)

team.print_response("Tell me a new interesting fact about space")

Usage

1. Set up your virtual environment

   Mac

   uv venv --python 3.12
   source .venv/bin/activate
   

   uv venv --python 3.12
   .venv\Scripts\activate
   
2. Install required libraries

   uv pip install agno psycopg2-binary
   
3. Set environment variables

   export OPENAI_API_KEY=****
   
4. Start PostgreSQL database

   cookbook/run_pgvector.sh
   
5. Run the agent

   python persistent_session_history.py