百度搭子 DuMate｜真干活，用搭子：AI助手，复杂任务一句话搞定

POST

https://api.dumate.cn/api/v1/agents

本接口用于创建智能体（Agent），可在创建时同时挂载文件（File）、技能（Skill）和 MCP 服务（MCP Server）。

创建成功后返回智能体标识 id 和版本号 version（首次创建为 1）。后续更新智能体配置须基于该版本号调用更新智能体接口。

权限说明

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

请求参数

Headers 参数

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

Body 参数

name string

智能体（Agent）名称。

必选

description string

智能体（Agent）的用途说明。
长度：小于 64 个字符。

可选

system string

智能体（Agent）的系统提示词。
长度：小于 1000 个字符。

可选

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 服务（MCP Server）列表。

可选

显示子属性隐藏子属性

items object {3}

显示子属性隐藏子属性

type string

MCP 服务接入类型，示例为 url。

可选

name string

MCP 服务名称。

可选

url string

MCP 服务地址。

可选

tools array

自定义工具配置列表。

可选

显示子属性隐藏子属性

items object {3}

显示子属性隐藏子属性

name string

工具名称；同一 Agent 或 Session 内唯一。

可选

description string

工具描述。

可选

inputSchema object {3}

工具输入结构，包含 type、properties 和 required。

可选

显示子属性隐藏子属性

type string

工具输入结构类型，通常为 object。

可选

properties object

工具输入参数声明。

可选

显示子属性隐藏子属性

required array

工具输入必传参数。

可选

显示子属性隐藏子属性

items string

请求结构


POST /api/v1/agents HTTP/1.1
Host: api.dumate.cn
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

{
  "name": "企业知识助理",
  "description": "面向团队的知识检索与文档总结助手。",
  "system": "回答前先检索企业资料；无法确认时明确说明。",
  "skills": [
    {
      "skillID": "skillhub_id",
      "releaseID": "<skillReleaseId>"
    }
  ],
  "files": [
    {
      "fileID": "file_****bd291"
    }
  ],
  "mcpServers": [
    {
      "type": "url",
      "name": "ticket",
      "url": "<MCP_SERVER_URL>"
    }
  ]
}

示例代码

请求示例

curl --location --request POST "https://api.dumate.cn/api/v1/agents" \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--data-raw '{
    "name": "企业知识助理",
    "description": "面向团队的知识检索与文档总结助手。",
    "system": "回答前先检索企业资料；无法确认时明确说明。",
    "files": [
        {
            "fileID": "file-01a00b4b7718758ba1410a23e9522dc7"
        }
    ],
    "skills": [
        {
            "skillID": "skillhub_id",
            "releaseID": "<skillReleaseId>"
        }
    ],
    "mcpServers": [
        {
            "type": "url",
            "name": "ticket",
            "url": "<MCP_SERVER_URL>"
        }
    ],
    "tools": [
        {
            "name": "query_order_status",
            "description": "根据订单 ID 查询当前状态。",
            "inputSchema": {
                "type": "object",
                "properties": {
                    "orderId": {
                        "type": "string"
                    }
                },
                "required": [
                    "orderId"
                ]
            }
        }
    ]
}'

返回响应

Headers 参数

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

返回参数

id string

智能体（Agent）标识。

可选

name string

智能体（Agent）名称。

可选

description string

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

可选

version integer

智能体（Agent）当前版本号，首次创建为 1。

可选

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 格式，带时区偏移。

可选

响应示例

{
    "id": "agt_9678f97b20ae",
    "name": "企业知识助理",
    "description": "面向团队的知识检索与文档总结助手。",
    "version": 1,
    "system": "回答前先检索企业资料；无法确认时明确说明。",
    "skills": [
        {
            "skillID": "skillhub_id",
            "releaseID": "<skillReleaseId>"
        }
    ],
    "files": [
        {
            "fileID": "file-01a00b4b7718758ba1410a23e9522dc7"
        }
    ],
    "mcpServers": [
        {
            "type": "url",
            "name": "ticket",
            "url": "<MCP_SERVER_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:08:05+08:00"
}