KopilotListConversationChatMessages - 查询历史对话 - 云消息队列 Kafka 版

查询历史对话。

调试

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

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
alikafkakopilot:KopilotListConversationChatMessages	none	全部资源 ``	无	无

请求参数

名称	类型	必填	描述	示例值
SessionId	string	否	会话 ID。	e356c91c-8220-425c-9d86-********
RegionId	string	是	地域 ID。	cn-beijing
PageSize	integer	否	分页大小	10
BeforeTurnId	integer	否	游标。说明不传时返回最后 pageSize 个 turnId，传入时返回 turn ID。	2345

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	请求的 ID。	F69385B9-2139-5A07-AE64-37C4B6ED308E
Success	boolean	请求是否成功。	True
Code	long	返回码。返回 200 代表成功。	200
Data	object	调用成功时，返回的数据。
SessionId	string	会话 ID。	87ce9505-7dec-4fd7-bc7c-e66d949bfdc9
TotalTurns	long	trunId 总条数。	2
Messages	array<object>	消息体列表。
messages	object	消息体。
Role	string	角色标识。	assistant
Content	string	消息实际内容。	test
CreateTime	string	创建时间。	17575885545677
TurnId	string	主键 ID。	2345
Feedback	string	用户满意程度。	1
HasMore	boolean	是否有更多数据	true
NextBeforeTurnId	long	下一页游标。	1

示例

正常返回示例

JSON格式

{
  "RequestId": "F69385B9-2139-5A07-AE64-37C4B6ED308E",
  "Success": true,
  "Code": 200,
  "Data": {
    "SessionId": "87ce9505-7dec-4fd7-bc7c-e66d949bfdc9",
    "TotalTurns": 2,
    "Messages": [
      {
        "Role": "assistant",
        "Content": "test",
        "CreateTime": 17575885545677,
        "TurnId": 2345,
        "Feedback": 1
      }
    ],
    "HasMore": true,
    "NextBeforeTurnId": 1
  }
}

错误码

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

变更历史

变更时间	变更内容概要	操作
2026-06-22	新增 OpenAPI	查看变更详情