更新智能体配置
本接口用于传入版本号和需要更新的字段，更新智能体（Agent）配置。
权限说明
使用 API Key 鉴权调用 API 流程，具体调用流程，请查看认证鉴权。
请求参数
待更新的智能体（Agent）标识。
执行更新所基于的智能体（Agent）版本。
须与当前智能体版本一致。
更新后的系统提示词。
更新后的技能（Skill）列表。
显示子属性
隐藏子属性
显示子属性
隐藏子属性
技能（Skill）标识。
技能（Skill）发布版本标识。
技能（Skill）类型。
可选值：custom（自定义）、official（官方预置）。
挂载到智能体（Agent）的文件（File）列表。
显示子属性
隐藏子属性
显示子属性
隐藏子属性
文件标识。
智能体（Agent）可连接的 MCP 服务（MCP Server）列表。
显示子属性
隐藏子属性
显示子属性
隐藏子属性
MCP 服务接入类型，示例为 url。
MCP 服务名称。
MCP 服务地址。
更新后的自定义工具配置列表。
显示子属性
隐藏子属性
显示子属性
隐藏子属性
工具名称；同一 Agent 或 Session 内唯一。
工具描述。
工具输入结构，包含 type、properties 和 required。
显示子属性
隐藏子属性
工具输入结构类型，通常为 object。
工具输入参数声明。
显示子属性
隐藏子属性
工具输入必传参数。
显示子属性
隐藏子属性
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>"
}
],
"tools": [
{
"name": "query_order_status",
"description": "根据订单 ID 查询当前状态。",
"inputSchema": {
"type": "object",
"properties": {
"orderId": {
"type": "string"
}
},
"required": [
"orderId"
]
}
}
]
}'返回响应
智能体（Agent）标识。
智能体（Agent）名称。
智能体（Agent）的用途说明。
智能体（Agent）当前版本号，更新成功后在请求所基于的版本上递增。
模型配置对象。
显示子属性
隐藏子属性
智能体（Agent）使用的模型名称。
智能体（Agent）的系统提示词。
智能体（Agent）已挂载的技能（Skill）列表。
显示子属性
隐藏子属性
显示子属性
隐藏子属性
技能（Skill）标识。
技能（Skill）发布版本标识。
技能（Skill）类型。
可选值：custom（自定义）、official（官方预置）。
智能体（Agent）已挂载的文件（File）列表。
显示子属性
隐藏子属性
显示子属性
隐藏子属性
文件标识。
智能体（Agent）已配置的 MCP 服务列表。
显示子属性
隐藏子属性
显示子属性
隐藏子属性
MCP 服务接入类型。
MCP 服务名称。
MCP 服务地址。
智能体（Agent）已配置的自定义工具列表。
显示子属性
隐藏子属性
显示子属性
隐藏子属性
工具名称；同一 Agent 或 Session 内唯一。
工具描述。
工具输入结构。
显示子属性
隐藏子属性
创建时间，ISO 8601 格式，带时区偏移。
最近更新时间，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>"
}
],
"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"
}评价此篇文章