通过推荐问题查询数据

• 第一种查询数据的方法是可以直接点击智能体的推荐问题
• 推荐问题会根据大家的历史查询问题自动生成，也可以自定义配置，具体的配置方法可以参考 3.2.4 推荐问题

自然语言查询数据

• 第二种则是智能体主要的用法，即大家可以将自己的查询数据需求直接以文字的方式描述给智能体
• 智能体查询无需选择数据集，会自动在智能体配置的数据集中查询数据

订阅问题

• 智能体支持大家主动订阅历史提问过的问题，这样大家后续就不用再手动输入一遍

时间

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

指标

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

筛选条件（可选）

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

统计方式（可选）

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

呈现方式（可选）

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

1

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

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

2

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

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

3

避免非常模糊的提问

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

4

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

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

5

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

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

6

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

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

7

对图表内的字段有要求

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

看一下今年审核率大于 0.5 的在审省份的进审量分布情况

修改推送频率

• 在飞书端主动推送配置中，配置推送频次（天级、周级、月级）

第二步 : 在图表中，点击数据点，配置归因规则「归因指标」、「基准日期」、「观察日期」，点击开始归因。

• 归因指标：智能体会根据图表填写归因指标。
• 基准日期：是作为参照标准的特定日期，用于衡量和比较相对于观察日期的数据变化情况，基准日期需早于观察日期。
• 观察日期：进行数据收集和现象观察的具体日期。

第三步 : 归因分析完成后，智能体将反馈归因结果，并展示同向或负向贡献程度排名前三的影响因子，及其对应的贡献值、贡献率、对比差值和对比百分比。

• 同向贡献前 3：对指标变化起到同向推动作用，且贡献程度排在前三的影响因子。
• 反向贡献前 3：对指标变化起到反向推动作用，且贡献程度排在前三的影响因子。
• 贡献值和贡献率算法参考：维度归因-算法。

第二步 : 在图表中，点击数据点，配置归因规则「归因指标」、「基准日期」、「观察日期」，点击开始归因。

• 归因指标：智能体会根据图表填写归因指标。
• 基准日期：是作为参照标准的特定日期，用于衡量和比较相对于观察日期的数据变化情况，基准日期需早于观察日期。
• 观察日期：进行数据收集和现象观察的具体日期。

第三步：归因分析完成后，智能体将反馈归因结果，并展示同向或负向贡献程度排名前三的影响因子，及其对应的贡献值、贡献率、对比差值和对比百分比。

• 同向贡献前 3：对指标变化起到同向推动作用，且贡献程度排在前三的影响因子。
• 反向贡献前 3：对指标变化起到反向推动作用，且贡献程度排在前三的影响因子。
• 贡献值和贡献率算法参考：维度归因-算法。

为智能体添加数据集

• 进入智能体的「数据集配置」模块，点击中间的「立即添加」；
• 搜索自己需要添加的数据集，注意，只有自己有权限且已经通过合规的数据集才可以被搜索到，该页面支持批量勾选；
• 点击「确认」后即可添加成功，后续可继续添加其他数据集或移除数据集

2. 添加的方式可选择批量导入，或单个添加，这里的添加即时生效，无需再发布智能体。

3. 添加完成后，名单内的用户即可在 DataWind 主页进入智能体页面，在左侧的智能体列表中可以找到有权限的智能体

创建企业自建应用

• 在弹出的创建企业自建应用的弹窗中，输入应用名称、应用描述和应用图标，这里的应用名称会对应之后用户在飞书上搜索到的智能体名称
• 输入完成后点击「创建」即可创建一个应用

为创建好的应用添加机器人的能力

• 下一步需要为这个应用添加机器人的能力
• 首先进入应用的配置页面，进入左侧的「添加应用能力」
• 选择添加「机器人」

为机器人添加需要的权限

• 如果要使机器人可以正常交互，需要为机器人添加一些权限。这里可以在左侧的「开发配置」中找到「权限管理」，在权限管理中，选择「批量导入/导出权限」，勾选并批量开通这 16 个权限：
  • 获取应用信息
  • 获取用户 user ID
  • 以应用的身份发消息
  • 管理应用自身资源
  • 获取通讯录基本信息
  • 撤回消息
  • 获取单聊、群组消息
  • 给一个或多个部门的成员批量发消息
  • 给多个用户批量发消息
  • 更新消息
  • 读取用户发给机器人的单聊消息
  • 查看消息表情回复
  • 查看 Pin 消息
  • 添加、取消 Pin 消息
  • 发送、删除消息表情回复
  • 获取与上传图片或文件资源

备注：这里我们已经将需要的权限列表进行导出，大家可以直接复制右侧的代码，之后在导入权限的部分粘贴即可；

{
  "scopes": {
    "tenant": [
      "admin:app.info:readonly",
      "application:application:self_manage",
      "contact:contact.base:readonly",
      "contact:user.employee_id:readonly",
      "im:message.p2p_msg:readonly",
      "im:message.pins:read",
      "im:message.pins:write_only",
      "im:message.reactions:read",
      "im:message.reactions:write_only",
      "im:message:readonly",
      "im:message:recall",
      "im:message:send_as_bot",
      "im:message:send_multi_depts",
      "im:message:send_multi_users",
      "im:message:update",
      "im:resource"
    ],
    "user": [
      "contact:user.employee_id:readonly",
      "im:message:readonly",
      "im:message:update"
    ]
  }
}

配置权限后发布飞书机器人

1. 填写完机器人所需权限后，即可发布该机器人，在「版本管理与发布」页面创建版本并发布即可。

• 版本号和描述等信息可按照需求填写，或任意填写。
• 申请理由部分可整体写一下，细分项可不填。

注意：在进行下一步之前，需要先发布该企业应用，否则无法执行进入下一步骤。

获取回调地址

• 进入智能体配置页面后，点击并复制智能体名称下方的「飞书回调地址」

为机器人配置请求地址

• 回到前一步创建的飞书机器人页面，将复制的回调地址填入飞书机器人「事件与回调」页面的「事件配置」和「回调配置」中的请求地址即可
• 注意，事件配置和回调配置都需要添加

填写加密策略

• 当智能体用于对外场景或特殊情况需要加密请求内容时，可以选择为智能体配置加密策略。

为机器人配置事件

• 填写完地址后，还需要分别为事件和回调配置「添加事件」。
• 事件配置需要添加：
  • im.message.receive_v1
  • p2p_chat_create
• 回调配置需要添加：
  • card.action.trigger_v1

机器人发布

• 完成前面的步骤后，可以先将机器人发布一次，在「版本管理与发布」页面创建版本并发布即可
• 版本号和描述等信息可按照需求填写，或任意填写。

注意：在进行下一步之前，需要先发布该企业应用，否则无法执行进入下一步骤。

开启飞书端

• 进入之前创建的智能体配置页面，找到「基本信息」中的「飞书端配置」，选择「开启飞书端」。

添加智能体

• 将飞书机器人的 App ID 和 App Secret 填入飞书基础设置中
• 点击右上角的「保存」即可，之后智能体就会与该飞书机器人进行关联。

添加成员

• 编辑机器人的可用成员，搜索用户后勾选即可
• 请勿选择「全部成员」

保存并发布

• 添加完成后保存并发布即可，注意需要发布后才能生效。

为智能体添加数据集

• 进入智能体的「数据集配置」模块，点击中间的「立即添加」；
• 搜索自己需要添加的数据集，注意，只有自己有权限且已经通过合规的数据集才可以被搜索到，该页面支持批量勾选；
• 点击「确认」后即可添加成功，后续可继续添加其他数据集或移除数据集

飞书端配置

• 点击【飞书端配置】
• 【飞书端基础设置】模块中，支持编辑当前智能体的所接入飞书机器人的 App ID 和 App Secret，以及选择加密类型和校验码，进行加密配置
• 【欢迎卡片配置】模块中，支持为飞书端智能体配置欢迎卡片，即用户初次进入 飞书端智能体时，接收到的欢迎卡片。支持大家在飞书卡片搭建工具配置卡片后，复制 Json 代码到这里快捷配置。
• 【飞书端主动推送设置】模块中，支持主动推送设置，即可以为智能体的用户配置例行推送，例如每日定时自动推送用户想看的数据等。支持配置的内容包括：主动推送标题、推送频次、推送用户范围、推送总结。配置完成后可发送预览，查看配置的推送效果。

网页端基础设置

• 在通用设置页面，除了管理员、头像等基础设置外，还支持配置智能体在网页端展示的名称和描述

智能体管理员

• 智能体管理员将会拥有编辑智能体信息的权限

智能体可用成员

• 智能体的可用成员即当前智能体关联的飞书机器人的可用成员
• 添加成员的方式可以参考 3.2.2 的第四步

添加数据集

• 支持点击右侧的「添加数据集」添加自己有权限的数据集

语义模型配置

语义模型的字段配置包括基础配置和字段配置

• 基础配置支持修改字段在智能体侧的显示名称、同义词和描述。当查询时的描述为这些字段的显示名称、同义词或描述时，会优先使用这些字段进行查询。
• 字段值召回是指查询时可以把提问中维度的值传给大模型，之后提问的时候，可以通过提问具体维度值来实现查询到具体维度。
  • 比如之前可能需要问到具体字段：视频一级垂类是旅行的xxx数据，现在就可以做到提问：旅行垂类的xxx数据，让大模型可以定位到这个字段。
• 字段值黑名单代表配置在这里的维度值不会传递给大模型。
• 高频字段说明则是可以给某些字段值配置同义词，当用户问到这些同义词的时候也可以查询到对应字段值的数据。

知识库

• 支持为数据集配置知识库，用户可以将一些行业黑话、不准确或歧义的表达等，添加进知识库中
• 需要数据集编辑或以上权限才可以添加
• 以此可以让大模型更好地理解大家提出的问题

删除选用的数据集

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

获取当前用户用户名

嗨 {用户名} 👋 ！你来啦！终于等到你～欢迎使用数据助理～ 🥳

这里的{用户名}会自动获取当前阅读飞书卡片的用户名，即谁看到都会显示自己的姓名。

配置一组查询

<sentence><font color='orange'>【最终排名】</font>为 **{<name>是否参与排名=1的条件下，我的最终排名</name><type>float</type><dataSetId>
3659012</dataSetId>}**；<font color='orange'>【排名分位】</font>为 **{<name>是否
参与排名=1的条件下，我的最终排名分位</name><type>float</type><dataSetId>3659012</dataSetId><ratio>true</ratio>}**%；</sentence>

• 这里的是固定句式，每一个<sentence> 内容 </sentence>之间代表一组查询，一组查询内可引用多个查询结果；
• 当这组查询中有任意一个查询失败时，该<sentence> 内容 </sentence>内的内容都不会推送，当大家的引用的查询结果比较多时，可以分为多组配置，以确保至少有部分内容成功推送。

引用单个查询的结果

<sentence><font color='orange'>【核销完成率】</font>为 **{<name>是否参与排名=1的条件下，核销完成率-封顶后</name><type>float</type><dataSetId>3659012</dataSetId><ratio>true</ratio>}**%；<font color='orange'>【奖金】</font>为 **{<name>是否参与排名=1的条件下，我的奖金</name><type>float</type><dataSetId>3659012</dataSetId><nullable>true</nullable>}**</sentence>

• 这部分代表的是对查询结果的引用：
  • { }：固定句式，大括号内的内容代表一个查询结果；
  • <name>查询问题</name>：需要查询的问题写在 name 参数之间；
  • <type>float</type>：type 参数之间可以指定查询结果的格式，例如这里是浮点数（小数），也可以改成 int（整数）；
  • <dataSetId>3659012</dataSetId>：这里配置的查询需要指定当前问题查询的数据集ID，数据集ID可以通过数据集的链接获取；

• <ratio>true</ratio>：可选项，添加后会将数值*100，可以在该查询结果后手动加一个 % 符号将查询结果转化为百分比；
• <nullable>true</nullable>：可选项，添加后会将查询结果转化为 nullable 类型，当该问题查询结果可能为空时可以添加该选项。

富文本编辑

<sentence><font color='orange'>【最终排名】</font>为 **{<name>是否参与排名=1的条件下，我的最终排名</name><type>float</type><dataSetId>3659012</dataSetId>}**；<font color='orange'>【排名分位】</font>为 **{<name>是否参与排名=1的条件下，我的最终排名分位</name><type>float</type><dataSetId>3659012</dataSetId><ratio>true</ratio>}**%；</sentence>

• <font color='orange'> 需要输入的文本 </font>：富文本代码的一种，用于调整文本的颜色，color 参数后的内容代表具体颜色，例如当前的 orange 代表橙色，如果改为 blue 则为蓝色。
• ** 内容 **：富文本代码的一种，中间的内容字体会被加粗

第二步：进入编辑页面后，首先需要选择配置方式，当前支持「统一用户配置」和「用户差异化配置」；

• 「用户差异化配置」可以为每位智能体用户单独配置推荐问题；
• 「统一用户配置」则所有用户收到的推荐问题一致。

第三步：在配置弹窗处配置推荐问题即可，支持拖动调整顺序。

• 飞书卡片上将只展示模糊问题；
• 当一个模糊问题配置多个拆解问题时，用户点击某个问题，会同时展示所有拆解问题的查询结果。

PC端

• 点击一键导入可以将飞书的可见成员同步过来，或者添加成员

编辑与删除 Prompt

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