通过会话ID获取指定会话的消息历史和Pipeline快照临时下载地址。
接口说明
请求说明
调用 V2 服务时，请将
AgentVersion参数设为V2。接口只接受当前用户会话的
SessionId，不直接返回消息数组，而是返回session.jsonl与a2a-snapshot.json的预签名下载 URL。下载 URL 的有效期为 1800 秒（30 分钟），请在有效期内完成下载。
响应中的 URL 包含签名参数，请勿记录、分享或长期缓存。
MaxResults和NextToken是兼容字段，在 V2 版本中不会被消费。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
POST HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| SessionId |
string |
是 |
要查询的会话 ID。只能查询当前用户拥有的会话。 |
7f4e2a8c6d9b4a1f8e3c5b7d2a6f9012 |
| MaxResults |
integer |
否 |
兼容字段。V2 当前不按页返回消息数组，服务不消费该字段。 |
20 |
| NextToken |
string |
否 |
兼容字段。V2 当前不按页返回消息数组，服务不消费该字段。 |
CAES... |
| AgentVersion |
string |
否 |
传 V2 路由到 ROS Agent V2 后端。 |
V2 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
OpenAPI 请求 ID。 |
4C68F7A5-2D16-5C8F-A4B1-01E9C6A9B0D2 |
| Messages |
array<object> |
兼容字段。V2 当前响应不返回消息数组。 |
[] |
|
object |
兼容字段。V2 当前不返回消息对象。 |
{} |
|
| NextToken |
string |
兼容字段。V2 当前响应不返回 NextToken。 |
CAES... |
| MaxResults |
integer |
兼容字段。V2 当前响应不返回 MaxResults。 |
20 |
| SessionMessagesDownloadUrl |
string |
会话消息 session.jsonl 的预签名下载 URL，有效期 1800 秒。 |
https://oss.example/session.jsonl?signature=REDACTED |
| PipelineSnapshotDownloadUrl |
string |
Pipeline 的 a2a-snapshot.json 预签名下载 URL，有效期 1800 秒。 |
https://oss.example/a2a-snapshot.json?signature=REDACTED |
| Title |
string |
会话标题，可能为空。 |
创建 VPC 模板 |
示例
正常返回示例
JSON格式
{
"RequestId": "4C68F7A5-2D16-5C8F-A4B1-01E9C6A9B0D2",
"Messages": [
{}
],
"NextToken": "CAES...",
"MaxResults": 20,
"SessionMessagesDownloadUrl": "https://oss.example/session.jsonl?signature=REDACTED",
"PipelineSnapshotDownloadUrl": "https://oss.example/a2a-snapshot.json?signature=REDACTED",
"Title": "创建 VPC 模板"
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。