创建智能体
本接口用于创建智能体（Agent），定义系统提示词、工具、MCP 服务和技能（Skill）。智能体是创建会话的前提。
创建成功后返回智能体对象，其中 id 为智能体标识，version 为版本号，创建时为 1，每次更新加 1。
权限说明
使用 API Key 鉴权调用 API 流程，具体调用流程，请查看认证鉴权。
请求参数
智能体（Agent）名称。
长度：1–256 个字符。
智能体（Agent）的系统提示词。
长度：不超过 100000 个字符。
智能体（Agent）的用途说明。
长度：不超过 2048 个字符。
工具配置列表。
所有工具集合计最多 256 个工具；不传 agent_toolset_20260401 时默认支持所有内置工具。
显示子属性
隐藏子属性
显示子属性
隐藏子属性
工具类型。
可选值：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。
显示子属性
隐藏子属性
引用的 MCP 服务名称，须与 mcp_servers 中某个服务的 name 一致。
type 为 mcp_toolset 时必填。
自定义工具名称，长度 1–64。
type 为 custom 时必填。
自定义工具描述。
type 为 custom 时必填。
工具输入结构，JSON Schema 格式。
type 为 custom 时必填。
显示子属性
隐藏子属性
工具输入结构类型，固定为 object。
工具输入参数声明。
显示子属性
隐藏子属性
工具输入必传参数。
显示子属性
隐藏子属性
智能体（Agent）可连接的 MCP 服务（MCP Server）列表。
最多 20 个，name 不可重复；每个服务必须被 tools 中的 mcp_toolset 引用。
显示子属性
隐藏子属性
显示子属性
隐藏子属性
MCP 服务接入类型，固定为 url。
MCP 服务名称，长度 1–255，供 tools 中 mcp_toolset 的 mcp_server_name 引用。
MCP 服务地址，长度不超过 2048 个字符。
挂载到智能体（Agent）的技能（Skill）列表。
显示子属性
隐藏子属性
显示子属性
隐藏子属性
技能（Skill）类型，固定为 custom。
技能（Skill）标识，长度 1–64。
技能版本标识，取技能接口返回的版本标识；省略时自动使用最新版本。
自定义键值，最多 16 对。
键最长 64 个字符，值最长 512 个字符。
显示子属性
隐藏子属性
执行身份，选填。当前只支持 {"type": "service_account"}，省略时等同于此；传入其他 type 返回 400。
显示子属性
隐藏子属性
挂载到智能体的文件列表。
显示子属性
隐藏子属性
显示子属性
隐藏子属性
文件标识，长度 1–128，取上传文件接口返回的 id；文件不存在时返回 404。
POST /api/dma/v1/agents HTTP/1.1
Host: api.dumate.cn
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json示例代码
curl --location --request POST "https://api.dumate.cn/api/dma/v1/agents" \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"name": "demo-agent",
"system": "You are a helpful assistant.",
"tools": [
{
"type": "agent_toolset_20260401",
"default_config": {
"permission_policy": {
"type": "always_ask"
}
}
},
{
"type": "custom",
"name": "get_order_status",
"description": "查询订单状态",
"input_schema": {
"type": "object",
"properties": {
"order_id": {
"type": "string"
}
},
"required": [
"order_id"
]
}
}
]
}'返回响应
资源类型标识，固定为 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。
技能版本标识，取技能接口返回的版本标识；省略时自动使用最新版本。
自定义键值。
显示子属性
隐藏子属性
版本号，创建时为 1，每次更新加 1。
创建时间，RFC 3339 格式，UTC。
最近更新时间，RFC 3339 格式，UTC。
归档时间，RFC 3339 格式，UTC；未归档时为 null。
{
"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"
}
}
},
{
"type": "custom",
"name": "get_order_status",
"description": "查询订单状态",
"input_schema": {
"type": "object",
"properties": {
"order_id": {
"type": "string"
}
},
"required": [
"order_id"
]
}
}
],
"mcp_servers": [],
"skills": [],
"metadata": {},
"version": 1,
"created_at": "2026-11-04T12:40:36Z",
"updated_at": "2026-11-04T12:40:36Z",
"archived_at": null
}评价此篇文章