数据

1.1 功能简介

数据模块是 Data Agent 中为 Agent 提供分析素材的核心载体，所有供智能体查询、分析的业务数据都在这里统一管理与配置。数据模块支持定期刷新、文件夹分组管理、语义配置等能力，确保 Agent 在进行数据分析时的数据准确性与业务一致性。

注：当前仅对接 FineBI 分析主题与仪表板、Excel 的 .xls、.xlsx、.csv 格式文件。

1.2 使用场景

• Agent 数据配置：为 Agent 绑定一个或多个数据资产，让智能体基于这些数据完成对话式分析、报告生成等任务；

• 数据统一管理：通过文件夹结构规划整理不同业务线的数据源；

• 数据定期刷新：设置自动加载刷新频率，保证数据实时性；

• 语义统一管理：为字段配置业务用语（同义词），提升自然语言识别准确率；

• 数据资产扩展接入：从 FineBI 数据资产中添加分析主题/仪表板，或上传 .xls、.xlsx、.csv 格式文件。

1.3 效果演示

以添加 FineBI 分析主题的「连锁经营分析」数据资产为例，效果如下所示：

2.1 查看与筛选数据

进入「管理后台>数据」，左侧数据目录树展示所有数据资产，支持通过顶部搜索框快速定位数据，如下图所示：

点击筛选图标，可按照数据资产来源分类过滤，当前支持的分类如下：

• 全部

• FRBI 分析主题

• FRBI 仪表板

2.2 目录管理

支持对目录中的文件夹/数据资产做如下操作：

1）重命名：支持对已有文件夹/数据资产进行重命名，便于识别业务场景。

2）移动到：可将文件夹/数据资产移动到指定文件夹，实现按业务场景分组管理，调整目录结构。

3）删除：支持删除不再使用的数据资产/文件夹。

注：

1）「全部数据」文件夹属于根目录，无法进行重命名、删除、移动等操作。

2）删除文件夹/数据资产会影响到相关 Agent 和技能，且删除后不可恢复，请谨慎删除。

3.1 上传文件

点击「+ > 上传文件」，支持点击或拖拽上传 Excel（.xls、.xlsx、.csv）格式的数据源。

3.2 添加分析主题

点击「+ > 分析主题」，打开添加分析主题弹窗，在左侧目录树中勾选需要导入的分析主题，单击分析主题名称，可在右侧预览选中主题的字段结构，修改数据资产名称后，点击「确定」，完成分析主题导入。

3.3 添加仪表板

点击「+ > 仪表板」，打开添加仪表板弹窗，在左侧目录树中勾选相应仪表板，点击仪表板名称，可在右侧预览仪表板内容，修改仪表板名称后，点击「确定」，完成仪表板导入。

4.1 数据预览

点击左侧数据目录中的分析主题或仪表板，右侧将展示实时预览：

1）分析主题类：预览数据明细、字段信息，支持分页查看、字段搜索。

2）仪表板类：预览完整仪表板效果，支持对仪表板进行另存、导出、自适应、性能分析、查看指标信息、筛选查询等操作。

3）表格类：预览 Excel 表格中的明细、Sheet 页内容等信息。

4.2 字段信息查看

在右侧预览界面，支持切换到「字段」标签页：

1）查看所有字段的字段类型、字段名、字段别名；

2）支持对数值字段设置自动、数字或百分比的数据格式与指标类型。

• 可累加指标：指标值在所有维度上都可以直接相加汇总。

• 半累加指标：指标值在某些维度上不能直接相加汇总，需要使用特定的聚合方式。

• 不可累加指标：指标值在任何维度上都不能直接相加汇总。  

4.3 语义信息配置

语义信息用于统一数据字段的业务用语与近义表达，提升智能体意图识别准确率。

1）点击右侧「语义信息」按钮，进入语义配置页面

2）支持添加/导入/导出业务用语：

• 添加：选择对象类型，填写标准对象与业务用语（同义词），例如将「销售额」与「营收」「营业额」映射；

• 导入/导出：批量管理业务用语，便于跨场景复用；

3）配置完成后点击「检测并保存」，智能体将自动识别这些近义表述。

注：语义信息配置仅对当前数据资产生效，不同数据资产需独立维护。

为确保 Agent 使用的数据准确性，支持定期预加载刷新：

1）点击，打开数据刷新配置页面；

2）查看上次刷新时间，可点击「立即刷新」手动同步数据；

3）配置自动刷新频率；

4）可选配置计时起点，未配置则默认每小时 00 分执行刷新。

注：数据刷新频率建议根据业务实时性需求设置，避免过度刷新影响性能。