获取智能体列表
更新时间：2026-10-13
GET
https://api.dumate.cn/api/v1/agents
本接口用于查询企业内所有智能体（Agent）列表，支持按名称关键词检索。
权限说明
使用 API Key 鉴权调用 API 流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Query 参数
keyword
string
按智能体（Agent）名称检索。
可选
cursor
stringinteger
分页游标。
首次请求不传；后续请求传入上一页响应返回的 nextCursor。
可选
limit
integer
每页返回数量。默认值和上限以服务端实际限制为准。
可选
请求结构
GET /api/v1/agents?keyword=doc&limit=20 HTTP/1.1
Host: api.dumate.cn
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json
示例代码
请求示例
curl --location --request GET "https://api.dumate.cn/api/v1/agents?limit=4" \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <YOUR_API_KEY>'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
data
array
智能体（Agent）列表。
可选
显示子属性
隐藏子属性
items
object {12}
显示子属性
隐藏子属性
id
string
智能体（Agent）标识。
可选
name
string
智能体（Agent）名称。
可选
description
string
智能体（Agent）的用途说明。
可选
version
integer
智能体（Agent）当前版本号。
可选
model
object {1}
模型配置对象。
可选
显示子属性
隐藏子属性
name
string
智能体（Agent）使用的模型名称。
可选
system
string
智能体（Agent）的系统提示词。
可选
skills
array
智能体（Agent）已挂载的技能（Skill）列表。
可选
显示子属性
隐藏子属性
items
object {3}
显示子属性
隐藏子属性
skillID
string
技能（Skill）标识。
可选
releaseID
string
技能（Skill）发布版本标识。
可选
type
string
技能（Skill）类型。
可选值：custom（自定义）、official（官方预置）。
可选
files
array
智能体（Agent）已挂载的文件（File）列表。
可选
显示子属性
隐藏子属性
items
object {1}
显示子属性
隐藏子属性
fileID
string
文件标识。
可选
mcpServers
array
智能体（Agent）已配置的 MCP 服务列表。
可选
显示子属性
隐藏子属性
items
object {3}
显示子属性
隐藏子属性
type
string
MCP 服务接入类型。
可选
name
string
MCP 服务名称。
可选
url
string
MCP 服务地址。
可选
tools
array
智能体（Agent）已配置的自定义工具列表。
可选
显示子属性
隐藏子属性
items
object {3}
显示子属性
隐藏子属性
name
string
工具名称；同一 Agent 或 Session 内唯一。
可选
description
string
工具描述。
可选
inputSchema
object
工具输入结构。
可选
显示子属性
隐藏子属性
createdAt
string
创建时间，ISO 8601 格式，带时区偏移。
可选
updatedAt
string
最近更新时间，ISO 8601 格式，带时区偏移，可能包含小数秒。
可选
nextCursor
stringintegernull
下一页游标；无下一页时为 null。
查询下一页时将该值作为请求参数 cursor 传入。
可选
hasMore
boolean
是否还有下一页。true：有下一页。false：已是最后一页。
可选
响应示例
{
"data": [
{
"id": "agt_9678f97b20ae",
"name": "企业知识助理",
"description": "面向团队的知识检索与文档总结助手。",
"version": 2,
"system": "回答前先检索企业资料；无法确认时明确说明。",
"skills": [
{
"skillID": "46865062-6fb0-4d7b-6531-fadd8008452f",
"releaseID": "17a9f5b7-bbc3-4cb3-b486-20c910eb4b1d"
}
],
"files": [
{
"fileID": "file-01a00b4b7718758ba1410a23e9522dc7"
}
],
"mcpServers": [
{
"url": "<MCP_SERVER_URL>",
"name": "ticket",
"type": "url"
}
],
"tools": [
{
"name": "query_order_status",
"description": "根据订单 ID 查询当前状态。",
"inputSchema": {
"type": "object",
"properties": {
"orderId": {
"type": "string"
}
},
"required": [
"orderId"
]
}
}
],
"createdAt": "2026-09-03T11:08:05+08:00",
"updatedAt": "2026-09-03T11:18:03.758889+08:00"
},
{
"id": "agt_0464d55dc0b6",
"name": "大作战·222",
"description": "DuMate 大作战自动参战 agent",
"version": 1,
"system": "你是 DuMate 大作战中的角色「222」。战斗风格：攻击333……",
"skills": [],
"files": [],
"mcpServers": [
{
"url": "<MCP_SERVER_URL>",
"name": "battle",
"type": "url"
}
],
"createdAt": "2026-09-02T20:25:09+08:00",
"updatedAt": "2026-09-02T20:25:09+08:00"
},
{
"id": "agt_0a5ded593c99",
"name": "大作战·111",
"description": "DuMate 大作战自动参战 agent",
"version": 1,
"system": "你是 DuMate 大作战中的角色「111」。战斗风格：攻击222……",
"skills": [],
"files": [],
"mcpServers": [
{
"url": "<MCP_SERVER_URL>",
"name": "battle",
"type": "url"
}
],
"createdAt": "2026-09-02T20:24:53+08:00",
"updatedAt": "2026-09-02T20:24:53+08:00"
},
{
"id": "agt_91d472ffc205",
"name": "大作战·workbuddy小兵5",
"description": "DuMate 大作战自动参战 agent",
"version": 1,
"system": "你是 DuMate 大作战中的角色「workbuddy小兵5」。战斗风格：攻击力弱……",
"skills": [],
"files": [],
"mcpServers": [
{
"url": "<MCP_SERVER_URL>",
"name": "battle",
"type": "url"
}
],
"createdAt": "2026-09-02T17:36:12+08:00",
"updatedAt": "2026-09-02T17:36:12+08:00"
}
],
"nextCursor": "1788341772000000",
"hasMore": true
}评价此篇文章