创建智能体
本接口用于创建智能体(Agent),可在创建时同时挂载文件(File)、技能(Skill)和 MCP 服务(MCP Server)。
创建成功后返回智能体标识 id 和版本号 version(首次创建为 1)。后续更新智能体配置须基于该版本号调用更新智能体接口。
权限说明
使用 API Key 鉴权调用 API 流程,具体调用流程,请查看认证鉴权。
请求参数
智能体(Agent)名称。
智能体(Agent)的用途说明。
长度:小于 64 个字符。
智能体(Agent)的系统提示词。
长度:小于 1000 个字符。
挂载到智能体(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 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"
]
}
}
]
}'
返回响应
智能体(Agent)标识。
智能体(Agent)名称。
智能体(Agent)的用途说明。
智能体(Agent)当前版本号,首次创建为 1。
智能体(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": 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"
}
评价此篇文章
