Skip to main content
This example demonstrates how to set and manage session state for different users and sessions. It shows how session state can be passed during runs and persists across multiple interactions within the same session.
1

Create a Python file

change_state_on_run.py
    from agno.db.in_memory import InMemoryDb
    from agno.models.openai import OpenAIResponses
    from agno.team import Team

    team = Team(
        db=InMemoryDb(),
        model=OpenAIResponses(id="gpt-5.2"),
        members=[],
        instructions="Users name is {user_name} and age is {age}",
    )

    # Sets the session state for the session with the id "user_1_session_1"
    team.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"
    team.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"
    team.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"
team.print_response("How old am I?", session_id="user_2_session_1", user_id="user_2")
2

Set up your virtual environment

uv venv --python 3.12
source .venv/bin/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.
export OPENAI_API_KEY=sk-***
5

Run Team

python change_state_on_run.py