You need to enable JavaScript to run this app.
数据智能体 DataAgent(私有化)

数据智能体 DataAgent(私有化)

复制全文
数据智能分析
获取可用分析能力
复制全文
获取可用分析能力

在获得基础查询结果后,您需要通过此接口先确定当前数据查询结果可以使用哪些智能分析能力(Insight Ability)。

前提条件

智能分析Agent为您提供了数据高级分析的OpenAPI接口,您可以调用接口对数据查询结果进行归因分析、异常分析等高级分析。

  • 进行高级分析前,您需要先发起数据查询,获取数据查询结果的historyIdsessionId,后续使用数据高级分析接口时需在请求参数中通过指定historyIdsessionId来指定进行高级分析的数据查询结果。
  • 发起数据查询时,建议使用新版的问数接口:
    • 创建好会话后即可获取对应会话的sessionId,详情请参见:创建会话
    • 数据查询结果会通过聊天补全接口流式返回,事件流type=resultstatus=success时,事件内result字段中会包含查询结果的historyId,详情可参见聊天补全

请求说明
  • 请求方式:GET
  • 请求地址:{domain}/dataAgent/llm/openApi/v2/agent/insightAbilities

请求参数

参数

类型

是否必选

示例值

描述

historyId

int

12886163

当次的会话结果ID,例如,对于模糊问题拆解为多个子问题进行问数时,每个子问题的结果均会有一个会话结果ID。
以使用新版问数OpenAPI为例,需要配置为聊天补全(chatCompletion)接口返回的事件流type=resultstatus=success时,事件内result字段中的historyId,详情可参见聊天补全

返回参数

接口返回一个 insightAbilities 列表,其中每个对象代表一项可用的分析能力。您需要关注 ability_code(能力编码)和 enable(是否可用)字段。

参数

类型

示例值

描述

insightAbilities

list

详情参见下文的返回示例

insightAbilities 列表中每个对象代表一项可用的分析能力,通过每项分析能力中的 ability_code(能力编码)和 enable(是否可用)字段来标识当前查询结果是否可以使用对应的分析能力。

insightAbilities.ability_code

string

attribution

标识分析能力的唯一编码,主要包括:

  • attribution: 归因分析
  • anomaly: 异常检测
  • interpret: 数据解读

insightAbilities.enable

boolean

true

表示该能力在当前数据查询结果的上下文中是否可用。

insightAbilities.cause

string

详情参见下文的返回示例

如果当前数据查询结果的上下文中不支持使用对应的分析能力时,会在cause字段中给出不支持使用的原因描述。

insightAbilities.ability_params

list

详情参见下文的返回示例

对应分析能力的具体参数。不同分析能力包含的参数不同,可与控制台界面的操作类似。
例如,归因分析能力,返回结果中会包含归因指标、归因维度、基准日期、观察日期,同时为您识别返回对应参数的推荐取值,结果与界面操作类似。
Image
不同分析能力的参数可参考界面操作文档:数据解读异常检测归因分析

返回示例

以下是一个返回示例,展示了多种分析能力及其状态。

{
    "code": "llm/ok",
    "data": {
        "insightAbilities": [
            {
                "ability_code": "attribution",
                "ability_name": "归因",
                "enable": false,
                "cause": "没有时间字段",
                "ability_params": [
                    // ... 省略具体参数
                ]
            },
            {
                "ability_code": "anomaly",
                "ability_name": "异常检测",
                "enable": false,
                "cause": "没有时间字段",
                "ability_params": [
                    // ... 省略具体参数
                ]
            },
            {
                "ability_code": "interpret",
                "ability_name": "解读",
                "enable": true,
                "cause": "",
                "ability_params": [
                    // ... 省略具体参数
                ]
            }
        ]
    }
}
最近更新时间:2025.12.19 15:20:13
这个页面对您有帮助吗?
有用
有用
无用
无用