Text2InsightQuery - 发起数据分析请求

向 Analytics Agent 提交一个自然语言问题，发起数据分析任务。

接口说明

本接口为异步接口。调用成功后返回

questionId

questionId

和初始状态

running

running

，表示分析任务已开始执行。客户端需通过 SafeQuestionPoll 接口轮询获取分析结果。

使用须知

问题内容使用自然语言描述，Agent 会自动理解并执行分析
支持通过
```
modelSettings
```
modelSettings
指定使用的模型
同一个 Session 中可以连续发起多个问题，Agent 会保留对话上下文

使用建议

问题描述尽量清晰明确，包含时间范围、维度等关键信息
如需使用知识库辅助分析，可在问题中提示 Agent 查阅知识

请求方式

POST /open/text2insight/query?tenantId={tenantId}&userId={userId}&loginToken={loginToken}

💡 提示：

tenantId

tenantId

、

userId

userId

、

loginToken

loginToken

需要同时出现在 URL query 参数和 request body 中，缺少 query 参数会导致请求失败。

请求参数

参数名	位置	类型	是否必须	说明
tenantId	Query + Body	Integer	是	租户 ID
userId	Query + Body	Integer	是	用户 ID
domainId	Body	Integer	是	数据域 ID
sessionId	Body	Integer	是	对话会话 ID，通过 CreateSession 获取或复用已有值
msg	Body	String	是	问题内容，自然语言描述的分析需求
loginToken	Query + Body	String	是	认证 Token
modelSettings	Body	Object	否	模型配置
modelSettings.model_name	Body	String	否	指定使用的模型名称

返回参数

参数名	类型	说明
success	Boolean	请求是否成功
data.questionId	Integer	问题 ID，用于后续轮询和停止操作
data.sessionId	Integer	会话 ID
data.status	String	当前状态，初始值为 `running` running

请求示例

POST /open/text2insight/query Content-Type: application/json { "tenantId": 10, "userId": 1, "domainId": 106, "sessionId": 4729, "msg": "给我看下北京二手房过去6年销售额，按区看", "loginToken": "eyJhbGciOiJIUzI1NiJ9...", "modelSettings": { "model_name": "qwen/qwen3.6-plus" } }

返回示例

正常返回示例：

{ "success": true, "data": { "questionId": 34339, "sessionId": 4729, "status": "running" } }

后续步骤

请求成功后，使用返回的

questionId