ListMemorySessions - 列出记忆下会话

列出记忆下的所有会话。

接口说明

获取指定内存实例的所有会话列表,支持按时间范围过滤和分页查询。会话是 AgentRun 中用于存储对话历史和管理上下文的重要组件。

调试

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

授权信息

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

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

请求语法

GET /2025-09-10/agents/memories/{memoryName}/sessions HTTP/1.1

请求参数

名称类型必填描述示例值
memoryNamestring

记忆名称。

test-memory
fromlong

子时间区间的开始时间点。UNIX 时间戳格式,表示从 1970-1-1 00:00:00 UTC 计算起的秒数。

时间区间遵循“左闭右开”原则,即该时间区间包括区间开始时间点,但不包括区间结束时间点。如果 from 和 to 的值相同,则为无效区间,函数直接返回错误。

1740622996
tolong

子时间区间的结束时间点。UNIX 时间戳格式,表示从 1970-1-1 00:00:00 UTC 计算起的秒数。

时间区间遵循“左闭右开”原则,即该时间区间包括区间开始时间点,但不包括区间结束时间点。如果 from 和 to 的值相同,则为无效区间,函数直接返回错误。

1747275768
pageNumberinteger

页码。

默认值:1。

1
pageSizeinteger

指定每页展示条数,默认为 20

20

返回参数

名称类型描述示例值
object

Schema of Response

requestIdstring

Id of the request

E2C43519-6095-5487-9526-051AB8F50B4A
dataobject

响应数据。

itemsarray

session ID 列表。

itemsstring

session ID。

30049054648_article:article
totallong

总记录数。

211
pageNumberinteger

分页页码。

1
pageSizeinteger

分页大小。

10
codestring

响应码。

SUCCESS

示例

正常返回示例

JSON格式

{
  "requestId": "E2C43519-6095-5487-9526-051AB8F50B4A",
  "data": {
    "items": [
      "30049054648_article:article"
    ],
    "total": 211,
    "pageNumber": 1,
    "pageSize": 10
  },
  "code": "SUCCESS"
}

错误码

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