获取智能体列表
本接口用于分页查询智能体（Agent）列表，支持按创建时间筛选，以及包含已归档的智能体。
返回结果按游标分页：data 为当前页的智能体列表，next_page 为下一页游标；没有下一页时为 null。
权限说明
使用 API Key 鉴权调用 API 流程，具体调用流程，请查看认证鉴权。
请求参数
每页条数，默认 20，最大 100。
翻页游标，取上一页响应的 next_page；第一页不传。
是否包含已归档的智能体，默认 false。
按创建时间过滤，返回创建时间大于等于该时刻的智能体，RFC 3339 格式。
按创建时间过滤，返回创建时间小于等于该时刻的智能体，RFC 3339 格式。
GET /api/dma/v1/agents?limit=20&include_archived=false HTTP/1.1
Host: api.dumate.cn
Authorization: Bearer <YOUR_API_KEY>示例代码
curl --location --request GET "https://api.dumate.cn/api/dma/v1/agents?limit=20&include_archived=false" \
--header 'Authorization: Bearer <YOUR_API_KEY>'返回响应
智能体（Agent）列表。
显示子属性
隐藏子属性
显示子属性
隐藏子属性
资源类型标识，固定为 agent。
智能体（Agent）标识，agt_ 前缀。
智能体（Agent）名称。
智能体（Agent）的用途说明。
智能体（Agent）的系统提示词。
工具配置列表，结构同请求参数，并补全默认值。
显示子属性
隐藏子属性
显示子属性
隐藏子属性
工具类型。
可选值：agent_toolset_20260401（内置工具集，包含 bash、edit、read、write、glob、grep、web_fetch、web_search）、mcp_toolset（引用 mcp_servers 中某个服务的全部工具）、custom（自定义工具，由调用方执行后通过 user.custom_tool_result 事件回填结果）。
对工具集内全部工具生效的默认配置。
适用于 agent_toolset_20260401、mcp_toolset。
显示子属性
隐藏子属性
是否启用，默认 true。
工具执行的权限策略。
显示子属性
隐藏子属性
权限策略类型。
可选值：always_allow（直接执行）、always_ask（每次执行前推送 agent.tool_use 事件，等待调用方通过 user.tool_confirmation 确认）。
按工具名单独覆盖默认配置。
适用于 agent_toolset_20260401、mcp_toolset。
显示子属性
隐藏子属性
显示子属性
隐藏子属性
工具名称。
agent_toolset_20260401 的可选值：bash、edit、read、write、glob、grep、web_fetch、web_search。
是否启用该工具。
工具执行的权限策略。
显示子属性
隐藏子属性
权限策略类型。
可选值：always_allow（直接执行）、always_ask（每次执行前推送 agent.tool_use 事件，等待调用方通过 user.tool_confirmation 确认）。
允许访问的域名（裸主机名），最多 64 个，与 blocked_domains 互斥。
仅 web_fetch。
显示子属性
隐藏子属性
禁止访问的域名（裸主机名），最多 64 个，与 allowed_domains 互斥。
仅 web_fetch。
显示子属性
隐藏子属性
抓取内容的最大 token 数。当前仅保存，不影响运行。
URL 来源配置。当前仅保存，不影响运行。
显示子属性
隐藏子属性
用户位置。当前仅保存，不影响运行。
显示子属性
隐藏子属性
位置类型，固定为 approximate。当前仅保存，不影响运行。
城市。当前仅保存，不影响运行。
国家，ISO 3166-1 两位代码。当前仅保存，不影响运行。
地区。当前仅保存，不影响运行。
时区，IANA 格式。当前仅保存，不影响运行。
引用的 MCP 服务名称，须与 mcp_servers 中某个服务的 name 一致。
type 为 mcp_toolset 时必填。
自定义工具名称，长度 1–64。
type 为 custom 时必填。
自定义工具描述。
type 为 custom 时必填。
工具输入结构，JSON Schema 格式。
type 为 custom 时必填。
显示子属性
隐藏子属性
工具输入结构类型，固定为 object。
工具输入参数声明。
显示子属性
隐藏子属性
工具输入必传参数。
显示子属性
隐藏子属性
MCP 服务列表，结构同请求参数，并补全默认值。
显示子属性
隐藏子属性
显示子属性
隐藏子属性
MCP 服务接入类型，固定为 url。
MCP 服务名称，长度 1–255，供 tools 中 mcp_toolset 的 mcp_server_name 引用。
MCP 服务地址，长度不超过 2048 个字符。
技能（Skill）列表，结构同请求参数，并补全默认值。
显示子属性
隐藏子属性
显示子属性
隐藏子属性
技能（Skill）类型，固定为 custom。
技能（Skill）标识，长度 1–64。
技能版本标识，取技能接口返回的版本标识；省略时自动使用最新版本。
自定义键值。
显示子属性
隐藏子属性
版本号。
创建时间，RFC 3339 格式，UTC。
最近更新时间，RFC 3339 格式，UTC。
归档时间，RFC 3339 格式，UTC；未归档时为 null。
下一页游标；没有下一页时为 null。
{
"data": [
{
"type": "agent",
"id": "agt_84cdf2ff9c2f",
"name": "demo-agent",
"description": "",
"system": "You are a helpful assistant.",
"tools": [
{
"type": "agent_toolset_20260401",
"default_config": {
"enabled": true,
"permission_policy": {
"type": "always_ask"
}
}
}
],
"mcp_servers": [],
"skills": [],
"metadata": {},
"version": 1,
"created_at": "2026-11-04T12:40:36Z",
"updated_at": "2026-11-04T12:40:36Z",
"archived_at": null
}
],
"next_page": null
}评价此篇文章