Session

C# AgentSession は抽象基本クラスです。 具体的な実装 ( CreateSessionAsync() を使用して作成) では、サービス管理の履歴が使用されている場合に、リモート チャット履歴ストレージの ID など、追加の状態が追加される場合があります。

セッションでは、型指定されたキー値ストレージが提供されます。

type UserPrefs struct {
    Theme    string `json:"theme"`
    Language string `json:"language"`
}

session.Set("user_prefs", UserPrefs{Theme: "dark", Language: "en"})

var prefs UserPrefs
session.Get("user_prefs", &prefs)

session.Delete("user_prefs")

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);

session = agent.create_session()

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

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

resp, _ := a.RunText(ctx, "Hello!", agent.WithSession(session)).Collect()
resp, _ = a.RunText(ctx, "Follow-up question.", agent.WithSession(session)).Collect()

既存の会話 ID から新しいセッションを作成する方法は、エージェントの種類によって異なります。 いくつかの例を次に示します。

ChatClientAgentを使用する場合

AgentSession session = await chatClientAgent.CreateSessionAsync(conversationId);

A2AAgent を使用する場合は、

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

これは、バッキング サービスに既に会話状態がある場合に使用します。

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

ホストされているアプリで、現在のユーザーまたはテナントを確認した後、アプリケーション所有のストレージから <service-conversation-id> を解決します。 最初に呼び出し元が会話を所有していることを確認しない限り、クライアントから生のサービス側 ID を受け入れないようにします。

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

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

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

// Save to disk, database, etc.
if err := os.WriteFile("session.json", data, 0o644); err != nil {
    panic(err)
}

// Later, restore the session.
loaded, err := os.ReadFile("session.json")
if err != nil {
    panic(err)
}

var resumedSession agent.Session
if err := json.Unmarshal(loaded, &resumedSession); err != nil {
    panic(err)
}

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