获取线程详情
本接口用于查询会话（Session）内单个线程的详情。
查询主线程时，thread_id 传入会话标识即可。
权限说明
使用 API Key 鉴权调用 API 流程，具体调用流程，请查看认证鉴权。
请求参数
会话标识。
会话不存在时返回 404；会话不属于当前账号时返回 403。
线程标识。
主线程的标识与会话标识相同。
线程不存在时返回 404。
GET /api/dma/v1/sessions/{session_id}/threads/{thread_id} HTTP/1.1
Host: api.dumate.cn
Authorization: Bearer <YOUR_API_KEY>示例代码
curl --location --request GET "https://api.dumate.cn/api/dma/v1/sessions/ses_gffe5e36678cd3ffe2PBFiopsq4cl0P/threads/ses_gffe5e36678cd3ffe2PBFiopsq4cl0P" \
--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": "ses_gffe5e36678cd3ffe2PBFiopsq4cl0P",
"type": "session_thread",
"session_id": "ses_gffe5e36678cd3ffe2PBFiopsq4cl0P",
"parent_thread_id": null,
"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": null,
"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
}评价此篇文章