Chat History
Demonstrates retrieving chat history and limiting included history messages.
"""
Chat History
=============================
Demonstrates retrieving chat history and limiting included history messages.
"""
from agno.agent import Agent
from agno.db.postgres import PostgresDb
from agno.models.openai import OpenAIResponses
from agno.team import Team
# ---------------------------------------------------------------------------
# Setup
# ---------------------------------------------------------------------------
db_url = "postgresql+psycopg://ai:ai@localhost:5532/ai"
db = PostgresDb(db_url=db_url, session_table="sessions")
# ---------------------------------------------------------------------------
# Create Members
# ---------------------------------------------------------------------------
agent = Agent(model=OpenAIResponses(id="gpt-5-mini"))
# ---------------------------------------------------------------------------
# Create Team
# ---------------------------------------------------------------------------
history_team = Team(
model=OpenAIResponses(id="gpt-5-mini"),
members=[agent],
db=db,
)
limited_history_team = Team(
model=OpenAIResponses(id="gpt-5.2"),
members=[Agent(model=OpenAIResponses(id="gpt-5.2"))],
db=db,
add_history_to_context=True,
num_history_messages=1,
)
# ---------------------------------------------------------------------------
# Run Team
# ---------------------------------------------------------------------------
if __name__ == "__main__":
history_team.print_response("Tell me a new interesting fact about space")
print(history_team.get_chat_history())
history_team.print_response("Tell me a new interesting fact about oceans")
print(history_team.get_chat_history())
limited_history_team.print_response("Tell me a new interesting fact about space")
limited_history_team.print_response(
"Repeat the last message, but make it much more concise"
)Stored history and model context
get_chat_history() reads stored messages even when history injection is disabled. Only limited_history_team enables add_history_to_context here. Its num_history_messages=1 includes the last eligible history message, not a full user/assistant exchange; tool-result messages without their preceding tool call are removed.
Run the Example
Set up your virtual environment
uv venv --python 3.12
source .venv/bin/activateInstall dependencies
uv pip install -U agno "psycopg[binary]" openai sqlalchemyExport your OpenAI API key
export OPENAI_API_KEY="your_openai_api_key_here"Run PgVector
docker run -d \
-e POSTGRES_DB=ai \
-e POSTGRES_USER=ai \
-e POSTGRES_PASSWORD=ai \
-e PGDATA=/var/lib/postgresql \
-v pgvolume:/var/lib/postgresql \
-p 5532:5432 \
--name pgvector \
agnohq/pgvector:18Run the example
Save the code above as chat_history.py, then run:
python chat_history.pyFull source: cookbook/03_teams/07_session/chat_history.py