Conversations & Memory overview

1. Create a session (CreateSessionAsync())
2. Pass that session to each RunAsync(...)
3. Rehydrate from serialized state (DeserializeSessionAsync(...))
4. Continue with a service conversation ID (varies by agent, e.g. myChatClientAgent.CreateSessionAsync("existing-id"))

1. Create a session (create_session())
2. Pass that session to each run(...)
3. Rehydrate by service conversation ID (get_session(...)) or from serialized state

1. Create a session (CreateSession(...))
2. Pass that session to each RunText(...) with agent.WithSession(session)
3. Rehydrate from serialized state with json.Unmarshal(...) into agent.Session

The Go agent package provides the core types for conversation state: agent.Session for key-value state tied to a conversation and agent.ContextProvider for context injection and persistence.

// Create and reuse a session
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);

// Persist and restore later
var serialized = agent.SerializeSession(session);
AgentSession resumed = await agent.DeserializeSessionAsync(serialized);

# Create and reuse a session
session = agent.create_session()

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

# Rehydrate by service conversation ID when needed
service_session = agent.get_session(service_session_id="<service-conversation-id>")

# Persist and restore later
serialized = session.to_dict()
resumed = AgentSession.from_dict(serialized)

session, err := a.CreateSession(ctx)
if err != nil {
    panic(err)
}

Use a session for multi-turn conversations

resp, _ := a.RunText(ctx, "My name is Alice.", agent.WithSession(session)).Collect()
resp, _ = a.RunText(ctx, "What is my name?", agent.WithSession(session)).Collect()

Persist sessions

Sessions can be serialized to JSON for storage and later resumed:

data, err := json.Marshal(session)
if err != nil {
    panic(err)
}
// store data...

// later:
var resumed agent.Session
if err := json.Unmarshal(data, &resumed); err != nil {
    panic(err)
}

resp, err := a.RunText(ctx, "Continue from where we left off.", agent.WithSession(&resumed)).Collect()