会话承载智能体的一次运行实例,全部消息、工具调用与状态变更以事件形式实时记录。
会话(Session)
会话是智能体的一次运行实例,承载多轮消息、工具调用与状态变更。控制台新建会话用于调试;生产环境通过 API 创建与驱动,详见 Session API。
新建会话
在智能体详情页点击新建会话,绑定运行环境(必选)后进入会话页面。创建时服务端快照当时的智能体配置,后续编辑智能体不影响已有会话。
通过 API 创建会话时,需绑定智能体与运行环境,服务端自动快照当前智能体配置。完整参数与响应字段详见 创建 Session API。
会话页面布局
- 事件面板:实时展示当轮的处理过程。左上角下拉框可按类型筛选事件(All events / User / Agent / Tool / Tool_output / Error / Model / System)。
- 右侧标签页:智能体、环境、凭证三个标签页,分别查看当前会话快照的配置。
- 输入区:底部输入框输入消息,点击发送提交;处理中可点击中断停止当前轮。
挂载文件
在会话页面的资源区上传或挂载已有文件,智能体在工具调用中按 mount_path 读写。详见 文件上传与挂载。
归档与删除
会话支持归档和删除两种操作:
- 归档:状态变为
terminated(终态),事件历史保留可查。适用于已完成的会话。 - 删除:硬删除,会话元数据、事件历史、内部拷贝的资源全部清除,不可恢复。如需保留事件历史请改用归档。
下一步
- 管理会话:了解状态机、工具调用流程与归档删除。
- 会话事件流(SSE):了解全部事件类型与 SSE 订阅。
- Session API:用 API 创建会话、发消息、订阅事件流。