ListCustomAgent 获取个人空间、工作空间中所有自定义Agent列表
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
dms:ListCustomAgent |
list |
*全部资源
|
无 | 无 |
请求语法
POST HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| WorkspaceId |
string |
否 |
工作空间 ID。 |
56kv1pvl9uvt9**********bb |
| SearchKey |
string |
否 |
搜索关键词，支持自定义 Agent 名称和描述模糊搜索。 |
测试Agent |
| Status |
string |
否 |
自定义 Agent 状态。 枚举值：
|
RELEASED |
| QueryAllReleased |
boolean |
否 |
查询所有已发布状态的自定义 Agent，默认为 false。 |
true |
| PageNumber |
integer |
否 |
分页页码，从 1 开始。 |
1 |
| PageSize |
integer |
否 |
每页记录数，默认 20。 |
20 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
Id of the request |
67E910F2-4B62-5B0C-ACA3-7547695C**** |
| Success |
boolean |
请求是否成功，返回值如下：
|
true |
| ErrorCode |
string |
错误码。 |
success |
| ErrorMessage |
string |
调用失败时，返回的错误信息。 |
Specified parameter Tid is not valid. |
| Data |
object |
返回的结构体 |
|
| Content |
array<object> |
数据内容列表 |
|
|
array<object> |
数据内容对象 |
||
| CustomAgentId |
string |
自定义 Agent Id |
ca-4y3ca4khkcu**********ysf |
| Name |
string |
自定义 Agent 名称 |
Agent测试名称 |
| Description |
string |
自定义 Agent 描述 |
Agent测试描述 |
| DataJson |
string |
指定的数据范围，JSON 字符串格式 |
{ "tableFlag" : true, "scope" : "personal", "personal" : { "DataSourceType" : "remote_data_center", "FileId" : "f-5qlrwaw10********s3gpw1z", "Database" : "测试表格******.xlsx", "Tables" : [ "Sheet1" ], "TableIds" : [ "******" ], "RegionId" : "cn-hangzhou" } } |
| Instruction |
string |
指示 |
分析框架： 1、需按日、周、月维度监控核心指标（GMV、订单量、UV、转化率），分析趋势变化及同比/环比波动； 2、划分新老客、渠道、地域进行拆解，识别增长来源与短板； 3、结合用户行为路径（浏览→加购→支付）开展漏斗分析，定位流失环节； |
| Knowledge |
string |
知识 |
核心指标定义： 1、GMV（成交总额）指订单金额总和，含已支付及未支付成功订单； 2、订单量为每日有效下单笔数； 3、UV（独立访客）指访问网站或APP的去重用户数； 4、转化率=支付订单数 / UV，反映流量转化效率； |
| Status |
string |
自定义 Agent 状态 枚举值：
|
RELEASED |
| ReleaseTime |
string |
发布时间 |
2025-12-11T14:04:32.000+00:00 |
| OfflineTime |
string |
下线时间 |
2025-12-11T14:04:32.000+00:00 |
| Modifier |
string |
修改人 |
20372822******** |
| WorkspaceId |
string |
工作空间 ID |
56kv1pvl9uvt9**********bb |
| Region |
string |
地域 |
cn-hangzhou |
| AliyunUid |
string |
阿里云账户 ID |
20372822******** |
| AliyunParentId |
string |
阿里主账户 ID |
16738266******** |
| DmsUnit |
string |
当前 DMS 单元 |
cn-hangzhou |
| GmtCreated |
string |
创建时间 |
2025-12-11T14:04:32.000+00:00 |
| GmtModified |
string |
修改时间 |
2025-12-11T14:04:32.000+00:00 |
| KnowledgeConfigList |
array<object> |
||
|
object |
|||
| AccessType |
string |
||
| McpServerId |
string |
||
| ExecutionConfig |
object |
执行配置 |
|
| SkipPlan |
boolean |
是否跳过计划确认步骤 |
true |
| SkipSqlConfirm |
boolean |
是否跳过所有 SQL 确认 |
true |
| SkipWebReportConfirm |
boolean |
是否跳过绘制网页报告确认 |
false |
| SkipAskHuman |
boolean |
是否禁止过程中用户询问 |
false |
| TextReportConfig |
string |
文字报告格式 |
文字报告要求所有数字不使用阿拉伯数字，全部转为中文数字 |
| WebReportConfig |
string |
网页报告格式 |
网页报告要求所有数字不使用阿拉伯数字，全部转为中文数字 |
| CreatorUserName |
string |
创建者名称 |
HaoY***** |
| ModifierUserName |
string |
修改者名称 |
HaoY***** |
| PageNumber |
integer |
分页页码。 |
1 |
| PageSize |
integer |
每页记录数。 |
20 |
| TotalElements |
integer |
总记录数。 |
5 |
| TotalPages |
integer |
分页总页数。 |
1 |
示例
正常返回示例
JSON格式
{
"RequestId": "67E910F2-4B62-5B0C-ACA3-7547695C****",
"Success": true,
"ErrorCode": "success",
"ErrorMessage": "Specified parameter Tid is not valid.",
"Data": {
"Content": [
{
"CustomAgentId": "ca-4y3ca4khkcu**********ysf",
"Name": "Agent测试名称",
"Description": "Agent测试描述",
"DataJson": "{\n \"tableFlag\" : true,\n \"scope\" : \"personal\",\n \"personal\" : {\n \"DataSourceType\" : \"remote_data_center\",\n \"FileId\" : \"f-5qlrwaw10********s3gpw1z\",\n \"Database\" : \"测试表格******.xlsx\",\n \"Tables\" : [ \"Sheet1\" ],\n \"TableIds\" : [ \"******\" ],\n \"RegionId\" : \"cn-hangzhou\"\n }\n}",
"Instruction": "分析框架：\n1、需按日、周、月维度监控核心指标（GMV、订单量、UV、转化率），分析趋势变化及同比/环比波动；\n2、划分新老客、渠道、地域进行拆解，识别增长来源与短板；\n3、结合用户行为路径（浏览→加购→支付）开展漏斗分析，定位流失环节；",
"Knowledge": "核心指标定义：\n1、GMV（成交总额）指订单金额总和，含已支付及未支付成功订单；\n2、订单量为每日有效下单笔数；\n3、UV（独立访客）指访问网站或APP的去重用户数；\n4、转化率=支付订单数 / UV，反映流量转化效率；",
"Status": "RELEASED",
"ReleaseTime": "2025-12-11T14:04:32.000+00:00",
"OfflineTime": "2025-12-11T14:04:32.000+00:00",
"Modifier": "20372822********",
"WorkspaceId": "56kv1pvl9uvt9**********bb",
"Region": "cn-hangzhou",
"AliyunUid": "20372822********",
"AliyunParentId": "16738266********",
"DmsUnit": "cn-hangzhou",
"GmtCreated": "2025-12-11T14:04:32.000+00:00",
"GmtModified": "2025-12-11T14:04:32.000+00:00",
"KnowledgeConfigList": [
{
"AccessType": "",
"McpServerId": ""
}
],
"ExecutionConfig": {
"SkipPlan": true,
"SkipSqlConfirm": true,
"SkipWebReportConfirm": false,
"SkipAskHuman": false
},
"TextReportConfig": "文字报告要求所有数字不使用阿拉伯数字，全部转为中文数字",
"WebReportConfig": "网页报告要求所有数字不使用阿拉伯数字，全部转为中文数字",
"CreatorUserName": "HaoY*****",
"ModifierUserName": "HaoY*****"
}
],
"PageNumber": 1,
"PageSize": 20,
"TotalElements": 5,
"TotalPages": 1
}
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。