列出 Session

分页列出会话，按 created_at 倒序返回。支持按智能体、状态、创建时间范围过滤。

前提

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

接口

GET /sessions

Query 参数

请求示例

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

for session in client.sessions.list(
    limit=20,
    agent_id="agent_xxx",
    statuses=["idle"],
):
    print(session.id, session.status, session.title)

CursorPage<Session> page = client.sessions().list(SessionListParam.builder()
    .limit(20)
    .agentId("agent_xxx")
    .statuses(Arrays.asList("idle"))
    .build());
for (Session s : page.getData()) {
    System.out.println(s.getId() + " " + s.getStatus() + " " + s.getTitle());
}

响应示例

{
  "data": [
    {
      "id": "sesn_xxx",
      "type": "session",
      "status": "idle",
      "stop_reason": null,
      "agent": {
        "id": "agent_xxx",
        "type": "agent",
        "version": 1,
        "name": "data-analyst",
        "model": {"id": "qwen3.7-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",
      "environment_variables": {"API_BASE_URL": "https://api.example.com", "LOG_LEVEL": "info"}
    }
  ],
  "next_page": "xxx",
  "request_id": "xxx"
}

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

Session 对象字段