会话承载智能体的一次运行实例，全部消息、工具调用与状态变更以事件形式实时记录。
会话（Session）
会话是智能体的一次运行实例，承载多轮消息、工具调用与状态变更。控制台新建会话用于调试；生产环境通过 API 创建与驱动，详见 创建 Session API。
新建会话
在智能体详情页点击新建会话，按需选择运行环境，可按名称/值逐行填写环境变量（注入会话运行时，代码中直接按名读取），完成后进入会话页面。密钥类取值建议改用密钥库：容器内仅存放占位符，真实值由网关在出网时替换，区别详见密钥库认证。创建时服务端快照当时的智能体配置，后续编辑智能体不影响已有会话。
通过 API 创建会话时，需绑定智能体与运行环境，服务端自动快照当前智能体配置。完整参数与响应字段详见 创建 Session API。
会话页面布局
- 事件面板：实时展示当轮的处理过程。左上角下拉框可按类型筛选事件（All events / User / Agent / Tool / Tool_output / Error / Model / System）。
- 右侧标签页：智能体、环境、环境变量、文件、密钥库五个标签页，分别查看当前会话快照的配置；环境变量展示创建时注入的环境变量。
- 输入区：底部输入框输入消息，点击发送提交；处理中可点击中断停止当前轮。
挂载文件
在会话页面的资源区上传或挂载已有文件，智能体在工具调用中按 mount_path 读写。详见 文件上传与挂载。运行时也可通过 API 动态挂载、查询与卸载资源，详见 运行时挂载资源 API。
归档与删除
会话支持归档和删除两种操作：
- 归档：状态变为
terminated（终态），事件历史保留可查。适用于已完成的会话。 - 删除：硬删除，会话元数据、事件历史、内部拷贝的资源全部清除，不可恢复。如需保留事件历史请改用归档。
下一步
- 管理会话：了解状态机、工具调用流程与归档删除。
- 会话事件流（SSE）：了解全部事件类型与 SSE 订阅。
- 创建 Session API：用 API 创建会话、发消息、订阅事件流。