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
查询参数
响应
200-application/json
object[]
Session 对象数组
显示子属性
显示子属性
string
会话 ID,格式 sesn_<ULID>
string
固定为 session
enum<string>
会话状态:idle / running / terminated
可选值:idle,running,terminated
end_turn / retries_exhausted
会话回到 idle 的原因(判别联合)。详见 stop_reason 取值。仅 requires_action 携带 pending_batch_id 与非空 pending_call_ids
显示子属性
显示子属性
enum<string>
必填
end_turn(模型主动结束)/ retries_exhausted(重试耗尽)
可选值:end_turn,retries_exhausted
object
智能体配置快照,含 id/version/name/model/system/tools 等
显示子属性
显示子属性
string
string
integer
string
object
string
object[]
显示子属性
显示子属性
enum<string>
工具包类型
可选值:builtin_toolkit,mcp_toolkit
object
object[]
string
mcp_toolkit 类型对应的 MCP Server 名称
string
绑定的运行环境 ID
string
会话标题
object
业务自定义元数据
string | null
归档时间,未归档时为 null
string
创建时间,ISO 8601
string
最近更新时间,ISO 8601
object
会话运行时注入的环境变量
string | null
下一页游标
string
本次请求的唯一标识