提交批量监控任务
接口地址: POST /task/batch/shared
接口描述: 提交批量监控任务,支持多个问题共享相同的平台配置,自动创建子任务并异步执行
需要认证: 是
请求参数
请求示例:
{
"prompts": [
"请帮我搜索最新款 iPhone型号,以及 iOS 版本",
"请帮我推荐一款只能手机"
],
"platforms": [
{"platform": "doubao", "mode": "reasoning_search", "screenshot": 1},
{"platform": "yuanbao", "mode": "search", "screenshot": 1}
],
"regionCode": ["410100"]
}
参数说明:
| 字段名 | 类型 | 必需 | 描述 | 示例值 |
|---|---|---|---|---|
| monitorKeywords | String | 否 | 监控关键词 | "华为" |
| prompts | List<String> | 是 | 监控提示词列表,每个提示词生成一个子任务,最多 50 个 | ["人工智能的发展趋势"] |
| platforms | List<PlatformConfig> | 是 | 平台配置列表,详见下方说明,最多 50 个,同一平台名称重复时自动去重 | - |
| regionCode | List<String> | 否 | 区域代码列表,指定爬虫使用的代理 IP 城市/省份,格式为行政区划代码(如:410100-郑州市)。可用代码通过 /api/business/eip-edge/ports/city-info 接口获取,详见获取可用城市代理。当前仅支持指定 1 个 regionCode(数组长度必须为 1) | ["410100"] |
| callbackUrl | String | 否 | 任务完成后的回调地址(可选,未提供时使用用户配置的默认回调地址) | "https://your-domain.com/callback" |
PlatformConfig 对象说明:
| 字段名 | 类型 | 必需 | 描述 | 可选值 |
|---|---|---|---|---|
| platform | String | 是 | AI平台名称 | "deepseek"、"doubao"、"yuanbao" 等 |
| mode | String | 是 | 监控模式,详见概述 | "standard"、"reasoning"、"search"、"reasoning_search" |
| screenshot | Integer | 否 | 是否截图(默认:0) | 0-不截图、1-截图、2-提及截图 |
参数去重规则
系统会对提交的参数自动去重处理,确保不会为同一问题重复创建相同平台的监控任务:
- platforms 去重:按
platform名称(不区分大小写)去重,保留首次出现的配置。例如提交 3 个deepseek+ 1 个kimi,实际只会创建deepseek和kimi共 2 个平台的任务 - 任务数计算:
totalTask = prompts数量 × 去重后的platforms数量,请以响应中返回的totalTask为准
响应结果
{
"success": true,
"code": 200,
"message": "批量任务已提交",
"data": {
"taskId": "ec617e1996174c129a872680fa27078e",
"totalTask": 4,
"status": "pending",
"pollUrl": "/api/business/monitor/task/status/ec617e1996174c129a872680fa27078e",
"subTaskList": [
{
"subTaskId": "4124831",
"prompt": "请帮我搜索最新款 iPhone型号,以及 iOS 版本",
"platform": "doubao",
"mode": "reasoning_search",
"status": "pending"
},
{
"subTaskId": "4124832",
"prompt": "请帮我搜索最新款 iPhone型号,以及 iOS 版本",
"platform": "yuanbao",
"mode": "search",
"status": "pending"
},
{
"subTaskId": "4124833",
"prompt": "请帮我推荐一款只能手机",
"platform": "doubao",
"mode": "reasoning_search",
"status": "pending"
},
{
"subTaskId": "4124834",
"prompt": "请帮我推荐一款只能手机",
"platform": "yuanbao",
"mode": "search",
"status": "pending"
}
]
}
}
响应字段说明:
| 字段名 | 类型 | 描述 |
|---|---|---|
| taskId | String | 批量任务ID(UUID格式) |
| totalTask | Integer | 子任务总数 |
| status | String | 任务状态(pending-待执行) |
| pollUrl | String | 状态轮询地址 |
| subTaskList | Array | 子任务列表 |
| subTaskList[].subTaskId | String | 子任务ID |
| subTaskList[].prompt | String | 监控提示词 |
| subTaskList[].platform | String | AI平台 |
| subTaskList[].mode | String | 监控模式 |
| subTaskList[].status | String | 子任务状态 |