AI分析页配置管理 ​

AI分析页 > 设置 > 配置管理 这一块不是普通表单页，它负责把一条完整的智能分析链路配置出来。

你可以把它理解成四件事：

1. 这条分析要读取哪份数据
2. 这条分析请求怎么连通
3. AI 可以识别哪些字段、哪些指标
4. 分析结果最后要输出成什么样

配置管理列表 ​

先进入 AI分析页 > 设置，你会看到配置管理列表。

这里通常会用到几个动作：

• 新增配置：从零开始配置一条新的分析能力
• 详情：查看现有配置的完整内容
• 编辑：修改已有配置
• 复制：基于现有配置快速做一份相似配置
• 删除：移除不再使用的配置

如果你是第一次接触这一页，建议不要直接从空白开始。 更稳的方式是先打开一条已经能跑通的配置，看清它的结构后再复制一份修改。

新增配置的四步流程 ​

新增一条分析配置，通常会经过四步：

1. 基础配置
2. 接口配置
3. 字段配置
4. AI规则配置

建议你把它理解成一条顺序链路： 先定义“这是干什么的”，再确认“数据怎么取”，再告诉 AI “字段是什么意思”，最后决定“结果怎么说、怎么展示”。

第一步：基础配置 ​

第一步先填写这条分析配置本身的基本信息。

这里建议重点看四项：

• 配置名称 直接写业务主题，让人一眼看懂用途，例如“销售毛利分析”“库存波动分析”“订单趋势分析”
• 描述说明 写清楚这条配置主要解决什么问题，适合谁使用
• 状态 决定这条配置是否启用
• 备注信息 可以记录培训口径、使用范围或补充说明

实操建议：

• 名称不要写得太泛，最好能直接对应业务场景
• 描述不要写技术词，直接写“它帮你分析什么”
• 正式交付前，建议先关闭状态，确认后再启用

如果别人只看名称和描述，就能知道这条配置是干什么的，这一步就算合格了。

第二步：接口配置 ​

第二步决定这条分析要怎么取数，是这一页里最关键的配置部分。

这一页建议分成左右两块理解：

• 左侧：数据查询接口 负责真正取分析数据
• 右侧：Token 获取接口 只有当你的环境需要先拿令牌再访问数据接口时，才需要打开

数据查询接口怎么填 ​

左侧一般会填写这些内容：

• 接口地址
• 请求方式
• 请求头
• 其他参数
• 是否需要把 Token 自动注入进去

用户在这里最重要的不是“自己发明参数”，而是把实施方、接口提供方已经确认好的请求信息按要求填完整。

最稳的做法是：

1. 先拿到一份可用的接口示例
2. 按示例填写地址、方式、请求头和参数
3. 点击 接口测试
4. 确认返回正常后再进入下一步

Token 获取接口什么时候开 ​

右侧的 Token 获取接口 不是每次都要用。

一般只有两种情况才需要开：

• 数据接口访问前必须先登录或换取令牌
• 现有接口文档明确要求先获取 Token，再携带 Token 访问查询接口

如果你的数据查询接口本身就能直接访问，这一块保持关闭即可。

“其他参数”怎么处理 ​

这一块最容易出错，但用户层面的原则其实很简单：

• 如果接口示例里已经给了参数，就照着填
• 参数名不要自己改写
• 不确定时，优先找实施同事或接口提供方确认一份可直接照填的示例

你不需要在这里研究系统内部实现，只需要确保“示例里要求带什么，就带什么”。

Token 路径怎么理解 ​

如果启用了 Token 获取接口，通常还要填写 Token 路径。

你可以把它理解成： 系统要从返回结果里的哪个位置，把真正的 Token 找出来。

常见写法通常类似：

• access_token
• data.token

如果你拿到的是一份接口说明或现成示例，通常会直接告诉你这一项怎么写。

怎么判断接口配置填对了 ​

满足下面几条，说明这一页基本就对了：

• 接口测试能正常返回
• 没有明显报错
• 需要 Token 的场景下，Token 能成功获取
• 返回结果结构和你的业务数据相符

如果测试一直不通过，不建议继续往后配。 应先把接口这一层确认通，再做字段和规则配置。

第三步：字段配置 ​

接口能取到数据以后，下一步就是告诉 AI：这些字段分别代表什么。

这一页的目标不是“多”，而是“清楚”。 重点是让系统和使用者都能看懂字段含义。

这里通常会出现几类字段：

• 原始字段 直接来自数据源
• 计算字段 已经整理好的业务指标

你可以重点维护这些信息：

• 字段名称
• 中文名称
• 类型
• 数据类型
• 状态
• 业务说明

字段配置的实操建议 ​

• 中文名称尽量写完整，不要只写缩写
• 业务指标尽量用业务语言表达，例如毛利、净额、订单数、同比等
• 如果字段已经是核心指标，建议重点补足说明，方便后续培训和使用
• 没意义、不会被分析使用的字段，不建议一股脑全部开启

怎么判断字段配置是否够用 ​

你可以用一个很实用的标准来判断：

如果一个新同事打开这页，只看字段列表和说明，就能大致知道“这份数据能分析什么”，那这一步就算配置得比较好了。

第四步：AI规则配置 ​

最后一步是决定 AI 怎么理解这份数据、怎么生成结果、怎么展示页面。

这一页可以分成四块去理解：

• SQL生成规则
• 分析结果规则
• HTML输出规则
• 系统提示词

1. SQL生成规则 ​

这一块决定 AI 在查询数据时遵守什么边界。

通常你会在这里控制：

• 是否只允许查询
• 是否限制返回条数
• 是否优先使用已配置字段
• 是否补充额外要求

如果你的场景偏培训、演示或标准化交付，建议规则尽量保守、清晰。

2. 分析结果规则 ​

这一块决定 AI 输出的分析内容风格。

你可以在这里控制：

• 要不要生成结论
• 要不要识别趋势
• 要不要识别异常波动
• 分析内容希望简洁还是详细

如果面向业务用户，建议先让结果“能看懂”，再追求复杂度。

3. HTML输出规则 ​

这一块决定最终页面怎么展示。

通常会涉及：

• 是否返回完整 HTML
• 是否包含图表
• 是否包含数据表格
• 页面风格、主题色、图表数量等

如果是培训或交付场景，建议优先保证页面稳定、结构清晰，而不是一次加太多变化项。

4. 系统提示词 ​

这一块可以理解成 AI 的总说明。

你可以告诉它：

• 它扮演什么角色
• 输出时要注意什么
• 结论偏简洁还是偏正式
• 是否要突出某类业务指标

建议写法尽量直接、明确，不要过度绕。

详情页怎么看 ​

配置建好以后，通常还会回到详情页复查。

基础信息与接口配置 ​

先看这条配置到底是做什么的，再看接口是否启用、查询方式是否正常。

建议先确认：

• 名称和描述是否准确
• 数据查询接口是否启用
• 是否需要 Token
• 请求头和参数是否完整

字段配置详情 ​

再看字段页，确认关键字段和关键指标有没有被识别出来。

优先看：

• 关键业务字段在不在
• 中文名称是否清楚
• 重要指标是否启用
• 字段说明是否足够支撑培训讲解

AI规则配置详情 ​

最后看 AI 规则页，判断输出规则是否符合你的交付场景。

这里建议重点看：

• 查询边界是不是太松
• 结果长度是不是合适
• 页面输出是不是符合当前业务展示需求
• 提示词有没有偏离你的业务口径

给实施、培训同学的推荐讲解顺序 ​

如果你要把这一页讲给别人听，建议按这个顺序讲：

1. 先讲“这条配置是分析什么业务问题的”
2. 再讲“数据从哪里来，接口怎么测试通”
3. 再讲“字段都代表什么，哪些是关键指标”
4. 最后讲“AI 最终怎么输出结论和页面”

这样讲，别人更容易把它理解成一条完整的业务分析链路，而不是一堆零散配置项。

最后记住这几个判断 ​

• 接口没测通，不要继续往后配
• 字段没讲清，AI 输出通常不会稳定
• 规则写太空，结果容易跑偏
• 第一次新建配置时，优先复制一条已跑通的配置再改

如果你是面向业务培训或实施交付，这一页的目标不是讲技术原理，而是让别人知道： 这条分析配置怎么建、怎么查、怎么判断它有没有配对。