归档 Session

前提

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

接口

POST /sessions/{session_id}/archive

请求示例

curl -X POST "$AGENTSTUDIO_URL/sessions/sesn_xxx/archive" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

响应示例

返回完整 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.7-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 对象。字段如下：

响应字段

字段	类型	说明
`id`	string	会话 ID
`type`	string	固定为 `session`
`status`	string	归档后置为 `terminated`（终态）
`agent`	object	智能体配置快照
`environment_id`	string	绑定的运行环境 ID
`title` / `metadata`	string / object	会话标题、业务元数据
`archived_at`	string	归档时间，ISO 8601；归档接口返回的对象中该字段一定非空
`created_at` / `updated_at`	string	创建 / 最近更新时间
`request_id`	string	本次请求的唯一标识

​前提

​接口

​请求示例

​响应示例

​响应字段

前提

接口

请求示例

响应示例

响应字段