获取会话列表

更新时间：2026-11-13

GET

https://api.dumate.cn/api/dma/v1/sessions?limit=10&agent_id={agent_id}&status=idle

本接口用于分页查询会话（Session）列表，支持按智能体、状态、创建时间筛选。

返回结果按游标分页：data 为当前页的会话列表，next_page 为下一页游标；没有下一页时为 null。

权限说明

使用 API Key 鉴权调用 API 流程，具体调用流程，请查看认证鉴权。

请求参数

Headers 参数

除公共头域外，无其它特殊头域

Query 参数

limit integer

每页条数，默认 20，取值 1–100；超出范围时返回 400。

可选

page string

翻页游标，取上一页响应的 next_page；第一页不传。

可选

order string

按创建时间排序。
可选值：desc（新的在前，默认）、asc（旧的在前）。

可选

agent_id string

按智能体（Agent）标识过滤。

可选

agent_version integer

按智能体（Agent）版本过滤，需同时传入 agent_id。

可选

status array

按会话状态过滤，可重复传多个，如 status=idle&status=running。
可选值：rescheduling、running、idle、terminated；其他取值返回 400。

可选

显示子属性隐藏子属性

items string

include_archived boolean

是否包含已归档的会话，默认 false。

可选

created_at[gt] string

返回创建时间晚于该时刻的会话，RFC 3339 格式。

可选

created_at[gte] string

返回创建时间晚于或等于该时刻的会话，RFC 3339 格式。

可选

created_at[lt] string

返回创建时间早于该时刻的会话，RFC 3339 格式。

可选

created_at[lte] string

返回创建时间早于或等于该时刻的会话，RFC 3339 格式。

可选

请求结构

GET /api/dma/v1/sessions?limit=10&agent_id={agent_id}&status=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?limit=10&agent_id=agt_2ad2d132c698&status=idle" \
  --header 'Authorization: Bearer <YOUR_API_KEY>'

返回响应

Headers 参数

除公共头域外，无其它特殊头域

返回参数

data array

会话（Session）列表。

可选

显示子属性隐藏子属性

items object {15}

显示子属性隐藏子属性

type string

资源类型标识，固定为 session。

可选

id string

会话标识，ses_ 前缀。

可选

title string

会话标题；未设置时为 null。

可选

agent object {16}

会话使用的智能体（Agent）快照。

可选

显示子属性隐藏子属性

type string

资源类型标识，固定为 agent。

可选

id string

智能体（Agent）标识。

可选

name string

智能体（Agent）名称。

可选

description string

智能体（Agent）的用途说明。

可选

system string

智能体（Agent）的系统提示词。

可选

multiagent object

当前固定为 null。

可选

显示子属性隐藏子属性

execution_identity object {1}

执行身份。

可选

显示子属性隐藏子属性

type string

执行身份类型，例如 service_account。

可选

tools array

工具配置列表。

可选

显示子属性隐藏子属性

items object

工具配置，结构同创建智能体接口。

显示子属性隐藏子属性

mcp_servers array

MCP 服务列表。

可选

显示子属性隐藏子属性

items object

MCP 服务配置，结构同创建智能体接口。

显示子属性隐藏子属性

skills array

技能（Skill）列表。

可选

显示子属性隐藏子属性

items object

技能配置，结构同创建智能体接口。

显示子属性隐藏子属性

files array

文件列表。

可选

显示子属性隐藏子属性

items object

文件配置。

显示子属性隐藏子属性

metadata object

自定义键值。

可选

显示子属性隐藏子属性

version integer

智能体（Agent）版本号。

可选

created_at string

创建时间，RFC 3339 格式，UTC。

可选

updated_at string

最近更新时间，RFC 3339 格式，UTC。

可选

archived_at string

归档时间，RFC 3339 格式，UTC；未归档时为 null。

可选

environment_id string

环境标识。

可选

status string

会话状态。
可选值：rescheduling（重新调度中）、running（运行中）、idle（空闲，等待输入）、terminated（已终止）。

可选

usage object {7}

累计用量。
会话尚未运行时为空对象。

可选

显示子属性隐藏子属性

input_tokens integer

输入 token 数。

可选

output_tokens integer

输出 token 数。

可选

cache_read_input_tokens integer

命中缓存的输入 token 数。

可选

cache_creation object {2}

写入缓存的 token 数。

可选

显示子属性隐藏子属性

ephemeral_1h_input_tokens integer

写入 1 小时缓存的输入 token 数。

可选

ephemeral_5m_input_tokens integer

写入 5 分钟缓存的输入 token 数。

可选

server_tool_use object {2}

服务端工具调用次数。

可选

显示子属性隐藏子属性

web_fetch_requests integer

web_fetch 调用次数。

可选

web_search_requests integer

web_search 调用次数。

可选

active_seconds number

实际运行秒数。

可选

list_cost object {2}

费用。

可选

显示子属性隐藏子属性

amount string

金额，字符串格式。

可选

currency string

货币，固定为 POINT（DuMate 积分）。

可选

stats object {2}

运行统计。

可选

显示子属性隐藏子属性

active_seconds number

实际运行秒数。

可选

duration_seconds number

从创建至今的秒数。

可选

resources array

已挂载的会话资源列表。

可选

显示子属性隐藏子属性

items object {6}

显示子属性隐藏子属性

type string

资源类型，固定为 file。

可选

id string

会话资源标识，sesrsc_ 前缀。

可选

file_id string

文件标识。

可选

mount_path string

沙箱内的挂载路径。

可选

created_at string

创建时间，RFC 3339 格式，UTC。

可选

updated_at string

最近更新时间，RFC 3339 格式，UTC。

可选

vault_ids array

关联的凭证空间（Vault）标识列表。

可选

显示子属性隐藏子属性

items string

budget object {2}

费用上限；未设置时为 null。

可选

显示子属性隐藏子属性

type string

费用上限类型，固定为 limit。

可选

max_list_cost object {2}

费用。

可选

显示子属性隐藏子属性

amount string

金额，字符串格式。

可选

currency string

货币，固定为 POINT（DuMate 积分）。

可选

metadata object

自定义键值。

可选

显示子属性隐藏子属性

created_at string

创建时间，RFC 3339 格式，UTC。

可选

updated_at string

最近更新时间，RFC 3339 格式，UTC。

可选

archived_at string

归档时间，RFC 3339 格式，UTC；未归档时为 null。

可选

next_page string

可选

响应示例

{
  "data": [
    {
      "type": "session",
      "id": "ses_gffe5e3caaadc6ffe126cMcNQZsyuhP",
      "title": "doc-test-session-2",
      "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": {},
      "stats": {
        "active_seconds": 0,
        "duration_seconds": 3.139
      },
      "resources": [],
      "vault_ids": [],
      "budget": null,
      "metadata": {},
      "created_at": "2026-11-10T02:41:53Z",
      "updated_at": "2026-11-10T02:41:53Z",
      "archived_at": null
    }
  ],
  "next_page": null
}

评价此篇文章

有帮助没帮助

百度智能云

百度搭子

百度搭子

获取会话列表

权限说明

请求参数

示例代码

返回响应