返回会话元数据、嵌入的智能体快照与资源列表。事件历史与消息内容通过事件 API 获取。
前提
已完成 Endpoint 与鉴权配置,详见API 总览与认证。
接口
GET /sessions/{session_id}
请求示例
curl "$AGENTSTUDIO_URL/sessions/sesn_xxx" \
-H "Authorization: Bearer $DASHSCOPE_API_KEY"session = client.sessions.retrieve("sesn_xxx")
print(session.id, session.status, session.title)Session session = client.sessions().retrieve("sesn_xxx");
System.out.println(session.getId() + " " + session.getStatus() + " " + session.getTitle());响应示例
{
"id": "sesn_xxx",
"type": "session",
"status": "idle",
"agent": {
"id": "agent_xxx",
"type": "agent",
"version": 1,
"name": "data-analyst",
"description": null,
"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:11Z",
"updated_at": "2026-05-28T08:23:25Z",
"request_id": "xxx"
}
响应为 Session 对象。字段如下:
响应字段
|
字段 |
类型 |
说明 |
|
|
string |
会话 ID,格式 |
|
|
string |
固定为 |
|
|
string |
会话状态: |
|
|
object |
智能体配置完整快照(创建时锁定),含 |
|
|
string |
绑定的运行环境 ID |
|
|
string / object |
会话标题与业务自定义元数据 |
|
|
string | null |
归档时间,未归档时为 |
|
|
string |
创建/最近更新时间,ISO 8601 |
|
|
string |
本次请求的唯一标识 |
该文章对您有帮助吗?