在获得基础查询结果后,您需要通过此接口先确定当前数据查询结果可以使用哪些智能分析能力(Insight Ability)。
智能分析Agent为您提供了数据高级分析的OpenAPI接口,您可以调用接口对数据查询结果进行归因分析、异常分析等高级分析。
historyId 和 sessionId,后续使用数据高级分析接口时需在请求参数中通过指定historyId 或 sessionId来指定进行高级分析的数据查询结果。{domain}/dataAgent/llm/openApi/v2/agent/insightAbilities参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
historyId | int | 是 | 12886163 | 当次的会话结果ID,例如,对于模糊问题拆解为多个子问题进行问数时,每个子问题的结果均会有一个会话结果ID。 |
接口返回一个 insightAbilities 列表,其中每个对象代表一项可用的分析能力。您需要关注 ability_code(能力编码)和 enable(是否可用)字段。
参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|
insightAbilities | list | 详情参见下文的返回示例 |
|
insightAbilities.ability_code | string | attribution | 标识分析能力的唯一编码,主要包括:
|
insightAbilities.enable | boolean | true | 表示该能力在当前数据查询结果的上下文中是否可用。 |
insightAbilities.cause | string | 详情参见下文的返回示例 | 如果当前数据查询结果的上下文中不支持使用对应的分析能力时,会在cause字段中给出不支持使用的原因描述。 |
insightAbilities.ability_params | list | 详情参见下文的返回示例 | 对应分析能力的具体参数。不同分析能力包含的参数不同,可与控制台界面的操作类似。 |
以下是一个返回示例,展示了多种分析能力及其状态。
{ "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": [ // ... 省略具体参数 ] } ] } }