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