查看 Markdown
GET/api/sessionAnalysis/sessionDetail

分页查询会话执行时间线

按记录时间倒序返回对话轮和轮间压缩事件,不读取正文和预览、不计算总数。压缩事件最多附带5条模型请求引用,可直接查看或下载;更多引用通过messageTrace查询。运行中翻页不保证快照一致性。

请求参数

请求头参数1 个字段

X-Principal-Idintegernullable

身份主体ID(Long类型)。通过API访问时必须传递以标识操作主体;通过页面访问时无需传递。可通过「身份主体」模块的创建接口获取。

Query 参数3 个字段

sessionIdintegerrequired

会话ID

pageintegerrequired

页码,从1开始

pageSizeintegerrequired

每页记录数,取值范围1~100

响应

200

httpStatusCodeintegernullable

HTTP状态码

messagestringnullable

响应消息

响应数据

successbooleannullable

是否成功

requestIdstringnullable

上游请求ID,用于跨系统链路追踪排查问题

errCodestringnullable

上游错误码,前端可据此做特殊UI处理

查看 Markdown
GET/api/sessionAnalysis/messageTrace

查询消息完整调用元数据

一次返回助手消息或压缩承载消息的全部已归档请求引用和步骤元数据;用户消息ID自动解析助手回复。无归档步骤返回STEP_ONLY,不推断缺失原因。列表不读取原始请求正文。相同步骤的统计可能重复,须按stepId去重;轮内压缩的锚定步骤统计不代表该压缩调用的独立结果。单消息最多2000份归档,超过上限明确报错。

请求参数

请求头参数1 个字段

X-Principal-Idintegernullable

身份主体ID(Long类型)。通过API访问时必须传递以标识操作主体;通过页面访问时无需传递。可通过「身份主体」模块的创建接口获取。

Query 参数4 个字段

sessionIdintegerrequired

会话ID

messageIdintegerrequired

助手或压缩承载消息ID;消息查询支持用户消息解析回复,下载不自动解析

stepIndexintegernullable

步骤号,STEP从1起,轮间压缩为0;不传查询全部

kindstringnullable

调用类型,可选值:STEP、COMPACT;不传查询全部

响应

200

httpStatusCodeintegernullable

HTTP状态码

messagestringnullable

响应消息

响应数据

successbooleannullable

是否成功

requestIdstringnullable

上游请求ID,用于跨系统链路追踪排查问题

errCodestringnullable

上游错误码,前端可据此做特殊UI处理

查看 Markdown
GET/api/sessionAnalysis/llmRequestDetail

查看单份模型原始请求

使用前序接口返回的llmRequestId读取一份完整请求,包含提示词、工具定义和未知请求字段;不返回内部服务地址。归档为尽力保存,attempt是请求体版本,不是网络重试次数,不提供原始模型响应。

请求参数

请求头参数1 个字段

X-Principal-Idintegernullable

身份主体ID(Long类型)。通过API访问时必须传递以标识操作主体;通过页面访问时无需传递。可通过「身份主体」模块的创建接口获取。

Query 参数2 个字段

sessionIdintegerrequired

会话ID

llmRequestIdstringrequired

前序分析接口返回的请求标识,请原样传入

响应

200

httpStatusCodeintegernullable

HTTP状态码

messagestringnullable

响应消息

响应数据

successbooleannullable

是否成功

requestIdstringnullable

上游请求ID,用于跨系统链路追踪排查问题

errCodestringnullable

上游错误码,前端可据此做特殊UI处理

查看 Markdown
GET/api/sessionAnalysis/downloadLlmRequests

压缩下载模型原始请求

llmRequestId与messageId必须二选一。单份返回json.gz,单消息返回ZIP(manifest.json及各份json.gz),解压内容与详情data一致。ZIP内请求文件使用step-步骤-a版本或compact-s步骤-c序号命名,重跑文件追加-r重跑标识;manifest中的每个请求条目包含kind、stepIndex、attempt、compactSeq和rerunId,可在不解压请求文件的情况下按步骤定位。禁止整会话下载,不接受步骤或分页筛选,不自动解析用户消息ID。单消息最多2000份;客户端应校验压缩包完整性后确认导出成功。

请求参数

请求头参数1 个字段

X-Principal-Idintegernullable

身份主体ID(Long类型)。通过API访问时必须传递以标识操作主体;通过页面访问时无需传递。可通过「身份主体」模块的创建接口获取。

Query 参数3 个字段

sessionIdintegerrequired

会话ID

llmRequestIdstringnullable

前序分析接口返回的请求标识,请原样传入;与另一下载范围参数二选一

messageIdintegernullable

助手或压缩承载消息ID;消息查询支持用户消息解析回复,下载不自动解析;与另一下载范围参数二选一