智能体PC端

• 配置了智能体的业务方，可以将智能体放在PC端，便于用户快速使用

开始使用

• 初次使用点击默认卡片的「立即体验」按钮或者后续继续使用的时候，智能体会推送右图中的卡片
• 卡片内容包括：收藏问题、推荐问题

通过推荐问题查询数据

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

自然语言查询数据

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

收藏问题

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

时间

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

指标

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

筛选条件（可选）

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

统计方式（可选）

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

呈现方式（可选）

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

1

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

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

2

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

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

3

避免非常模糊的提问

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

4

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

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

5

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

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

6

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

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

7

对图表内的字段有要求

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

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

修改推送频率

• 如果当前已经开启了定时推送，在定期推送的卡片中可以修改推送频率
• 如果希望主动修改，也可以向智能体发送「推送」，之后在回复的消息卡片中进行修改

创建企业自建应用

• 在弹出的创建企业自建应用的弹窗中，输入应用名称、应用描述和应用图标
• 输入完成后点击「创建」即可创建一个应用

为应用添加机器人的能力

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

为机器人添加需要的权限

• 如果要使机器人可以正常交互，需要为机器人添加一些权限，请在开发配置-权限管理中，勾选并批量开通这7个权限：
  • 获取应用信息
  • 管理应用自身资源
  • 获取用户 user ID
  • 获取与发送单聊、群组信息
  • 获取用户发给机器人的单聊信息(历史版本)
  • 获取与上传图片或文件资源
  • 获取通讯录基本信息

获取回调地址

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

为机器人配置请求地址

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

为机器人配置事件

• 在「事件配置」和「回调配置」页面，选择添加事件与回调
• 事件配置需要添加：
  • im.message.receive_v1
  • p2p_chat_create
• 回调配置需要添加：
  • card.action.trigger_v1

机器人发布

• 完成前面的步骤后，可以先将机器人发布一次，在「版本管理与发布」页面创建版本并发布即可

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

进入智能体基础信息页面

添加智能体

• 将飞书机器人的 App ID 和 App Secret 填入飞书基础设置中
• 之后配置完其他相关内容后即可发布智能体

添加成员

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

保存并发布

• 添加完成后保存并发布即可

飞书基础设置

• 点击基础设置右侧的编辑，可以编辑当前智能体的所接入飞书机器人的 App ID 和 App Secret

PC端基础设置

• 支持配置智能体在PC端展示的名称和描述
• 飞书端则以飞书机器人的信息配置为准

智能体管理员

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

主动推送卡片设置

• 支持配置智能体订阅推送时的卡片标题

智能体可用成员

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

添加数据集

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

语意模型配置

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

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

知识管理

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

删除选用的数据集

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

添加推荐问题

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

编辑与删除

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

编辑与删除 Prompt

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