列出 Session - 阿里云百炼

前提

已完成 Endpoint 与鉴权配置，详见API 总览与认证。

接口

GET /sessions

Query 参数

参数	类型	默认	说明
`agent_id`	string	—	按智能体过滤
`statuses[]`	string	—	多状态过滤，可重复传入。如 `?statuses[]=idle&statuses[]=running`
`created_at[gte]` / `created_at[lte]`	string	—	创建时间范围，ISO 8601
`limit`	int	20	每页数量，最大 100
`page`	string	—	首次不传，后续传上一次响应的 `next_page`

请求示例

curl "$AGENTSTUDIO_URL/sessions?agent_id=agent_xxx&statuses[]=idle&limit=20" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

响应示例

{
  "data": [
    {
      "id": "sesn_xxx",
      "type": "session",
      "status": "idle",
      "agent": {
        "id": "agent_xxx",
        "type": "agent",
        "version": 1,
        "name": "data-analyst",
        "model": {"id": "qwen3-max"},
        "system": "你是数据分析专家，使用 pandas 处理 CSV 文件。",
        "tools": []
      },
      "environment_id": "env_xxx",
      "title": "Q3 销售数据分析",
      "metadata": {"biz_ticket_id": "1234"},
      "archived_at": null,
      "created_at": "2026-05-28T08:23:11.456000Z",
      "updated_at": "2026-05-28T08:23:25.789000Z"
    }
  ],
  "next_page": "xxx",
  "request_id": "xxx"
}

响应包含 data（Session 对象数组）与 next_page（下一页游标）。Session 对象字段如下：

Session 对象字段

字段	类型	说明
`id`	string	会话 ID，格式 `sesn_<ULID>`
`type`	string	固定为 `session`
`status`	string	会话状态：`idle` / `running` / `terminated`
`agent`	object	智能体配置快照，含 `id`/`version`/`name`/`model`/`system`/`tools` 等
`environment_id`	string	绑定的运行环境 ID
`title` / `metadata`	string / object	会话标题与业务自定义元数据
`archived_at`	string \| null	归档时间，未归档时为 `null`
`created_at` / `updated_at`	string	创建/最近更新时间，ISO 8601

​前提

​接口

​Query 参数

​请求示例

​响应示例

​Session 对象字段

前提

接口

Query 参数

请求示例

响应示例

Session 对象字段