Chat History

This example demonstrates how to manage and retrieve chat history in agent conversations, enabling access to previous conversation messages and context.

Code

chat_history.py

from agno.agent import Agent
from agno.db.sqlite import SqliteDb
from agno.models.openai import OpenAIResponses

db = SqliteDb(db_file="tmp/agent.db")

agent = Agent(
    model=OpenAIResponses(id="gpt-5.2"),
    db=db,
    session_id="chat_history",
    instructions="You are a helpful assistant that can answer questions about space and oceans.",
    add_history_to_context=True,
)

agent.print_response("Tell me a new interesting fact about space", stream=True)
print(agent.get_chat_history())

agent.print_response("Tell me a new interesting fact about oceans", stream=True)
print(agent.get_chat_history())

Usage

1. Create a Python file

   Create chat_history.py with the code above.

2. Set up your virtual environment

   Mac

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

   uv venv --python 3.12
   .venv\Scripts\activate
   
3. Install dependencies

   uv pip install -U agno openai
   
4. Export your OpenAI API key

   Mac/Linux

   export OPENAI_API_KEY="your_openai_api_key_here"
   

   $Env:OPENAI_API_KEY="your_openai_api_key_here"
   
5. Run Agent

   python chat_history.py