Skip to content

session.md

Latest commit

 

History

History
119 lines (78 loc) · 2.91 KB

session.md

File metadata and controls

119 lines (78 loc) · 2.91 KB
title Session
description Learn what AgentSession contains and how to create, restore, and serialize sessions.
zone_pivot_groups programming-languages
author eavanvalkenburg
ms.topic conceptual
ms.author edvan
ms.date 02/13/2026
ms.service agent-framework

Session

AgentSession is the conversation state container used across agent runs.

What AgentSession contains

:::zone pivot="programming-language-csharp"

Field Purpose
StateBag Arbitrary state container for this session

The C# AgentSession is an abstract base class. Concrete implementations (created via CreateSessionAsync()) may add additional state e.g. an id for remote chat history storage, when service-managed history is used.

:::zone-end

:::zone pivot="programming-language-python"

Field Purpose
session_id Local unique identifier for this session
service_session_id Remote service conversation identifier (when service-managed history is used)
state Mutable dictionary shared with context/history providers

:::zone-end

Built-in usage pattern

:::zone pivot="programming-language-csharp"

AgentSession session = await agent.CreateSessionAsync();

var first = await agent.RunAsync("My name is Alice.", session);
var second = await agent.RunAsync("What is my name?", session);

:::zone-end

:::zone pivot="programming-language-python"

session = agent.create_session()

first = await agent.run("My name is Alice.", session=session)
second = await agent.run("What is my name?", session=session)

:::zone-end

Creating a session from an existing service conversation ID

:::zone pivot="programming-language-csharp"

Create a new session from an existing conversation id varies by agent type. Here are some examples.

When using ChatClientAgent

AgentSession session = await chatClientAgent.CreateSessionAsync(conversationId);

When using an A2AAgent

AgentSession session = await a2aAgent.CreateSessionAsync(contextId, taskId);

:::zone-end

:::zone pivot="programming-language-python"

Use this when the backing service already has conversation state.

session = agent.get_session(service_session_id="<service-conversation-id>")
response = await agent.run("Continue this conversation.", session=session)

:::zone-end

Serialization and restoration

:::zone pivot="programming-language-csharp"

var serialized = agent.SerializeSession(session);
AgentSession resumed = await agent.DeserializeSessionAsync(serialized);

:::zone-end

:::zone pivot="programming-language-python"

serialized = session.to_dict()
resumed = AgentSession.from_dict(serialized)

:::zone-end

Important

Sessions are agent/service-specific. Reusing a session with a different agent configuration or provider can lead to invalid context.

Next steps

[!div class="nextstepaction"] Context Providers