Change State on Run

This example demonstrates how to manage session state across different runs for different users. It shows how session state persists within the same session but is isolated between different sessions and users.

1. Create a Python file

   change_state_on_run.py

   from agno.agent import Agent
   from agno.db.in_memory import InMemoryDb
   from agno.models.openai import OpenAIResponses
   
   agent = Agent(
       db=InMemoryDb(),
       model=OpenAIResponses(id="gpt-5.2"),
       instructions="Users name is {user_name} and age is {age}",
       debug_mode=True,
   )
   
   # Sets the session state for the session with the id "user_1_session_1"
   agent.print_response(
       "What is my name?",
       session_id="user_1_session_1",
       user_id="user_1",
       session_state={"user_name": "John", "age": 30},
   )
   
   # Will load the session state from the session with the id "user_1_session_1"
   agent.print_response("How old am I?", session_id="user_1_session_1", user_id="user_1")
   
   # Sets the session state for the session with the id "user_2_session_1"
   agent.print_response(
       "What is my name?",
       session_id="user_2_session_1",
       user_id="user_2",
       session_state={"user_name": "Jane", "age": 25},
   )
   
   # Will load the session state from the session with the id "user_2_session_1"
   agent.print_response("How old am I?", session_id="user_2_session_1", user_id="user_2")
   
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

   Set OpenAI Key

   Set your OPENAI_API_KEY as an environment variable. You can get one from OpenAI.

   Mac

   export OPENAI_API_KEY=sk-***
   

   setx OPENAI_API_KEY sk-***
   
5. Run Agent

   python change_state_on_run.py