获取会话详情
本接口用于查询单个会话（Session）的详情。
status、usage、stats 等运行时字段为查询时刻的汇总数据。
权限说明
使用 API Key 鉴权调用 API 流程，具体调用流程，请查看认证鉴权。
请求参数
会话标识。
会话不存在时返回 404；会话不属于当前账号时返回 403。
GET /api/dma/v1/sessions/{session_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_gffe5e3caaadc6ffe126cMcNQZsyuhP" \
--header 'Authorization: Bearer <YOUR_API_KEY>'返回响应
资源类型标识，固定为 session。
会话标识，ses_ 前缀。
会话标题；未设置时为 null。
会话使用的智能体（Agent）快照。
显示子属性
隐藏子属性
资源类型标识，固定为 agent。
智能体（Agent）标识。
智能体（Agent）名称。
智能体（Agent）的用途说明。
智能体（Agent）的系统提示词。
多智能体编排配置，当前固定为 null。
显示子属性
隐藏子属性
执行身份。
显示子属性
隐藏子属性
执行身份类型，例如 service_account。
工具配置列表。
显示子属性
隐藏子属性
工具配置，结构同创建智能体接口。
显示子属性
隐藏子属性
MCP 服务列表。
显示子属性
隐藏子属性
MCP 服务配置，结构同创建智能体接口。
显示子属性
隐藏子属性
技能（Skill）列表。
显示子属性
隐藏子属性
技能配置，结构同创建智能体接口。
显示子属性
隐藏子属性
文件列表。
显示子属性
隐藏子属性
文件配置。
显示子属性
隐藏子属性
自定义键值。
显示子属性
隐藏子属性
智能体（Agent）版本号。
创建时间，RFC 3339 格式，UTC。
最近更新时间，RFC 3339 格式，UTC。
归档时间，RFC 3339 格式，UTC；未归档时为 null。
环境标识。
会话状态。
可选值：rescheduling（重新调度中）、running（运行中）、idle（空闲，等待输入）、terminated（已终止）。
累计用量。
会话尚未运行时为空对象。
显示子属性
隐藏子属性
输入 token 数。
输出 token 数。
命中缓存的输入 token 数。
写入缓存的 token 数。
显示子属性
隐藏子属性
写入 1 小时缓存的输入 token 数。
写入 5 分钟缓存的输入 token 数。
服务端工具调用次数。
显示子属性
隐藏子属性
web_fetch 调用次数。
web_search 调用次数。
实际运行秒数。
费用。
显示子属性
隐藏子属性
金额，字符串格式。
货币，固定为 POINT（DuMate 积分）。
运行统计。
显示子属性
隐藏子属性
实际运行秒数。
从创建至今的秒数。
已挂载的会话资源列表。
显示子属性
隐藏子属性
显示子属性
隐藏子属性
资源类型，固定为 file。
会话资源标识，sesrsc_ 前缀。
文件标识。
沙箱内的挂载路径。
创建时间，RFC 3339 格式，UTC。
最近更新时间，RFC 3339 格式，UTC。
关联的凭证空间（Vault）标识列表。
显示子属性
隐藏子属性
费用上限；未设置时为 null。
显示子属性
隐藏子属性
费用上限类型，固定为 limit。
费用。
显示子属性
隐藏子属性
金额，字符串格式。
货币，固定为 POINT（DuMate 积分）。
自定义键值。
显示子属性
隐藏子属性
创建时间，RFC 3339 格式，UTC。
最近更新时间，RFC 3339 格式，UTC。
归档时间，RFC 3339 格式，UTC；未归档时为 null。
{
"type": "session",
"id": "ses_gffe5e3caaadc6ffe126cMcNQZsyuhP",
"title": "doc-test-session",
"agent": {
"type": "agent",
"id": "agt_2ad2d132c698",
"name": "doc-test-agent-session",
"description": "",
"system": "You are a helpful assistant. Reply briefly in Chinese.",
"multiagent": null,
"execution_identity": {
"type": "service_account"
},
"tools": [
{
"type": "agent_toolset_20260401",
"configs": [],
"default_config": {
"enabled": true,
"permission_policy": {
"type": "always_allow"
}
}
}
],
"mcp_servers": [],
"skills": [],
"files": [],
"metadata": {},
"version": 1,
"created_at": "2026-11-10T02:39:37Z",
"updated_at": "2026-11-10T02:39:37Z",
"archived_at": null
},
"environment_id": "env_90586e59c0564219",
"status": "idle",
"usage": {
"input_tokens": 15096,
"output_tokens": 348,
"cache_read_input_tokens": 28416,
"cache_creation": {
"ephemeral_1h_input_tokens": 0,
"ephemeral_5m_input_tokens": 0
},
"server_tool_use": {
"web_fetch_requests": 0,
"web_search_requests": 0
},
"active_seconds": 12.005,
"list_cost": {
"amount": "16.97",
"currency": "POINT"
}
},
"stats": {
"active_seconds": 12.005,
"duration_seconds": 117.67
},
"resources": [
{
"type": "file",
"id": "sesrsc_6d5dd97a40a14f50",
"file_id": "node_g001a1c3534dc1001mUC0tecbzGoZuN",
"mount_path": "/mnt/session/uploads/node_g001a1c3534dc1001mUC0tecbzGoZuN",
"created_at": "2026-11-10T02:39:41Z",
"updated_at": "2026-11-10T02:39:41Z"
}
],
"vault_ids": [],
"budget": {
"type": "limit",
"max_list_cost": {
"amount": "2500",
"currency": "POINT"
}
},
"metadata": {
"ticket": "doc"
},
"created_at": "2026-11-10T02:39:40Z",
"updated_at": "2026-11-10T02:39:40Z",
"archived_at": null
}评价此篇文章