ListChatMessages - 获取会话消息历史-资源编排(ROS)-阿里云帮助中心

通过会话ID获取指定会话的消息历史和Pipeline快照临时下载地址。

接口说明

请求说明

调用 V2 服务时，请将 AgentVersion 参数设为 V2。
接口只接受当前用户会话的 SessionId，不直接返回消息数组，而是返回 session.jsonl 与 a2a-snapshot.json 的预签名下载 URL。
下载 URL 的有效期为 1800 秒（30 分钟），请在有效期内完成下载。
响应中的 URL 包含签名参数，请勿记录、分享或长期缓存。
MaxResults 和 NextToken 是兼容字段，在 V2 版本中不会被消费。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求语法

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 模板
PipelineName	string	流水线名称，取值为 EvaluationFirstSelling 和 SolutionFirstSelling。	SolutionFirstSelling
WorkspaceTemplates	array<object>	会话工作区中的 ROS 模板列表。仅方案优先流程返回；没有已发布的模板时不返回或返回空数组。
	object	单个 ROS 模板的路径、可用状态和临时下载地址。
TemplatePath	string	模板在会话工作区中的相对路径。支持`.yml`、`.yaml`和`.json`格式。	templates/0-vpc.yml
Status	string	模板的可下载状态。取值如下： `available`：模板已准备完成，可以下载，同时返回 `DownloadUrl`。 `not_ready`：模板路径已确定，但文件尚未准备完成，请稍后重试。 `unavailable`：模板当前无法下载，例如文件过大或临时下载地址生成失败。	available
DownloadUrl	string	模板文件的临时下载地址。仅当 `Status` 为 `available` 时返回，有效期为 300 秒；过期后需重新调用接口获取。	https://example.com/templates/0-vpc.yml?expires=300

示例

正常返回示例

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 模板",
  "PipelineName": "SolutionFirstSelling",
  "WorkspaceTemplates": [
    {
      "TemplatePath": "templates/0-vpc.yml",
      "Status": "available",
      "DownloadUrl": "https://example.com/templates/0-vpc.yml?expires=300"
    }
  ]
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。