VOL.6 | Lark Aily 有上新！（含功能下线通知）-20240205

VOL.6 | Lark Aily 有上新！（含功能下线通知） 20240205 VOL.6 | Lark Aily 有上新！（含功能下线通知） 20240205 Created on February 1, 2024 4. 知识库添加云文档或知识空间的细节优化 添加 L3/L4 密级文档时的显示文案 针对 L3/L4 密级合规要求，增加文案提示： 根据集团安全合规要求，请勿在应用中配置外部用户的个人数据、密级为L3、L4的业务数据和集团数据。数据分类分级请参见：数据分类分级表 Data Classification Chart 5. 数据表及分析表的细节优化 对于高密级文档，增强提示 增加数据表及分析表连接前的密级提示。在连接时增加提示，不过滤 增加表名、字段名空值校验 分析表、数据表对应的表名称和字段名称增加非空校验（目前输入空格可保存，导致存在字段为空格的情况） 数据表枚举项限制放开 数据表的枚举项放量到500，解决IT搭建场景中使用限制问题 【会话与应用区】 1. 消息卡片能力与体验，多重优化 （1）图表支持 vchart 原生配置 参考 vchart 语法支持：https://www.visactor.io/vchart/guide/tutorial docs/Chart Concepts/Scrollbar 属性 类型 必填 默认值 说明 type 'bar' 是 data { value: T[] } 是 xField string | string[] 是 yField string | string[] 是 direction 'horizontal' | 'vertical' 否 'vertical' seriesField string 否 scrollBar [{ orient: 'bottom', startValue: '2011', endValue: '2014', }] 否 [] orient: • 滚动条组件位置。可选值：'left' | 'top' | 'right' | 'bottom' startValue: • 滚动条起点数据值 endValue: • 滚动条终点数据值 Code block Markdown Copy <chart chartSpec={ type: 'bar', data: [ { id: 'barData', values: [ { year: '2000', sales: 22 }, { year: '2001', sales: 13 }, { year: '2002', sales: 25 }, { year: '2003', sales: 29 }, { year: '2004', sales: 38 }, { year: '2005', sales: 49 }, { year: '2006', sales: 58 }, { year: '2007', sales: 29 }, { year: '2008', sales: 78 }, { year: '2009', sales: 19 }, { year: '2010', sales: 23 }, { year: '2011', sales: 20 }, { year: '2012', sales: 98 }, { year: '2013', sales: 49 }, { year: '2014', sales: 28 } ] } ], direction: 'horizontal', yField: 'year', xField: 'sales', scrollBar: [ { orient: 'right', startValue: '2011', endValue: '2014', } ] }/ （2）列数据类型支持 Markdown 支持的 Markdown 语法：Markdown 开发指南 开发文档 飞书开放平台 属性 类型 必填 默认值 columns (StringColumn | BooleanColumn | NumberColumn | DateColumn | OptionsColumn | PersonsColumn | MarkdownColumn)[] 是 data Data[] 是 MarkdownColumn 属性： 属性 类型 必填 默认值 说明 type 'markdown' 是 name string 是 displayName string 否 Data 属性： 属性 类型 必填 默认值 说明 [key: string] any，见说明 否 key：对应的是 column 中的 name value: 需要和 type 对应： string： string 类型 number： number 类型 boolean： boolean 类型 date：number 类型（时间戳） options：string 或 string[] 类型 persons：string 或 string[] 类型 markdown：string 注： persons 的值需要是 userID （3）列表支持嵌套 之前多级嵌套的场景中，会出现内容文本丢失。本次更新将多级嵌套的时候，降级展示为一级的无序列表、嵌套的列表内容用纯文本展示。对该问题予以修复。长期会支持原生展示。 2. 应用安装包链接上线，开发者可生成链接分享应用 生产安装包链接 应用开发者在应用卡片「···」可「查看应用安装包」，点击后进入「应用安装包」页面： 注意：只有开发人员才能看到「查看应用安装包」。 点击「生成安装包链接」按钮，弹出生成安装包链接弹窗后填写确认，即可生成： 生成说明 应用安装链接的本质是打包，因此会固化本次打包后的应用当前开发后台配置。链接生成后，应用内发生的变更，不会被纳入到已生成应用安装链接的范围。 • 用户新生成的安装包链接，会将最新的应用配置打包，同时之前的安装包链接依然可用。 • 涉及到连接外部系统或接口的凭证信息字段统一置空处理 打包范围及说明如下： 类型 细分 是否可以生成安装包 失败原因 备注 知识库 可以 数据表 外部（Excel、base）导入 可以 共享飞书应用引擎对象 不可以（租户内、全部租户） 数据表引用了飞书应用引擎共享数据，请删除该数据表再尝试生成应用包链接 长期：可实现，需要对架构进行改造； 短期：可通过本地创建相对应的数据结构解决该场景，需评估 数据分类分级表 Data Classification Chart Markdown 开发指南 开发文档 飞书开放平台 4. 知识库添加云文档或知识空间的细节优化 添加 L3/L4 密级文档时的显示文案 针对 L3/L4 密级合规要求，增加文案提示： 根据集团安全合规要求，请勿在应用中配置外部用户的个人数据、密级为L3、L4的业务数据和集团数据。数据分类分级请参见：数据分类分级表 Data Classification Chart 数据分类分级表 Data Classification Chart 5. 数据表及分析表的细节优化 对于高密级文档，增强提示 增加数据表及分析表连接前的密级提示。在连接时增加提示，不过滤 增加表名、字段名空值校验 分析表、数据表对应的表名称和字段名称增加非空校验（目前输入空格可保存，导致存在字段为空格的情况） 数据表枚举项限制放开 数据表的枚举项放量到500，解决IT搭建场景中使用限制问题 【会话与应用区】 1. 消息卡片能力与体验，多重优化 （1）图表支持 vchart 原生配置 参考 vchart 语法支持：https://www.visactor.io/vchart/guide/tutorial docs/Chart Concepts/Scrollbar 属性 类型 必填 默认值 说明 type 'bar' 是 data { value: T[] } 是 xField string | string[] 是 yField string | string[] 是 direction 'horizontal' | 'vertical' 否 'vertical' seriesField string 否 scrollBar [{ orient: 'bottom', startValue: '2011', endValue: '2014', }] 否 [] orient: • 滚动条组件位置。可选值：'left' | 'top' | 'right' | 'bottom' startValue: • 滚动条起点数据值 endValue: • 滚动条终点数据值 属性 属性 类型 类型 必填 必填 默认值 默认值 说明 说明 type type 'bar' 'bar' 是 是 data data { value: T[] } { value: T[] } 是 是 xField xField string | string[] string | string[] 是 是 yField yField string | string[] string | string[] 是 是 direction direction 'horizontal' | 'vertical' 'horizontal' | 'vertical' 否 否 'vertical' 'vertical' seriesField seriesField string string 否 否 scrollBar scrollBar [{ orient: 'bottom', startValue: '2011', endValue: '2014', }] [{ orient: 'bottom', startValue: '2011', endValue: '2014', }] 否 否 [] [] orient: • 滚动条组件位置。可选值：'left' | 'top' | 'right' | 'bottom' startValue: • 滚动条起点数据值 endValue: • 滚动条终点数据值 orient: • 滚动条组件位置。可选值：'left' | 'top' | 'right' | 'bottom' startValue: • 滚动条起点数据值 endValue: • 滚动条终点数据值 （2）列数据类型支持 Markdown 支持的 Markdown 语法：Markdown 开发指南 开发文档 飞书开放平台 Markdown 开发指南 开发文档 飞书开放平台 属性 类型 必填 默认值 columns (StringColumn | BooleanColumn | NumberColumn | DateColumn | OptionsColumn | PersonsColumn | MarkdownColumn)[] 是 data Data[] 是 属性 属性 类型 类型 必填 必填 默认值 默认值 columns columns (StringColumn | BooleanColumn | NumberColumn | DateColumn | OptionsColumn | PersonsColumn | MarkdownColumn)[] (StringColumn | BooleanColumn | NumberColumn | DateColumn | OptionsColumn | PersonsColumn | MarkdownColumn)[] 是 是 data data Data[] Data[] 是 是 MarkdownColumn 属性： 属性 类型 必填 默认值 说明 type 'markdown' 是 name string 是 displayName string 否 属性 属性 类型 类型 必填 必填 默认值 默认值 说明 说明 type type 'markdown' 'markdown' 是 是 name name string string 是 是 displayName displayName string string 否 否 Data 属性： 属性 类型 必填 默认值 说明 [key: string] any，见说明 否 key：对应的是 column 中的 name value: 需要和 type 对应： string： string 类型 number： number 类型 boolean： boolean 类型 date：number 类型（时间戳） options：string 或 string[] 类型 persons：string 或 string[] 类型 markdown：string 注： persons 的值需要是 userID 属性 属性 类型 类型 必填 必填 默认值 默认值 说明 说明 [key: string] [key: string] any，见说明 any，见说明 否 否 key：对应的是 column 中的 name value: 需要和 type 对应： string： string 类型 number： number 类型 boolean： boolean 类型 date：number 类型（时间戳） options：string 或 string[] 类型 persons：string 或 string[] 类型 markdown：string 注： persons 的值需要是 userID key：对应的是 column 中的 name value: 需要和 type 对应： string： string 类型 number： number 类型 boolean： boolean 类型 date：number 类型（时间戳） options：string 或 string[] 类型 persons：string 或 string[] 类型 markdown：string 注： persons 的值需要是 userID （3）列表支持嵌套 之前多级嵌套的场景中，会出现内容文本丢失。本次更新将多级嵌套的时候，降级展示为一级的无序列表、嵌套的列表内容用纯文本展示。对该问题予以修复。长期会支持原生展示。 2. 应用安装包链接上线，开发者可生成链接分享应用 生产安装包链接 应用开发者在应用卡片「···」可「查看应用安装包」，点击后进入「应用安装包」页面： 注意：只有开发人员才能看到「查看应用安装包」。 注意：只有开发人员才能看到「查看应用安装包」。 点击「生成安装包链接」按钮，弹出生成安装包链接弹窗后填写确认，即可生成： 生成说明 应用安装链接的本质是打包，因此会固化本次打包后的应用当前开发后台配置。链接生成后，应用内发生的变更，不会被纳入到已生成应用安装链接的范围。 • 用户新生成的安装包链接，会将最新的应用配置打包，同时之前的安装包链接依然可用。 • 涉及到连接外部系统或接口的凭证信息字段统一置空处理 打包范围及说明如下： 类型 细分 是否可以生成安装包 失败原因 备注 知识库 可以 数据表 外部（Excel、base）导入 可以 共享飞书应用引擎对象 不可以（租户内、全部租户） 数据表引用了飞书应用引擎共享数据，请删除该数据表再尝试生成应用包链接 长期：可实现，需要对架构进行改造； 短期：可通过本地创建相对应的数据结构解决该场景，需评估 类型 类型 细分 细分 是否可以生成安装包 是否可以生成安装包 失败原因 失败原因 备注 备注 知识库 知识库 可以 可以 数据表 数据表 外部（Excel、base）导入 外部（Excel、base）导入 可以 可以 共享飞书应用引擎对象 共享飞书应用引擎对象 不可以（租户内、全部租户） 不可以（租户内、全部租户） 数据表引用了飞书应用引擎共享数据，请删除该数据表再尝试生成应用包链接 数据表引用了飞书应用引擎共享数据，请删除该数据表再尝试生成应用包链接 长期：可实现，需要对架构进行改造； 短期：可通过本地创建相对应的数据结构解决该场景，需评估 长期：可实现，需要对架构进行改造； 短期：可通过本地创建相对应的数据结构解决该场景，需评估 自定义数据表 可以 分析表 从数据表同步 可以 从集成外部数据导入 可以 1.31交付有风险 虚拟集成（实时连接） 不可以（租户内、全部租户） 分析表来自集成外部数据，请删除该分析表再尝试生成应用包链接 从数据流导入 可以 术语库 术语库 可以 Data 数据类型 细分 是否可以生成安装包 失败原因 备注 知识库 来自数据表、分析表 可以 本地文件 可以 无 网页 可以 无 飞书相关业务（云文档、知识库、服务台） 可以（租户内） 不可以（全部租户） 知识库中有云文档、Wiki、服务台内容，需将该类内容剔除出知识库，再尝试生成应用包链接 数据表 外部（Excel、base）导入 可以 共享飞书应用引擎对象 不可以（租户内、全部租户） 数据表引用了飞书应用引擎共享数据，请删除该数据表再尝试生成应用包链接 自定义数据表 可以 分析表 从数据表同步 可以 从集成外部数据导入 可以 1.31交付有风险 虚拟集成（实时连接） 不可以（租户内、全部租户） 分析表来自集成外部数据，请删除该分析表再尝试生成应用包链接 从数据流导入 可以 术语库 术语库 可以 数据类型 数据类型 细分 细分 是否可以生成安装包 是否可以生成安装包 失败原因 失败原因 备注 备注 知识库 知识库 来自数据表、分析表 来自数据表、分析表 可以 可以 本地文件 本地文件 可以 可以 无 无 网页 网页 可以 可以 无 无 飞书相关业务（云文档、知识库、服务台） 飞书相关业务（云文档、知识库、服务台） 可以（租户内） 不可以（全部租户） 可以（租户内） 不可以（全部租户） 知识库中有云文档、Wiki、服务台内容，需将该类内容剔除出知识库，再尝试生成应用包链接 知识库中有云文档、Wiki、服务台内容，需将该类内容剔除出知识库，再尝试生成应用包链接 数据表 数据表 外部（Excel、base）导入 外部（Excel、base）导入 可以 可以 共享飞书应用引擎对象 共享飞书应用引擎对象 不可以（租户内、全部租户） 不可以（租户内、全部租户） 数据表引用了飞书应用引擎共享数据，请删除该数据表再尝试生成应用包链接 数据表引用了飞书应用引擎共享数据，请删除该数据表再尝试生成应用包链接 自定义数据表 自定义数据表 可以 可以 分析表 分析表 从数据表同步 从数据表同步 可以 可以 从集成外部数据导入 从集成外部数据导入 可以 可以 1.31交付有风险 1.31交付有风险 虚拟集成（实时连接） 虚拟集成（实时连接） 不可以（租户内、全部租户） 不可以（租户内、全部租户） 分析表来自集成外部数据，请删除该分析表再尝试生成应用包链接 分析表来自集成外部数据，请删除该分析表再尝试生成应用包链接 从数据流导入 从数据流导入 可以 可以 术语库 术语库 术语库 术语库 可以 可以 用户可基于链接安装应用 访问应用链接（有登录态） 安装包链接生效的页面 访问应用链接（有登录态） 访问应用链接（有登录态） 安装包链接生效的页面 安装包链接生效的页面 3. 应用开发支持英文版本（灰度） Aily平台使用者，进入Aily首页、应用开发后台、应用管理后台，点击右上角头像，可以切换语言。目前支持：中文、英语。 目前该功能正在灰度，加入灰度群即可体验 目前该功能正在灰度，加入灰度群即可体验 Group card (Log in to view) Group card 4. 发布时支持一键同步开发数据到线上（灰度） 申请灰度方式：https://bytedance.larkoffice.com/share/base/form/shrcn09SznUSRl9XRzfAoHlP1GD 申请灰度方式：https://bytedance.larkoffice.com/share/base/form/shrcn09SznUSRl9XRzfAoHlP1GD 在保证线上线下的数据隔离的同时， 允许有运维人员角色的开发者，将本次发布中有新增的知识库、数据表和分析表，支持将其中的知识内容和测试数据同步至线上。减少一些重复数据的两次维护成本，提升效率。 在发布时可查看测试数据同步至线上模块和选择是否带至线上 只有操作人员有运维人员角色时，才能看到这个模块。 发布后，在发布页面的配置线上数据中展示数据同步状态 5. 运营管理升级，新增运维指标和支持指标环比、趋势和下钻（灰度） 申请灰度方式：https://bytedance.larkoffice.com/share/base/form/shrcn09SznUSRl9XRzfAoHlP1GD 申请灰度方式：https://bytedance.larkoffice.com/share/base/form/shrcn09SznUSRl9XRzfAoHlP1GD 面向 Aily 的运维人员，提供运维和运营分析指标，可以更全面了解应用运行过程中的性能、成本和用户使用情况，从而可以更针对性地迭代应用。 运营管理页面中，顶部的「运营管理」改为「应用分析」 增加数据总栏 一共有6个数据总栏指标： • 对话数：用户给AI应用发送的消息数，包括命中技能和没有命中技能的情况 • 活跃用户数：主动跟AI应用有互动的用户数量 • 用户满意度：1 不满意的对话数 / 总对话数，反映了用户对AI应用回复的满意程度 • 用户反馈率：统计用户有反馈（包括点赞和点踩）的AI回复数 / 总的AI回复数 • 技能平均响应时间：衡量 AI 应用处理和回复用户请求所花费的平均时间，反映性能和用户体验 • 技能成功率：用户输入请求后技能的成功率，反映了该应用当前的稳定性情况 优化和新增运营指标，支持指标趋势和下钻 • 对话数：从统计总对话数调整成趋势图，支持by渠道下钻 • 活跃用户数：从统计总的活跃用户数调整成趋势图，支持by渠道下钻 • 用户满意度：从统计该周期的用户满意度调整成趋势图 • 用户反馈率：统计用户有反馈（包括点赞和点踩）的AI回复数 / 总的AI回复数 新增运维指标 • 单轮对话响应时间：趋势图展示，支持by技能下钻 • 对话技能状态：趋势图展示，支持by技能下钻 6. 应用发布细节优化 发布时会自动计算图片「获取与上传图片或文件资源」权限，避免线上消息有图片内容时，出现兜底裂开图片。 【账号与权限区】 1. 角色成员中的用户、部门记录范围修正 角色成员中，条件筛选时： 「用户」的记录范围为「全部内部用户+本应用外部用户」，不受应用可用范围或通讯录范围限制 「部门」的记录范围为全部部门，不受应用可用范围或通讯录范围限制 指定某用户时： 「用户」的记录范围为「全部内部用户+本应用外部用户」，不受应用可用范围或通讯录范围限制 ⚠️ 以下功能有下线，请注意！⚠️ Aily 回复的消息不再支持详情、收藏 2024/1/31 更新后，下图中的「详情」、「收藏」按钮将不再展示： 因产品规划调整，后续将使用更完整 Web 端「会话应用」来承载相关能力（可参见下图） 短期考虑维护成本、降低用户干扰先暂时下线这两个功能，相关更新敬请期待！ღ( ´･ᴗ･` ) 发布时间：2024/02/05 🚀 本期亮点推荐： 🌟 多模态来了！Workflow 新增 OCR 节点 🌟 “新版 API 技能”上线，能力升级 🌟 数据分析技能可查看“数据解释”，数据生成过程可溯源 🌟 知识库支持混合搜索～ 🌟 分析表新增 PostgreSQL 数据连接 🌟 数据表支持关闭共享，以及解除引用 🌟 发布时，支持将开发数据“一键同步”到线上！ 🌟 应用安装包链接上线，开发者可生成链接分享应用了 🌟 运营管理升级！新增运维指标和支持指标环比、趋势和下钻 ⚠️ 回复的消息不再支持详情、收藏。注意了！ …… 本期亮点推荐： 🌟 多模态来了！Workflow 新增 OCR 节点 🌟 “新版 API 技能”上线，能力升级 🌟 数据分析技能可查看“数据解释”，数据生成过程可溯源 🌟 知识库支持混合搜索～ 🌟 分析表新增 PostgreSQL 数据连接 🌟 数据表支持关闭共享，以及解除引用 🌟 发布时，支持将开发数据“一键同步”到线上！ 🌟 应用安装包链接上线，开发者可生成链接分享应用了 🌟 运营管理升级！新增运维指标和支持指标环比、趋势和下钻 ⚠️ 回复的消息不再支持详情、收藏。注意了！ …… 🚀 新功能来咯，请君一试！🚀 【技能区】 1. Workflow 新增 OCR 节点，增强多模态资源消费能力 OCR（光学字符识别）能够从图片中识别并提取文本内容。 此功能适用于将用户上传的照片中的文字转换为可编辑的文本格式，提高数据处理的效率和准确性。OCR 节点可以识别终端用户上传的图片信息，并提取出每张图片中的文本内容，以列表的形式输出给下游消费。实现效果示范： 多模态能力效果案例：OCR、图生图 多模态能力效果案例：OCR、图生图 节点如图所示，具体配置说明：技能：workflow 自己搭建技能 技能：workflow 自己搭建技能 2. Workflow 新增变量赋值节点，满足执行过程中数据加工、计算结果的临时存储需求 「操作节点」分类中「技能」后新增「设置变量」节点。点击添加「设置变量」节点，即可进入配置面板。设置变量列表： 1. 待赋值变量：支持通过 {{ 选择待赋值的变量和新建变量 2. 变量类型：支持选择的数据类型：string（文本）、integer（整数）、float（浮点数）、boolean（布尔）、object（对象）、list（列表） 3. 将变量赋值为：变量赋值节点新建的变量作为该节点的输出变量供下游消费，在变量选择面板中以节点名称聚合显示，支持以 {{节点名称.变量名称}} 方式消费 3. “新版 API 技能”上线，能力升级 新版的 API 技能，支持在一个技能中添加多个 API，终端用户可以直接使用自然语言说出需求，由大模型编排 API 的组合调用顺序，以实现不同场景的用户需求。开发者侧，仅需要使用自然语言配置准确的 API 描述和 API 调用说明即可。 终端用户触发效果 天气查询技能，支持查询指定城市的实时天气和未来几天的天气预报 任务管理技能，支持帮助用户新建任务、完成任务、列出未完成任务、添加任务关注人 OKR 技能，支持帮助用户查询 OKR 信息、查询 OKR 完成进度 天气查询技能，支持查询指定城市的实时天气和未来几天的天气预报 天气查询技能，支持查询指定城市的实时天气和未来几天的天气预报 任务管理技能，支持帮助用户新建任务、完成任务、列出未完成任务、添加任务关注人 任务管理技能，支持帮助用户新建任务、完成任务、列出未完成任务、添加任务关注人 OKR 技能，支持帮助用户查询 OKR 信息、查询 OKR 完成进度 OKR 技能，支持帮助用户查询 OKR 信息、查询 OKR 完成进度 新版 API 技能，可以针对一个特定场景，智能编排需要用到的 API。因此当你确定好 API 技能的使用场景后，需要进一步确定需要用到哪些 API。 注意事项： 1. 请尽量选择 Azure: GPT 3.5 turbo 16k 或更高的模型 2. 目前一个 API 技能内，最多支持添加 8 个 API。大模型编排时，最多支持编排 10 次 API 调用。 在技能市场，也为开发者们准备了一些配置好的 API 技能模板，点击直接安装使用： 具体使用说明，可查看帮助文档：技能：新版 API 技能 技能：新版 API 技能 4. 数据分析技能增加查看数据解释，数据生成过程可溯源 本次更新主要实现：在数据分析技能返回的结果中增加“查看数据解释”，辅助用户理解和验证数据，增加平台数据分析技能的可信性。数据可解释性提供的辅助信息，包括：来源分析表、数据查询步骤、数据查询结果、生成的SQL、图表生成解释、洞察生成解释。 当在 Bot 中输入问题，召回了数据分析技能进行应答。用户可点击返回结果中的按钮「查看数据解释」， 跳转到数据解释详情页。如图： 完整页面： 查看结果、查看SQL： 完整页面： 完整页面： 查看结果、查看SQL： 查看结果、查看SQL： 配置入口： 在数据分析技能的配置中打开「生成洞察」的开关。打开后， AI 会根据用户的查询意图判断是否给出文字洞察。 5. 数据分析、数据更新技能，新建数据来源选择UI优化 优化点如下： 关联已有分析表与同步新的分析表逻辑的UI界面区分更明显，包括调整 Icon 颜色 「关联XX表」文案改成「关联已有XX表」 下方渠道上面加一行图上的文案 【数据与知识区】 1. 分析表新增 PostgreSQL 数据连接 PostgreSQL 作为常见的关系型数据库类型，本