会话记录

简述

会话记录汇总某一 Agent 下产生的对话会话：支持按状态、来源、会话标识与用户标识筛选，分页浏览每条会话的开始时间、轮次与来源徽章。点击表格行可在右侧打开会话日志详情抽屉，按轮次查看访客提问、模型思考片段、工具调用摘要与助手答复正文，并在侧栏查看时长、Token 统计等信息，便于排查质量问题或核对调用成本。

功能位置

在 Agent 详情左侧二级菜单打开 会话记录，页面下方为筛选栏与数据表格。

配置与规则

筛选栏

• 全部状态下拉可选进行中、已结束，或保留「全部」不做状态过滤。
• 全部来源下拉可选对话窗口、API，或保留「全部」。列表中的来源徽章还支持展示嵌入式等其它渠道文案；若需定位嵌入式会话，可结合会话 ID 或搜索用户输入框检索。
• 会话 ID 筛选框占位为「会话 ID」，输入会做短暂防抖后再请求列表，便于粘贴完整外部会话编号。
• 搜索用户筛选框占位为「搜索用户」，对应会话侧的用户标识字段；同样带防抖。

会话日志抽屉

点击任意数据行打开抽屉，标题为会话日志详情。点击遮罩或右上角关闭图标收起；键盘 Esc 亦可关闭。

• 思考：可折叠块，展开后展示思考正文；条目中检视图标用于打开 LLM 请求/响应 明细弹窗。
• 工具调用：单行摘要展示工具简述或「使用工具：{名称}」；失败时出现错误徽章；可通过条目右侧检视图标跳转到关联的 LLM 调用详情。
• 助手答复：Markdown 预览区域。底部展示时间与可选 Token 汇总，并提供答复正文复制与 LLM 明细入口。

右侧会话信息卡片列出会话 ID（可复制）、用户标识、状态、来源、开始时间、持续时长、轮数、LLM 调用、工具调用、输入 Token、输出 Token、总 Token。

LLM 请求/响应 明细通过检视图标打开专用弹窗查看。

注意事项

• Token 与时长统计依赖服务端汇总字段，用于横向对比不同会话成本；若某轮调试中出现中断，时间线与徽章仍以服务端落库结果为准。
• 搜索用户匹配的是外部用户标识；若接入方未上报该字段，表格中会显示「—」。
• 列表筛选中的来源下拉目前包含对话窗口与 API；嵌入式等方式产生的会话仍会在表格列出，可通过会话 ID 精确筛选。

与其他功能的关系

• 渠道：Web SDK 或嵌入式会话通常携带渠道令牌落地；复盘时可对照渠道绑定 Agent。
• API 密钥：通过 API 接入的对话来源展示为 API。
• 工具管理 / 核心引擎：日志中的工具行名称对应 Agent 已启用的工具实例配置。

业务场景示例

排查一次失败的工具调用

角色与目标
您是值班管理员，接到接口报错反馈后需要在控制台还原完整上下文。

系统配置
在 会话记录 用会话 ID 精确筛选目标会话并打开抽屉，展开对应轮次查看工具条是否出现错误徽章，再通过检视图标读取关联 LLM 的请求参数。

场景效果
无需登录访客终端即可确认调用链与模型输出；结合右侧 Token 统计评估是否需要收紧提示词或工具权限。