归档会话:status 置为 terminated 终态,archived_at 填入归档时间,事件历史仍可查询。
前提
已完成 Endpoint 与鉴权配置,详见API 总览与认证。
接口
POST /sessions/{session_id}/archive
请求示例
curl -X POST "$AGENTSTUDIO_URL/sessions/sesn_xxx/archive" \
-H "Authorization: Bearer $DASHSCOPE_API_KEY"client.sessions.archive("sesn_xxx")client.sessions().archive("sesn_xxx");响应示例
返回完整 session 对象,status 置为 terminated,archived_at 被填入归档时间。
{
"id": "sesn_xxx",
"type": "session",
"status": "terminated",
"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": "2026-05-28T11:00:00Z",
"created_at": "2026-05-28T08:23:11Z",
"updated_at": "2026-05-28T11:00:00Z",
"request_id": "xxx"
}
响应为 Session 对象。字段如下:
响应字段
|
字段 |
类型 |
说明 |
|
|
string |
会话 ID |
|
|
string |
固定为 |
|
|
string |
归档后置为 |
|
|
object |
智能体配置快照 |
|
|
string |
绑定的运行环境 ID |
|
|
string / object |
会话标题、业务元数据 |
|
|
string |
归档时间,ISO 8601;归档接口返回的对象中该字段一定非空 |
|
|
string |
创建/最近更新时间 |
|
|
string |
本次请求的唯一标识 |
该文章对您有帮助吗?