How to reference user state in prompt

[gmyrianthous]

According to the documentation, prefixes are used to determine the scope of keys.

Assuming we have a key in a state called topic, we can reference it in the prompt using {topic}.

from google.adk.agents import LlmAgent

story_generator = LlmAgent(
    name="StoryGenerator",
    model="gemini-2.0-flash",
    instruction="""Write a short story about a cat, focusing on the theme: {topic}."""
)

Now let's assume we have a key called first_name which is prefixed with the user: prefix, since it should be applicable to all sessions of a user.
In the case how can we reference user's first name in the prompt? I couldn't find something similar neither in the documentation nor in any of the tutorials/examples?

[gmyrianthous]

Found the answer, sharing it here in case anyone is wondering.

You can retrieve it by referencing {user:first_name}.

---

Assuming you have nested structures within user: prefix, for instance: {'user_profile': {'name': 'Giorgos', 'age': '31'}}
You can retrieve the name using {user:user_profile:name}