会话承载智能体的一次运行实例，全部消息、工具调用与状态变更以事件形式实时记录。
会话（Session）
会话是智能体的一次运行实例，承载多轮消息、工具调用与状态变更。控制台新建会话用于调试；生产环境通过 API 创建与驱动，详见 Session API。
新建会话
在智能体详情页点击新建会话，绑定运行环境（必选）后进入会话页面。创建时服务端快照当时的智能体配置，后续编辑智能体不影响已有会话。
通过 API 创建会话时，需绑定智能体与运行环境，服务端自动快照当前智能体配置。完整参数与响应字段详见创建 Session API。
绑定的环境配置了预装包时，需等待预热完成，准备中的环境无法创建会话，详见环境预热。
会话级配置与 MCP 请求头
创建会话时通过 agent 对象可覆盖本会话的系统提示词、工具、MCP Server 与技能，只传 id 则仅引用智能体；mcp_configs 为指定 MCP Server 的全部请求注入自定义 Header（如租户 ID、鉴权 token）。覆盖只作用于本会话，不改动智能体本身。
会话级配置目前仅支持通过 API 设置；控制台创建的会话为只读快照，在会话页面的智能体标签页查看。
会话页面布局
- 事件面板：实时展示当轮的处理过程。左上角下拉框可按类型筛选事件（All events / User / Agent / Tool / Tool_output / Error / Model / System）。
- 右侧标签页：智能体、环境、环境变量、记忆、文件、密钥库标签页，分别查看当前会话快照的配置；记忆展示会话挂载的记忆资源。
- 输入区：底部输入框输入消息，点击发送提交；处理中可点击中断停止当前轮。
挂载资源
在会话页面的资源区上传或挂载已有文件，智能体在工具调用中按 mount_path 读写。详见文件上传与挂载。运行时也可通过 API 动态挂载、查询与卸载文件资源，详见 Session API。
记忆库在创建会话时于资源区点击 + 挂载，配置记忆库、权限与说明；创建后不可新增、卸载或修改。详见记忆库。
归档与删除
会话支持归档和删除两种操作：
- 归档：状态变为
terminated（终态），事件历史保留可查。适用于已完成的会话。 - 删除：硬删除，会话元数据、事件历史、内部拷贝的资源全部清除，不可恢复。如需保留事件历史请改用归档。
下一步
- 管理会话：了解状态机、工具调用流程与归档删除。
- 会话事件流（SSE）：了解全部事件类型与 SSE 订阅。
- Session API：用 API 创建会话、发消息、订阅事件流。