跳到主要内容

提交批量监控任务

接口地址: POST /task/batch/shared

接口描述: 提交批量监控任务,支持多个问题共享相同的平台配置,自动创建子任务并异步执行

需要认证:

请求参数

请求示例:

{
"prompts": [
"请帮我搜索最新款 iPhone型号,以及 iOS 版本",
"请帮我推荐一款只能手机"
],
"platforms": [
{"platform": "doubao", "mode": "reasoning_search", "screenshot": 1},
{"platform": "yuanbao", "mode": "search", "screenshot": 1}
],
"regionCode": ["410100"]
}

参数说明:

字段名类型必需描述示例值
monitorKeywordsString监控关键词"华为"
promptsList<String>监控提示词列表,每个提示词生成一个子任务,最多 50 个["人工智能的发展趋势"]
platformsList<PlatformConfig>平台配置列表,详见下方说明,最多 50 个,同一平台名称重复时自动去重-
regionCodeList<String>区域代码列表,指定爬虫使用的代理 IP 城市/省份,格式为行政区划代码(如:410100-郑州市)。可用代码通过 /api/business/eip-edge/ports/city-info 接口获取,详见获取可用城市代理当前仅支持指定 1 个 regionCode(数组长度必须为 1)["410100"]
callbackUrlString任务完成后的回调地址(可选,未提供时使用用户配置的默认回调地址)"https://your-domain.com/callback"

PlatformConfig 对象说明:

字段名类型必需描述可选值
platformStringAI平台名称"deepseek"、"doubao"、"yuanbao" 等
modeString监控模式,详见概述"standard"、"reasoning"、"search"、"reasoning_search"
screenshotInteger是否截图(默认:0)0-不截图、1-截图、2-提及截图

参数去重规则

系统会对提交的参数自动去重处理,确保不会为同一问题重复创建相同平台的监控任务:

  • platforms 去重:按 platform 名称(不区分大小写)去重,保留首次出现的配置。例如提交 3 个 deepseek + 1 个 kimi,实际只会创建 deepseekkimi 共 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"
}
]
}
}

响应字段说明:

字段名类型描述
taskIdString批量任务ID(UUID格式)
totalTaskInteger子任务总数
statusString任务状态(pending-待执行)
pollUrlString状态轮询地址
subTaskListArray子任务列表
subTaskList[].subTaskIdString子任务ID
subTaskList[].promptString监控提示词
subTaskList[].platformStringAI平台
subTaskList[].modeString监控模式
subTaskList[].statusString子任务状态