State in Instructions

Use session state variables directly in team instructions with template syntax. The values are injected into the instructions automatically, so the team can use them during execution.

Create a Python file

session_state_in_instructions.py

from agno.team.team import Team

team = Team(
    members=[],
    # Initialize the session state with a variable
    session_state={"user_name": "John"},
    instructions="Users name is {user_name}",
    markdown=True,
)

team.print_response("What is my name?", stream=True)

Set up your virtual environment

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

uv venv --python 3.12
.venv\Scripts\activate

Install dependencies

uv pip install -U agno openai

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-***

setx OPENAI_API_KEY sk-***

Run Team

python session_state_in_instructions.py

Change State on Run Share Interactions

⌘I

Get Started

Basics

Advanced

Production

Providers

Other

Additional Resources

State in Instructions

Set OpenAI Key

​Set OpenAI Key

Set OpenAI Key