更新智能体
本接口用于更新智能体（Agent）配置。所有请求 Body 字段均可选，只需传入要修改的字段；可传入 version 进行乐观锁校验，不传时基于最新版本更新。
更新成功后返回更新后的智能体对象，version 加 1。
权限说明
使用 API Key 鉴权调用 API 流程，具体调用流程，请查看认证鉴权。
请求参数
智能体（Agent）标识。
agent 不存在或不属于当前账号时返回 404。
当前版本号，选填。传入时作乐观锁，与服务端最新版本不一致返回 409 conflict_error；不传则直接基于最新版本更新。
智能体（Agent）名称。
长度：1–256 个字符。
传入时整体替换。
智能体（Agent）的系统提示词。
长度：不超过 100000 个字符。
传入时整体替换。
智能体（Agent）的用途说明。
长度：不超过 2048 个字符。
传入时整体替换。
工具配置列表。
所有工具集合计最多 256 个工具。传入时整体替换；传 [] 恢复默认内置工具集 agent_toolset_20260401（全部工具启用、always_allow）。不传时保留当前配置。
显示子属性
隐藏子属性
显示子属性
隐藏子属性
工具类型。
可选值：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。
技能版本标识，取技能接口返回的版本标识；省略时自动使用最新版本。
自定义键值，按键合并。
传入的键覆盖原值，值为 null 的键删除，未传的键保留。
最多 16 对，键最长 64 个字符，值最长 512 个字符。
显示子属性
隐藏子属性
执行身份，选填。当前只支持 {"type": "service_account"}，省略时等同于此；传入其他 type 返回 400。
显示子属性
隐藏子属性
挂载到智能体的文件列表。
显示子属性
隐藏子属性
显示子属性
隐藏子属性
文件标识，长度 1–128，取上传文件接口返回的 id；文件不存在时返回 404。
POST /api/dma/v1/agents/{agent_id} 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/agt_84cdf2ff9c2f" \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"version": 1,
"system": "You are a concise assistant.",
"metadata": {
"team": "demo"
}
}'返回响应
资源类型标识，固定为 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。
{
"type": "agent",
"id": "agt_84cdf2ff9c2f",
"name": "demo-agent",
"description": "",
"system": "You are a concise assistant.",
"tools": [
{
"type": "agent_toolset_20260401",
"default_config": {
"enabled": true,
"permission_policy": {
"type": "always_ask"
}
}
}
],
"mcp_servers": [],
"skills": [],
"metadata": {
"team": "demo"
},
"version": 2,
"created_at": "2026-11-04T12:40:36Z",
"updated_at": "2026-11-04T13:05:12Z",
"archived_at": null
}评价此篇文章