跳转到主要内容
Session & Event

列出 Session

分页列出业务空间下的会话

GET
/api/v1/agentstudio/sessions
cURL
curl --request GET \
  --url 'https://dashscope.aliyuncs.com/api/v1/agentstudio/sessions' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'
{
  "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-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"
}
列表项的 stop_reason 字段为判别联合,取值与语义见获取 Session 的「stop_reason 取值」小节。

鉴权

string
header
必填

DashScope API Key

查询参数

string

按智能体过滤

enum<string>[]

多状态过滤,可重复传入。如 ?statuses[]=idle&statuses[]=running

string

创建时间范围下界,ISO 8601

string

创建时间范围上界,ISO 8601

integer
默认值20

每页数量,最大 100

string

首次不传,后续传上一次响应的 next_page

响应

200-application/json
object[]

Session 对象数组

string | null

下一页游标

string

本次请求的唯一标识