请求方法

POST

请求 URL

{domain}/dataAgent/llm/openApi/v2/deepresearch/executeTask

Content-Type

application/json

响应模式

stream=true → SSE；stream=false → JSON

超时建议

≥ 600s

stream

bool

是

是否开启 SSE

content

string

是

用户问题。可在文本中指定 SKILL，如 @[skill](60)

contextId

string

否

多轮会话标识；首轮不传，续轮传上一轮 task_detail 返回的 contextId

metadata

TaskMetaData

是

任务元信息

pushNotificationConfig

object

否

异步推送通知配置

agentId

int

是

1

智能体 ID。无特殊需求可用通用智能体

enableKnowledgeQA

bool

是

true

新接入必须传 true（数据问答模式）

enableRunningStepOutput

bool

是

true

必须传 true 才能拿到中间过程产物

sessionId

int

否

12013496

多轮场景必传，来自上一轮 task_detail

language

enum

否

zh_cn / zh-cn / en_us / en-us

输出语言

enableLarkQa

bool

否

false

启用企业知识库（仅域内，ToB 暂不支持）

enableWebSearch

bool

否

false

启用联网搜索

enableDeepThinkingMode

bool

否

false

启用深度思考

fileList

List[string]

否

["storage-A"]

额外分析的文件 storageKey；先调上传接口拿到

dataSetList

List[object]

否

[{"id":1,"appId":1}]

额外数据集；垂类智能体已配数据集可省

reportList

List[object]

否

[{"reportId":1,"appId":1,"dashboardId":1,"sheetId":1}]

额外可视化图表

externalContext

object

否

{
"externalContext": {
"oncallNotice": "公告信息",
"experimentMetadata": "实验信息",
"similarFaq": ["关联 FAQ"],
"chunks": [
{
"title": "chunk 标题",
"url": "chunk url",
"content": "chunk 内容"
}
]
}
}

支持字段为
oncallNotice、experimentMetadata、similarFaq、chunks，其中 chunks[] 包含 title、url、content

id

string

否

push-1

推送通道标识

url

string

是

https://example.com/webhook

接受推送的 URL

token

string

否

123456

接收方验证 token

authentication.schemes

List[string]

否

["Bearer"] 或 ["ApiKey"]

认证方式

authentication.credentials

string

否

sk-12345 或 key:value

认证凭证