How to initialise session state when running agent with adk web

[gmyrianthous]

When running the agent with a runner, initialising the session state is straight forward:

session_service = ...

state = {
    # Session state
    'topic': 'not_started',

    # User state
    'user:profile': {
        'name': 'Giorgos', 
        'age': '31',
    },

    # App state
    'app:language': 'en',
    'app:version': '0.0.1',
}

session = awaite session_service.create_session(
    app_name='my_app',
    user_id='112233',
    state=state,
)

What is the easiest way to do this when running the agent via adk web?

[mmmartin-t]

You may try this adk web --session_db_url 'sqlite:///session.db'
google/adk-web#13 (comment)

[gmyrianthous]

Correct me if I'm mistaken, but this assumes that I have run the agent with a runner at least once, and created a session for user with id user, right?

[mmmartin-t]

I have used one DatabaseSessionService in a .py, then the database will be initiated.

The session does not need to manually setup. The adk web will help you to handle the logic.
You can click "+ New Session", it will directly create the session with id "user".

[EPastrana199]

If you're doing it from the web interface, you can click the three dots next to the text area, select the option, and load it. Now, if you want to do it over the REST API, make a POST to http://localhost:8000/apps/my_example_agent/users/user_123/sessions with a body containing the desired state, e.g., {"some_state": "some_value"}

[gmyrianthous]

Oh I see, that did the trick. Completely missed the three dots! Thanks!

[radzish]

I have a question how can I restore session that was exported using "Export current session" button in right top corner. When I click on 3 dots menu, I just see "Update state" option that opens dialog where I can paste json. I tried to paste json of that file that was exported and it looks like it just uploaded something, without restoring anything. My ADK version is 1.14.1.

[surajksharma07]

Glad the three-dots menu/REST API route sorted this out! @radzish on your export/restore question: that's actually expected. "Update state" only merges a flat state-delta dict while "Export current session" gives you a full session object (state, events, etc.) so pasting one into the other won't do anything. There's no proper import path for that today so worth its own issue if you'd like to see one added. Closing this out since the original question looks addressed above.