GET
https://api.dumate.cn/api/v1/agents/{agentId}
本接口用于查询单个智能体（Agent）的详细配置，包含模型、系统提示词、已挂载的技能（Skill）、文件（File）和 MCP 服务（MCP Server）。
权限说明
使用 API Key 鉴权调用 API 流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
URL 参数
agentId
string
待查询的智能体（Agent）标识。
必选
Query 参数
version
integer
指定查询的智能体（Agent）版本。
传入时返回该指定版本的配置；不传时返回智能体当前版本的配置。
可选
请求结构
GET /api/v1/agents/{agentId}?version=2 HTTP/1.1
Host: api.dumate.cn
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json
示例代码
请求示例
curl --location --request GET "https://api.dumate.cn/api/v1/agents/agt_5fee9239d593" \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <YOUR_API_KEY>'返回响应
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 {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 服务列表。
可选
显示子属性
隐藏子属性
items
object {3}
显示子属性
隐藏子属性
type
string
MCP 服务接入类型。
可选
name
string
MCP 服务名称。
可选
url
string
MCP 服务地址。
可选
tools
array
智能体（Agent）已配置的自定义工具列表。
可选
显示子属性
隐藏子属性
items
object {3}
显示子属性
隐藏子属性
name
string
工具名称；同一 Agent 或 Session 内唯一。
可选
description
string
工具描述。
可选
inputSchema
object
工具输入结构。
可选
显示子属性
隐藏子属性
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>"
}
],
"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:18:03.758889+08:00"
}