归档线程
本接口用于归档会话（Session）内的子线程。
只有状态为 idle 的子线程可以归档。归档主线程时返回 409，需要改为归档整个会话；线程状态不是 idle 时也返回 409。归档成功后返回线程对象，archived_at 为归档时间。
权限说明
使用 API Key 鉴权调用 API 流程，具体调用流程，请查看认证鉴权。
请求参数
会话标识。
会话不存在时返回 404；会话不属于当前账号时返回 403。
线程标识。
只能归档子线程；传入主线程标识（即会话标识）时返回 409。
线程不存在时返回 404。
POST /api/dma/v1/sessions/{session_id}/threads/{thread_id}/archive HTTP/1.1
Host: api.dumate.cn
Authorization: Bearer <YOUR_API_KEY>示例代码
curl --location --request POST "https://api.dumate.cn/api/dma/v1/sessions/ses_gffe5e36678cd3ffe2PBFiopsq4cl0P/threads/sthr_demo0000/archive" \
--header 'Authorization: Bearer <YOUR_API_KEY>'返回响应
资源类型标识，固定为 session_thread。
线程标识。
主线程的标识与会话标识相同。
所属会话标识。
父线程标识；主线程为 null。
该线程运行的智能体（Agent）配置。
显示子属性
隐藏子属性
资源类型标识，固定为 agent。
智能体（Agent）标识。
智能体（Agent）名称。
子线程的智能体名称为 self 时表示主智能体自身。
系统提示词。
工具配置列表。
显示子属性
隐藏子属性
工具配置，结构同创建智能体接口。
显示子属性
隐藏子属性
技能（Skill）列表。
显示子属性
隐藏子属性
技能配置，结构同创建智能体接口。
显示子属性
隐藏子属性
MCP 服务列表。
显示子属性
隐藏子属性
MCP 服务配置，结构同创建智能体接口。
显示子属性
隐藏子属性
执行身份。
显示子属性
隐藏子属性
执行身份类型，例如 service_account。
智能体（Agent）版本号。
线程状态。
可选值：running（运行中）、idle（空闲）、rescheduling（重新调度中）、terminated（已终止）。
累计用量，字段同会话对象的 usage。
显示子属性
隐藏子属性
输入 token 数。
输出 token 数。
命中缓存的输入 token 数。
写入缓存的 token 数。
显示子属性
隐藏子属性
写入 1 小时缓存的输入 token 数。
写入 5 分钟缓存的输入 token 数。
服务端工具调用次数。
显示子属性
隐藏子属性
web_fetch 调用次数。
web_search 调用次数。
实际运行秒数。
费用。
显示子属性
隐藏子属性
金额，字符串格式。
货币，固定为 POINT（DuMate 积分）。
运行统计。
显示子属性
隐藏子属性
实际运行秒数。
从创建至今的秒数。
启动耗时，单位为秒。
关联的工作流运行标识；没有时为 null。
创建时间，RFC 3339 格式，UTC。
最近更新时间，RFC 3339 格式，UTC。
归档时间，RFC 3339 格式，UTC；未归档时为 null。
{
"id": "sthr_demo0000",
"type": "session_thread",
"session_id": "ses_gffe5e36678cd3ffe2PBFiopsq4cl0P",
"parent_thread_id": "ses_gffe5e36678cd3ffe2PBFiopsq4cl0P",
"agent": {
"id": "agt_e5d35b1b1a30",
"name": "doc-test-agent",
"type": "agent",
"tools": [
{
"type": "agent_toolset_20260401",
"configs": [],
"default_config": {
"enabled": true,
"permission_policy": {
"type": "always_ask"
}
}
}
],
"skills": [],
"system": "你是测试助手。回答尽量简短。",
"version": 1,
"mcp_servers": [],
"execution_identity": {
"type": "service_account"
}
},
"status": "idle",
"created_at": "2026-11-11T07:52:53.821Z",
"updated_at": "2026-11-11T07:54:28.650Z",
"archived_at": "2026-11-11T08:10:00.000Z",
"usage": {
"input_tokens": 14555,
"output_tokens": 134,
"cache_read_input_tokens": 7936,
"cache_creation": {
"ephemeral_5m_input_tokens": 0,
"ephemeral_1h_input_tokens": 0
},
"active_seconds": 8.279,
"server_tool_use": {
"web_fetch_requests": 0,
"web_search_requests": 0
}
},
"stats": {
"active_seconds": 8.279,
"duration_seconds": 352.335,
"startup_seconds": 25.353
},
"workflow_run_id": null
}评价此篇文章