通过推荐问题查询数据

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

添加数据集

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

语义模型配置

语义模型主要有两个配置功能：

• 选择数据集使用的字段：可以选择智能体在查询时所使用的字段，如果数据集中存在多个类似含义的字段，则可以只选择其中一个或几个
• 配置字段的名称和同义词：支持修改字段在智能体侧的显示名称，同时支持为字段配置同义词，当查询时的描述为这些字段的同义词时，会优先使用这些字段进行查询

知识库

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

删除选用的数据集

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

添加推荐问题

• 根据当前的智能体是否已经添加过推荐问题，添加推荐问题的入口会有差异
• 如果已经添加过推荐问题，需要点击右上角的「编辑」进入编辑状态后，在推荐问题的最下方添加
• 当前每个模糊问题最多添加 4 个拆解问题
• 智能体卡片也会根据数据集的情况自动生成一些推荐问题

编辑与删除

• 点击推荐问题右上角的「编辑」按钮，将会进入到推荐问题的编辑状态
• 支持编辑或删除已经配置的推荐问题

编辑与删除 Prompt

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