POST
https://qianfan.baidubce.com/sessions
本接口用于创建与智能体（Agent）绑定的会话（Session），并可在会话层追加技能（Skill）、凭证空间（Vault）和 MCP 服务（MCP Server）配置。
创建成功后返回会话标识 id，以及会话绑定的智能体版本号。
权限说明
使用 API Key 鉴权调用 API 流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Body 参数
agent
object {1}
会话（Session）绑定的智能体（Agent）。
必选
显示子属性
隐藏子属性
id
string
智能体（Agent）标识。
可选
metadata
object {1}
业务侧自定义元数据。
可选
显示子属性
隐藏子属性
externalTask
string
外部任务标识。
可选
vaultIds
array
会话（Session）可使用的凭证空间（Vault）标识列表。
可选
显示子属性
隐藏子属性
items
string
skills
array
在会话（Session）层追加或覆盖的技能（Skill）列表。
可选
显示子属性
隐藏子属性
items
object {2}
显示子属性
隐藏子属性
skillID
string
技能（Skill）标识。
可选
releaseID
string
技能（Skill）发布版本标识。
可选
mcpServers
array
会话（Session）配置的 MCP 服务（MCP Server）列表。
该字段非空时，vaultIds 也必须非空。
可选
显示子属性
隐藏子属性
items
object {3}
显示子属性
隐藏子属性
type
string
MCP 服务接入类型，示例为 url。
可选
name
string
MCP 服务名称。
可选
url
string
MCP 服务地址。
可选
请求结构
POST /api/v1/sessions HTTP/1.1
Host: api.dumate.cn
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json
{
"agent": {
"id": "agt_demo_7f3a2c"
},
"metadata": {
"externalTask": "task_demo_1001"
},
"vaultIds": [
"<vaultId>"
],
"skills": [
{
"skillID": "skillhub_id",
"releaseID": "<skillReleaseId>"
}
],
"mcpServers": [
{
"type": "url",
"name": "ticket",
"url": "<MCP_SERVER_URL>"
}
]
}示例代码
默认
curl --location --request POST "https://api.dumate.cn/api/v1/sessions" \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--data-raw '{
"agent": {
"id": "agt_07631dfc6723"
},
"skills": [
{
"skillID": "skill_demo_01",
"releaseID": "<skillReleaseId>"
}
],
"vaultIds": [
"vault_f6310fd3d75747a5"
]
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
id
string
会话（Session）标识。
可选
status
string
会话（Session）状态，示例为 idle。
可选
agent
object {2}
会话（Session）绑定的智能体（Agent）版本信息。
可选
显示子属性
隐藏子属性
id
string
智能体（Agent）标识。
可选
version
integer
智能体（Agent）版本号。
可选
skills
array
会话（Session）使用的技能（Skill）列表。
可选
显示子属性
隐藏子属性
items
object {3}
显示子属性
隐藏子属性
skillID
string
技能（Skill）标识。
可选
releaseID
string
技能（Skill）发布版本标识。
可选
type
string
Skill 类型 自定义：custom，官方预置：official
可选
vaultIds
array
会话（Session）可使用的凭证空间（Vault）标识列表。
可选
显示子属性
隐藏子属性
items
string
mcpServers
array
会话（Session）配置的 MCP 服务列表。
可选
显示子属性
隐藏子属性
items
object {3}
显示子属性
隐藏子属性
type
string
MCP 服务接入类型。
可选
name
string
MCP 服务名称。
可选
url
string
MCP 服务地址。
可选
metadata
object {1}
业务侧自定义元数据。
可选
显示子属性
隐藏子属性
externalTaskId
string
外部任务标识。
可选
createdAt
string
创建时间，格式为 ISO 8601。
可选
updatedAt
string
最近更新时间，格式为 ISO 8601。
可选
成功示例
{
"id": "ses_demo_a18d0f",
"status": "idle",
"agent": {
"id": "agt_demo_7f3a2c",
"version": 2
},
"skills": [
{
"skillID": "skillhub_id",
"releaseID": "<skillReleaseId>"
},
{
"skillID": "custom_id",
"releaseID": "<skillReleaseId>"
}
],
"vaultIds": ["<vaultId>"],
"mcpServers": [
{
"type": "url",
"name": "ticket",
"url": "<MCP_SERVER_URL>"
}
],
"metadata": {
"externalTaskId": "task_demo_1001"
},
"createdAt": "2026-07-20T10:00:00+08:00",
"updatedAt": "2026-07-20T10:00:00+08:00"
}