创建DataAgent会话
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
dms:CreateDataAgentSession |
create |
*全部资源
|
无 | 无 |
请求语法
POST HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| DMSUnit |
string |
否 |
当前 DMS 单元 |
cn-hangzhou |
| Title |
string |
否 |
标题，支持中英文，最大长度 128 位。 |
帮我分析一下这份数据，给出报告。 |
| File |
string |
否 |
文件 Id |
f-8*******01m |
| SessionConfig |
object |
否 |
会话配置信息 |
|
| CustomAgentId |
string |
否 |
自定义 Agent Id |
ca-e*******ckd |
| CustomAgentStage |
string |
否 |
自定义 Agent 的使用阶段：
|
debug |
| EnableSearch |
boolean |
否 |
是否开启联网搜索。 |
false |
| EncryptKey |
string |
否 |
加密秘钥 |
null |
| EncryptType |
string |
否 |
加密方式 |
null |
| KbUuidList |
array |
否 |
知识库 ID 列表 |
|
|
string |
否 |
知识库 ID |
KB-HZ-78cd5********9a |
|
| Language |
string |
否 |
语言
|
CHINESE |
| McpHeaders |
array<object> |
否 |
MCP header 配置信息列表 |
|
|
array<object> |
否 |
|||
| McpHeader |
array<object> |
否 |
MCP header 配置信息 |
|
|
object |
否 |
|||
| Key |
string |
否 |
需在 Header 中添加的键 |
UserId |
| Value |
string |
否 |
需在 Header 中添加的值 |
421****571 |
| McpServerId |
string |
否 |
MCP Server 的 Id |
1fl4r*****1qi |
| McpServerIds |
array |
否 |
会话配置中的 MCP 服务器 ID 列表 |
|
|
string |
否 |
会话配置中的 MCP 服务器 ID |
2q1tu90**********6uttu2nw |
|
| Mode |
string |
否 |
模式：
|
ANALYSIS |
| ReportPageWidth |
integer |
否 |
报告页面宽度 |
0 |
| ReportWaterMark |
string |
否 |
报告水印 |
null |
| UserOssBucket |
string |
否 |
用户 OSS Bucket 名称
|
user-oss-bucket |
| WorkspaceId |
string |
否 |
工作空间 ID。 |
12**** |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| Data |
object |
返回结构体 |
|
| AgentId |
string |
Agent Id |
cu0cs*******mf |
| AgentStatus |
string |
Agent 状态 |
RUNNING |
| CreateTime |
integer |
会话的创建时间 |
1765262307992 |
| File |
string |
文件的基本信息。 |
f-8*******01m |
| Saved |
boolean |
是否被当前登录人收藏 |
false |
| SessionConfig |
object |
会话配置信息 |
|
| CustomAgentId |
string |
自定义 Agent Id |
ca-e*******ckd |
| CustomAgentStage |
string |
自定义 Agent 的使用阶段：
|
debug |
| EnableSearch |
boolean |
是否开启联网搜索。 |
true |
| EncryptKey |
string |
加密密钥 |
null |
| EncryptType |
string |
加密类型 |
null |
| KbUuidList |
array |
知识库 ID 列表 |
|
|
string |
知识库 ID |
KB-HZ-78cd5********9a |
|
| Language |
string |
语言
|
CHINESE |
| McpServerIds |
array |
会话配置中的 MCP 服务器 ID 列表 |
|
|
string |
会话配置中的 MCP 服务器 ID |
2q1tu90**********6uttu2nw |
|
| Mode |
string |
模式：
|
ANALYSIS |
| ReportPageWidth |
integer |
报告页面宽度 |
0 |
| ReportWaterMark |
string |
报告水印 |
null |
| UserOssBucket |
string |
用户 OSS Bucket 名称
|
user-oss-bucket |
| SessionId |
string |
Agent 会话 Id |
976*********p |
| SessionStatus |
string |
会话状态 |
RUNNING |
| Title |
string |
标题 |
帮我分析一下这份数据，给出报告。 |
| ErrorCode |
string |
错误码。 |
success |
| ErrorMessage |
string |
调用失败时，返回的错误信息。 |
UnknownError |
| RequestId |
string |
Id of the request |
1CB***********3F1A |
| Success |
boolean |
请求是否成功，返回值如下：
|
true |
示例
正常返回示例
JSON格式
{
"Data": {
"AgentId": "cu0cs*******mf",
"AgentStatus": "RUNNING",
"CreateTime": 1765262307992,
"File": "f-8*******01m",
"Saved": false,
"SessionConfig": {
"CustomAgentId": "ca-e*******ckd",
"CustomAgentStage": "debug",
"EnableSearch": true,
"EncryptKey": "null",
"EncryptType": "null",
"KbUuidList": [
"KB-HZ-78cd5********9a"
],
"Language": "CHINESE",
"McpServerIds": [
"2q1tu90**********6uttu2nw"
],
"Mode": "ANALYSIS",
"ReportPageWidth": 0,
"ReportWaterMark": "null",
"UserOssBucket": "user-oss-bucket"
},
"SessionId": "976*********p",
"SessionStatus": "RUNNING",
"Title": "帮我分析一下这份数据，给出报告。"
},
"ErrorCode": "success",
"ErrorMessage": "UnknownError",
"RequestId": "1CB***********3F1A",
"Success": true
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。