文档中心

AgentKit

会话管理

会话管理概述

会话管理（Sessions Store）是 AgentKit 提供的短期记忆管理能力，用于在多轮对话中存储和读取会话上下文。通过会话管理，Agent 可以将用户与智能体之间的多轮交互记录持久化到指定数据库中，在后续请求中继续读取历史上下文，提升对话连续性。

功能介绍

AgentKit 会话管理支持接入火山引擎关系型数据库资源，包括 Serverless PostgreSQL、RDS PostgreSQL 和 RDS MySQL。您可以在 AgentKit 控制台中创建或导入会话资源，并将其关联到智能体运行时，供 Agent 代码读取和使用。

数据库类型	说明	适用场景
Serverless PostgreSQL	火山引擎提供的 Serverless 架构 PostgreSQL 数据库服务，支持资源弹性伸缩和按需使用。	访问压力较小、负载波动明显，或希望减少数据库运维成本的场景。
RDS PostgreSQL	火山引擎基于开源 PostgreSQL 提供的在线关系型数据库服务，适合承载稳定的业务数据读写。	访问压力较高、数据量较大，或需要使用固定数据库实例的场景。
RDS MySQL	火山引擎基于开源 MySQL 提供的在线关系型数据库服务。	已有 MySQL 使用经验，或希望复用 MySQL 数据库资源的场景。

通过会话管理，您可以：

将多轮对话上下文保存到指定数据库中。

使用 SessionID 区分不同用户或不同对话，避免上下文混用。

在服务重启、多实例部署或请求切换到不同运行节点时，继续读取同一会话的历史上下文。

将会话存储资源与智能体运行时关联，由平台注入数据库连接所需的环境变量，减少在业务代码中硬编码连接信息。

工作原理

会话管理通过 SessionID 标识一条对话会话，并将该会话中的多轮交互上下文写入指定的会话资源。后续请求携带相同 SessionID 时，Agent 可以读取对应历史上下文，并基于历史信息生成连续回复。

在典型调用链路中，请求会依次经过以下组件：

用户端/应用 → 智能体运行时（Runtime）→ Agent 业务代码 → 会话管理 → 会话资源数据库

整体运行机制如下：

用户端发起对话请求，携带用于标识本次对话的 SessionID。

请求进入智能体运行时。如果运行时已关联会话资源，平台会向运行时注入数据库连接所需的环境变量。

Agent 业务代码根据 SessionID 读取该会话已保存的历史上下文。

Agent 将历史上下文与本轮用户输入一并传入模型，生成本轮回复。

本轮交互完成后，会话管理将用户输入、Agent 回复及相关临时状态写入会话资源数据库。

后续请求携带相同 SessionID 时，Agent 继续读取历史上下文，实现多轮对话连续。

不同用户或不同业务会话使用不同 SessionID 时，各自读写对应数据，避免上下文混用。

核心能力与价值

保持多轮对话连续性

会话管理将同一 SessionID 下的历史对话写入数据库，并在后续请求中读取使用。即使服务重启或运行节点切换，也可基于同一会话恢复上下文，减少多轮交互中的信息丢失。

降低会话存储接入成本

AgentKit 对会话存储资源提供统一管理能力：

创建资源：当前支持在控制台创建 Serverless PostgreSQL 类型的会话资源。

导入资源：支持导入已有的 Serverless PostgreSQL、RDS PostgreSQL 和 RDS MySQL 资源。

运行时关联：关联后平台自动向运行时注入数据库连接环境变量，减少在代码中明文配置数据库地址、账号或密码的需求。

支持业务数据自主维护

会话数据存储在您选择的数据库资源中，权限、备份、加密、审计和清理策略均可基于数据库自身能力配置，满足业务的数据管理要求。

适配多环境和多业务隔离

不同业务、不同环境可以使用不同的会话资源，降低数据混用风险，便于权限控制和运维管理。建议为不同用户、不同业务会话生成独立的 SessionID。

基本概念

概念	说明
会话管理（Sessions Store）	AgentKit 提供的短期记忆管理能力，用于存储和读取多轮对话中的短期上下文。
会话资源	在 AgentKit 中创建或导入的数据库资源，用于承载会话上下文数据。当前支持 Serverless PostgreSQL、RDS PostgreSQL 和 RDS MySQL。
SessionID	会话唯一标识，用于区分不同用户或不同对话。AgentKit 根据 SessionID 读取和写入对应会话的上下文。
短期上下文	同一会话中的多轮交互信息，例如用户输入、Agent 回复以及与本轮会话相关的临时状态，作用范围限定在当前会话内。
智能体运行时（Runtime）	Agent 的云上运行环境。会话资源关联到运行时后，平台可向运行时注入数据库连接所需的环境变量。
记忆库	存储跨会话的长期记忆信息，与会话管理的短期上下文能力相互独立。
知识库	存储和检索企业文档、业务资料等知识内容，面向 RAG 场景，与会话管理的短期上下文存储能力不同。

数据存储边界

会话管理、记忆库和知识库分别解决不同类型的数据存储问题，三者存储内容和生命周期不同，建议根据业务目标选择对应能力。

模块	存储内容	生命周期
会话管理	单次会话的多轮问答记录、SessionID、与会话相关的临时状态。	通常与会话生命周期绑定，具体以产品配置或数据库侧配置为准。
记忆库	跨会话的长期记忆信息，例如用户偏好、长期档案。	与会话生命周期无关，需按记忆库能力管理或删除。
知识库	企业文档、业务资料、向量索引等知识内容。	与会话生命周期无关，按知识库文档管理策略维护。

适用场景

场景	判断依据	会话管理作用
多轮连续对话	用户需要在多轮交流中持续引用前文信息。	存储并读取历史上下文，提升对话连续性。
多实例部署的 AI 应用	应用部署在多个运行节点，请求可能被转发到不同节点。	使用统一数据库保存会话数据，减少节点切换导致的上下文丢失。
需要自主维护会话数据的业务	业务需要自行管理权限、备份、审计或清理策略。	会话上下文保存到指定数据库资源中，便于业务侧维护。
轻量化快速上线智能体	希望减少数据库运维工作，具备弹性使用诉求。	选择 Serverless PostgreSQL 承载会话数据，降低资源准备和运维成本。
复用已有数据库资源	已有Serverless PostgreSQL、 RDS PostgreSQL 或 RDS MySQL，希望继续使用现有数据库体系。	将已有数据库资源导入 AgentKit，作为会话资源使用。

操作流程

创建或导入会话资源：在 AgentKit 控制台新建或导入会话资源，用于读写多轮对话的短期上下文。

在 Agent 代码中集成会话管理能力：使用 SessionID 读写上下文。

（可选）本地调试：使用相同 SessionID 进行多轮测试，确认上下文可正确保存和读取。

部署到生产环境：将 Agent 部署到智能体运行时，使用会话资源承载生产会话数据。

关联到智能体运行时：在智能体运行时关联组件页面关联会话资源，关联后平台自动注入数据库连接环境变量及调用组件能力。

发布运行时：关联到智能体运行时后，还需要手动发布智能体，才能使新配置生效。

最近更新时间：2026.10.09 16:47:49

这个页面对您有帮助吗？

有用

无用