更新智能体配置
更新时间：2026-09-10
POST
https://api.dumate.cn/api/v1/agents/{agentId}
本接口用于传入版本号和需要更新的字段，更新智能体（Agent）配置。
权限说明
使用 API Key 鉴权调用 API 流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
URL 参数
agentId
string
待更新的智能体（Agent）标识。
必选
Body 参数
version
integer
执行更新所基于的智能体（Agent）版本。
须与当前智能体版本一致。
必选
system
string
更新后的系统提示词。
可选
skills
array
更新后的技能（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 服务地址。
可选
请求结构
POST /api/v1/agents/{agentId} HTTP/1.1
Host: api.dumate.cn
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json
{
"version": 1,
"system": "回答前先检索企业资料；无法确认时明确说明。",
"skills": [
{
"skillID": "skillhub_id",
"releaseID": "<skillReleaseId>"
}
]
}
示例代码
请求示例
curl --location --request POST "https://api.dumate.cn/api/v1/agents/agt_9678f97b20ae" \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--data-raw '{
"version": 1,
"system": "回答前先检索企业资料；无法确认时明确说明。",
"skills": [
{
"skillID": "46865062-6fb0-4d7b-6531-fadd8008452f",
"releaseID": "17a9f5b7-bbc3-4cb3-b486-20c910eb4b1d"
}
],
"files": [
{
"fileID": "file-01a00b4b7718758ba1410a23e9522dc7"
}
],
"mcpServers": [
{
"type": "url",
"name": "ticket",
"url": "<MCP_SERVER_URL>"
}
]
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
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 {2}
显示子属性
隐藏子属性
skillID
string
技能（Skill）标识。
可选
releaseID
string
技能（Skill）发布版本标识。
可选
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 服务地址。
可选
createdAt
string
创建时间，ISO 8601 格式。
可选
updatedAt
string
最近更新时间，ISO 8601 格式。
可选
响应示例
{
"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": [
{
"type": "url",
"name": "ticket",
"url": "<MCP_SERVER_URL>"
}
],
"createdAt": "2026-09-03T11:08:05+08:00",
"updatedAt": "2026-09-03T11:08:05+08:00"
}评价此篇文章