获取线程列表
本接口用于查询会话（Session）内的线程列表。线程是会话内的执行单元，每个会话有一个主线程，主线程的标识与会话标识相同；多智能体编排场景下，主智能体会创建子线程。
返回结果按游标分页：data 为当前页的线程列表，next_page 为下一页游标；没有下一页时为 null。
权限说明
使用 API Key 鉴权调用 API 流程，具体调用流程，请查看认证鉴权。
请求参数
会话标识。
会话不存在时返回 404；会话不属于当前账号时返回 403。
每页条数，默认 1000，最大 1000。
超出范围时返回 400。
翻页游标，取上一页响应的 next_page；第一页不传。
按线程状态过滤，可传多个。
可选值：running、idle、rescheduling、terminated。
显示子属性
隐藏子属性
GET /api/dma/v1/sessions/{session_id}/threads?statuses[]=idle HTTP/1.1
Host: api.dumate.cn
Authorization: Bearer <YOUR_API_KEY>示例代码
curl -g --location --request GET "https://api.dumate.cn/api/dma/v1/sessions/ses_gffe5e36678cd3ffe2PBFiopsq4cl0P/threads?statuses[]=idle" \
--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。
下一页游标；没有下一页时为 null。
{
"data": [
{
"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
}
],
"next_page": null
}评价此篇文章