You need to enable JavaScript to run this app.
导航
智能分析Agent配置
最近更新时间:2025.06.09 19:07:14首次发布时间:2025.06.09 18:25:53
我的收藏
有用
有用
无用
无用

智能分析 Agent 支持多个自定义配置项,目前包括基本信息、数据集配置、内容配置、Prompt配置和审计五大功能,能精准适配多样化业务场景。本文为您介绍如何使用智能体配置功能。

功能概述

使用流程

Image

操作步骤

前提条件

创建智能体
  1. 进入智能分析 Agent 的配置页面,点击右上角的「创建智能体」,即可进入到智能体的初始配置页面。
    Image
  2. 配置智能体基本信息,包括应用名称、应用描述和管理员等,配置完成后点击「保存」。
    Image
  3. 此时您已创建好一个智能体,后续还需进行智能体的配置、发布才能使用。您可以在智能体列表的待发布页签中查看到该智能体。
    Image

配置智能体

智能体通常需要数据团队、IT 团队或专业分析师统一配置,对于大多数业务人员或管理人员而言,仅需使用智能体,无需进行智能体的配置工作。
Image

配置基本信息

通用配置

进入智能体配置页面后,点击基本信息,点击「编辑」,配置智能体的基本信息。
Image
相关参数配置说明如下:

参数

配置说明

应用名称

支持用户自定义智能体名称。

应用描述

支持用户添加对智能体的描述。

智能体管理员

管理员拥有智能体的编辑权限,可以对智能体进行编辑、删除、发布等操作。

智能体头像

支持用户上传图片作为智能体头像。

PC端成员列表

智能体管理员可以在此执行查看成员列表、添加/删除成员等操作。

配置数据集

智能体的查询会基于此步骤配置的数据集的数据,用户可以自定义智能体查询的数据集范围,让智能体可以更好地应用于当前的业务。
Image

添加数据集

用户可以点击右侧的「添加数据集」,添加自己有权限的数据集。
Image

配置语义模型

语义模型可以在数据集基础上对数据集名称、字段等信息做面向智能体使用者语义的重新设定,以提升智能体自动选择数据集和问答的准确性。
例如:实际业务场景中用户会用一些约定俗成的“黑话”称呼某些字段或者字段的值,则可以将这些“黑话”配置到字段名或者字段值同义词上。

  1. 点击数据集配置页面的「语义模型」。
    Image

  2. 点击「设置模型基础信息」,为语义模型添加名称、描述以及特征。
    Image
    相关参数配置说明如下:

    参数

    配置说明

    语义模型名称

    支持用户自定义语义模型名称,如不指定,默认同步于数据集名称。

    语义模型描述

    支持用户添加对语义模型的描述内容,如不指定,默认同步于数据集描述。

    特征

    语义模型的特征值,用于定义当前数据集区分于其他数据集的关键特征,用户可使用逗号、回车分隔多个值。

    注意

    • 特征会影响智能体表召回数据集的优先级
    • 单个特征建议长度不超过5个字符,特征总数建议不超过10个
    • 特征示例:aaa,bbb,ccc
  3. 点击「配置」进入语义模型字段配置界面,对数据集中的字段进行语义模型配置,字段配置界面上方会显示数据集中字段的名称和类型。
    Image
    相关参数配置说明如下。

    参数

    配置说明

    智能体字段名称

    用户可以自定义智能体字段名称,当查询时的描述为该名称时,智能体会优先使用该字段进行查询。为空时与数据集该字段名称保持一致。

    字段名称同义词

    用户可以设置一个或多个该字段名称的同义词,当查询时的描述在这些同义词中,智能体会优先使用该字段进行查询。多个同义词用逗号或回车分隔。

    字段描述

    用户可以增加对智能体字段的描述,用于帮助对字段的理解,为空时与数据集该字段描述保持一致。

    默认召回

    如勾选「默认召回」,则该字段每次提问时都会作为提示词传输给大模型。

  4. 对字段进行语义配置后,可通过检索,逐个开启数据集中所需的字段的语义模型配置内容,也可点击「批量开启状态」,开启数据集中所有字段的语义模型配置。
    Image

    注意

    • 如果语义模型名称、字段名称等没有重新设定,会沿用数据集上的定义。
    • 一旦设置了部分字段为关闭状态,后续数据集新增字段不会自动加入当前语义模型,可按需手动开启。

配置知识库

智能体支持为数据集配置知识库,用户可以将一些行业黑话、不准确或歧义的表达等,添加进知识库中,以此可以让大模型更好地理解用户提出的问题。

注意

需要数据集编辑或以上权限才可以添加。

  1. 点击数据集配置的「知识库」进入知识库配置页面。
    Image

  2. 点击「知识库配置」,进行知识库相关配置。
    Image
    相关参数配置说明如下:

    参数

    配置说明

    匹配度阈值

    调节业务名词与问题的向量匹配度,最小为0,最大为1,1表示精准匹配。
    (对大模型不熟悉的用户建议不要调整)

    知识召回上限

    控制当前数据集一次性召回知识数量的最大值,避免召回过多知识对大模型造成干扰。
    (可以配置,但不建议太多,2 - 5 这个区间比较好)

  3. 点击「添加知识」,为知识库添加更多知识。
    Image
    相关参数配置说明如下:

    参数

    配置说明

    业务名词

    业务常用语如特有名词、黑话、常用术语的名字,当召回规则为“跟随知识库配置”时,业务名词会作为关键字,用于召回该条知识。

    连接词

    用于连接业务名词和说明,包括“表示”和“无”两种连接词,连接词的作用主要是使得整句话更通畅,可以根据预览整句知识的通顺情况决定是否需要连接词。

    说明

    输入对知识的定义、解释说明等,是知识的核心部分,知识的说明需要精准易懂,帮助大模型更准确的理解。 例如对业务名词“搜索业绩口径”的说明是“定义:订单/流量计入搜索“。

    同义词

    业务名词的同义词,和业务名词的作用一样。如年龄分布的同义词有年龄画像、年龄构成、年龄结构。

    预览

    可通过预览检查知识整体是否通畅。这是最终给到模型的知识,包含业务名词、连接词、说明的串连。

    召回规则

    包括跟随知识库配置、默认召回和自定义规则。

    • 跟随知识库配置表示根据业务名词或者同义词的相似度来匹配知识
    • 默认召回表示该条知识每次提问时都会作为提示词传输给大模型
    • 自定义规则表示根据用户问题中关键词匹配规则,可设置包含关键词和不包含关键词,关键词可以填多个,多个关键词之间是“且”的关系。

    参与召回字段名

    字段名召回是指当前这个知识,是否参与字段召回,参与的方式是在知识中根据字段名来召回。比如知识名:销售情况表示销售额、利润率。则该知识参与召回,会召回销售额、利润率两个字段。

    参与召回字段值

    字段值召回是指当前这个知识,是否参与字段召回,参与的方式是在知识中根据字段值来召回。比如知识名:抖西表示抖音、西瓜、今日头条。则该知识参与召回,会根据抖音、西瓜、今日头条等值,召回“产品名”这个字段。

配置筛选

  1. 用户点击「筛选配置」进入数据集筛选配置界面,可以根据数据集中的维度字段或指标字段对智能体所用数据集数据进行筛选。
    Image

  2. 设置智能体所用数据集的筛选条件,用户可根据所需数据情况使用维度筛选、指标筛选或日期筛选。
    Image

    筛选条件

    适用场景

    操作指导

    维度筛选

    需要按照维度字段对数据进行筛选,维度和指标字段对区分参见维度和指标

    维度筛选

    指标筛选

    需要按照指标字段对数据进行筛选,维度和指标字段的区分参见维度和指标

    指标筛选

    日期筛选

    需要按照日期类型的字段对数据进行筛选

    日期筛选

配置数据集就绪

点击「数据集就绪配置」进入配置数据集就绪界面,可设置数据集就绪的同步日期时间,设置好后点击「保存」。
Image

  • 当飞书端主动推送触发时将检测该T-N的时间分区数据是否就绪,该分区数据就绪则开始推送。主动推送相关设置见配置飞书端欢迎卡片
  • 示例:设定为T-2, 在2020-10-05日,完成“2020-10-03”日数据同步,则相关主动推送开始推送。

删除数据集

  • 支持对已经添加的数据集进行删除。
    Image
  • 如果当前数据集已经被用于推荐问题中,则需要先修改推荐问题后才可以删除当前数据集。
    Image

配置内容

分为取数推荐问题、分析推荐问题、PC端三个模块。

  • 取数推荐问题:支持设置用户或飞书群的取数相关推荐问题。
  • 分析推荐问题:支持设置数据分析相关推荐问题。
  • PC端:用户进入 PC 端智能体首页后展示的总结消息。

说明

推荐问题:添加后的推荐问题将会展示在智能体的默认的消息卡片中,智能体的用户可以通过推荐问题快速获取业务所需要的数据。

配置取数推荐问题

  1. 进入智能体配置页面,在左侧选择「内容配置」,选择进入取数推荐问题配置页。
    Image

  2. 进入编辑页面后,首先需要选择配置方式,当前支持「统一用户配置」和「用户差异化配置」。

    • 「用户差异化配置」可以为每位智能体用户单独配置推荐问题;
    • 「统一用户配置」则所有用户收到的推荐问题一致。
      Image
  3. 点击「新增推荐问题配置」,在配置弹窗处配置推荐问题即可,支持拖动调整顺序。
    Image
    相关参数配置说明如下:

    参数

    配置说明

    配置名称

    设置推荐问题配置名称。

    推荐问题

    分为模糊问题和拆解问题,当一个模糊问题配置多个拆解问题时,用户点击某个问题,会同时展示所有拆解问题的查询结果。
    Image

    数据集

    对每一个拆解问题,需要绑定数据集,智能体会根据拆解问题绑定的数据集召回数据进行回答。

配置分析推荐问题

智能体配置页面,在左侧选择「内容配置」,选择进入分析推荐问题配置页。点击「添加问题」,在弹出的参数配置界面设置推荐问题并选择关联知识。配置好后点击「保存」。
Image

配置PC端

进入智能体配置页面,在左侧选择「内容配置」,可以找到「PC端」,在这里点击右上角的编辑,即可配置PC端首页展示的文案;输入内容后,可以预览展示效果。
Image

配置Prompt

由于智能体基于大模型功能,而大模型有一个特点就是可以添加 Prompt,简单来说就是可以给大模型配置一些前置条件,以此可以让大模型给出更准确的答案。智能体支持配置 Prompt 的功能,以此让用户得出更符合自己场景的查询结果。

添加 Prompt

在 Prompt 配置页面,可以点击右侧的「添加 Prompt」按钮来添加 Prompt。
Image

  • Prompt 类型:
    • 提示:提供引导性线索或启发。示例:“在分析销售数据时留意季节性波动因素。”
    • 要求:明确规定输出的标准。示例:“查询的财务数据必须精确到小数点后两位。”
  • Prompt 示例**:**
    ❌:用户如果在问用工模式下相关的数据,如不同用工类型有多少人,用工模式的维度选择“用工模式-在职人力使用”字段;如果在问分用工模式下非一线占比相关的数据,如XX非一线占比是多少,用工模式的维度选择“用工模式-非一线人力占比使用”字段
    ✅:如果问题以“不同用工类型有多少人”结尾,查询时维度选择“用工模式-在职人力使用”字段;如果问题以“非一线占比是多少”结尾,维度选择“用工模式-非一线人力占比使用”字段

说明

  • 这里的示例仅做描述方式的参考,实际配置过程中需要依据业务逻辑进行调整。
  • 系统已内置prompt,无需重复配置,可根据需求补充配置自定义要求。
  • 与Prompt有关的更多的提问建议和示例可以参考提问建议与示例

编辑与删除 Prompt

  • 支持大家对已配置的 Prompt 进行编辑或删除
    Image

审计

智能体配置界面包含审计功能,支持用户查看智能体使用记录和提问记录。

  • 点击「审计」,点击「使用记录」,可以查看今日DAU、昨日DAU、本周WAU、上周WAU、DAU趋势、WAU趋势等信息。
    Image
  • 点击「审计」,点击「提问记录」,支持用户通过设置提问日期、提问终端、Session ID、状态、用户等条件来筛选查看提问记录。
    Image

知识配置

进入智能体配置页面,在左侧选择「知识配置」,点击「添加知识」,在这里可以输入知识名称、语义模型名称、上传知识文件,为智能体输入更多的业务知识。
Image

发布与管理
  • 发布智能体
    Image
  • 修改已有智能体配置
    • 用户可在智能体列表选择某一智能体,点击「智能体配置」进入智能体配置页面。
      Image
    • 用户也可以在智能体对话页面,点击页面左边功能栏的「设置」进入该智能体的配置页面。
      Image
  • 下线智能体
    Image
  • 删除智能体
    Image

后续步骤
  1. 测试使用智能体
    1. 使用账号密码登录火山引擎DataAgent-分析Agent页面后,点击“智能体”进入智能体列表页。
    2. 点击已发布智能体进入对话页面进行智能分析Agent使用。
      Image
    3. 进入智能体对话界面后,点击对话框中的切换按钮,可切换「智能问数」和「深度研究」功能。
      Image
  2. 场景应用

相关参考

提问建议与示例

一个好问题,记得包含以下关键要素:

要素

说明

时间

指定数据的时间点或范围,例如“最近 7 天”、“去年劳动节那一天”、“过去 30 天内”、“1 月 18 日那一周”等。

指标

指定需要查询的一个或多个指标,例如“GMV”、“订单量”等。

筛选条件(可选)

指定数据的统计维度,例如“按省份”、“按一级类目和二级类目”等。

统计方式(可选)

指定数据的统计方式,例如“XX 有多少个?”、“总和”、“平均值”、“最大值”、“周环比”、“年同比”等。

呈现方式(可选)

支持表格以及折线图、柱状图、饼图等常见的数据可视化。

序号

建议

说明

1

提问需要跟表里字段名称一字不漏

问题里不需要和字段名称完全一模一样,大模型会根据它的理解去匹配合适的字段。当然,当数据集内,多个字段名非常类似,这时建议输入得越详细,匹配的字段更准确些。

2

支持最大、最小、排序、同环比等计算

同环比最好指定需要对比的时间粒度。

3

避免非常模糊的提问

比如:看一下各地区的情况,大模型无法精准匹配你需要对什么指标进行分析。

4

支持对部分计算指标的理解

比如:大模型的公域知识可以理解“利润率”=总利润/总销售额,但其他的 xxx 率不一定在大模型的公域知识范围内,那么有可能就会理解失败。

5

目前无法做到对身份的识别

比如:尽量避免“我负责的区域的销售额是多少”这种提问,建议用 “刘优负责的区域的销售额是多少”或者“区域经理刘优负责的区域的销售额是多少”。

6

记不清具体维度值时,尝试用“包含”

当你对需要进行筛选的维度值不清晰时,可以用“包含”提问。
比如“作者昵称:小明,当日粉丝量大于 10 万,xxx 标签是什么?”--->“作者昵称包含小明,当日粉丝量大于 10 万,xxx 标签是什么?”。

7

对图表内的字段有要求

图表存在表计算和 LOD 字段,暂不支持提问。