Skip to main content
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

uv venv --python 3.12
source .venv/bin/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