执行智能分析--数据智能体 DataAgent（私有化）-火山引擎

文档中心

立即注册

数据智能体 DataAgent（私有化）

数据智能分析

执行智能分析

在确定要使用的分析能力后，调用此接口以启动一个异步的分析任务。

前提条件

已执行 获取可用分析能力 接口，明确获取当前查询结果可用的分析能力详情，详情请参见获取可用分析能力。

请求说明

请求方式：POST
请求地址：https://{domain}/dataAgent/llm/openApi/v2/agent/insightExecute

请求参数

参数	类型	是否必选	示例值	描述
sessionId	int	是	12886164	会话ID，以使用新版问数OpenAPI为例，需要配置为创建会话时返回结果的sessionInfo中会返回会话ID，详情请参见创建会话。
historyId	int	是	12886163	当次的会话结果ID，例如，对于模糊问题拆解为多个子问题进行问数时，每个子问题的结果均会有一个会话结果ID。以使用新版问数OpenAPI为例，需要配置为聊天补全（chatCompletion）接口返回的事件流`type=result`且`status=success`时，事件内`result`字段中的`historyId`，详情可参见聊天补全。
insightAbility	JSON	是	详情请参见下文的请求示例	执行的智能分析能力。您可以配置为获取可用分析能力接口返回结果中可用的分析能力（"enable": true）的返回结果。其中 ability_params 为对应分析能力的参数对象，您可以直接使用获取可用分析能力接口返回结果中的默认设置，也可根据实际分析需要自行调整。

请求示例

请求体需要传入前序步骤获取的 sessionId、historyId，以及在步骤二中选定的enable 为 true 的 insightAbility 对象。

{
  "sessionId": "{步骤一返回的 sessionId}",
  "historyId": "{步骤一返回的 historyId}",
  "insightAbility": {
    "ability_code": "interpret",
    "ability_name": "解读",
    "enable": true,
    "cause": "",
    "ability_params": [
        // ... 此处为步骤二获取的、与所选 ability_code 对应的 params 对象
    ]
  }
}

返回参数

调用成功后，接口会返回一个包含 data 字段的 JSON 对象，其值是用于获取最终结果的 insightKey。

参数	类型	示例值	描述
data	string	INSIGHT_ANALYSIS_V2:XXXXXXXXXXXXXXXX	最终结果的 `insightKey`。

返回示例

{
    "code": "llm/ok",
    "data": "INSIGHT_ANALYSIS_V2:XXXXXXXXXXXXXXXX",
    "msg": {}
}

最近更新时间：2025.12.19 15:20:13

这个页面对您有帮助吗？

有用

无用