1. 概述
此文档就 对话式分析功能的 AIChat飞书集成 的方法进行了详细阐述，其编写主要目的是为了方便用户更流畅、便捷地了解功能的具体细节。部署完成后效果如下：
图1. 飞书工作台界面
图2. 飞书网页应用效果
2. 部署方法
2.1 设置飞书应用
2.1.1 创建飞书网页应用
通过以下网站，登录开发者后台： 通过以下地址，登录飞书开发者后台： https://open.feishu.cn/app?lang=zh-CN点击 “创建企业自建应用” ，点击 “创建企业自建应用”。
2.1.2 配置&发布应用
1. 点击 “添加应用能力”“添加应用能力”。
2. 在网页应用配置界面中填入对话式分析的地址：
- 桌面端主页 ： http://host:port/smartbi/vision/feishu/fsIndex.jsp
- 重定向 URL： http://host:port/smartbi/vision/feishu/fsIndex.jsp
3. 给应用进行飞书权限授权给应用进行飞书权限授权。
【配置应用权限】
需要给到应用配置以下权限：
权限名称 | 权限说明 | 使用场景 |
|---|---|---|
contact:contact:readonly_as_app | 以应用身份读取通讯录 | 用户同步 |
contact:department.organize:readonly | 获取部门组织架构信息 | 用户同步 |
contact:user.base:readonly | 获取用户基本信息 | 用户同步 |
contact:user.employee_id:readonly | 获取用户user ID | 用户同步 |
contact:user.phone:readonly | 获取用户手机号 | 用户同步 |
4. 配置安全设置
添加一个重定向的URL，在跟飞书交互时，会用到Oauth2登陆认证，飞书接受到登录请求后，会重定向回smartbi，并携带相关code信息。添加一个重定向的URL，在跟飞书交互时，会用到Oauth2登陆认证，飞书接受到登录请求后，会重定向回Smartbi，并携带相关code信息。此处需要将smartbi解析code并登录的地址配置到重定向URL内。
此处需要将smartbi解析code并登录的地址配置到重定向URL内。
以下以 http://proj.smartbi.com.cn:19060/smartbi/ 为例，应该设置重定向地址为： httphttp://proj.smartbi.com.cn:19060/smartbi/vision/FeiShuOauthLogin
5. 发布应用
2.1.3 配置应用用户范围
1.管理员登陆飞书后，点击头像，选择并点击“管理员后台”管理员登陆飞书后，点击头像，选择并点击“管理员后台”。
2. 展开 “工作台“ - 打开 “应用管理” - 搜索应用名称 - 点击 “配置”“配置”。
3. 配置应用的用户范围配置应用的用户范围。
2.2 安装&
...
配置飞书集成扩展包
2.2.1 获取&
...
安装扩展包
下载如下2个扩展包：
下载如下2个扩展包： PD_FeiShuCommon.ext、feishuext.ext
采用Smartbi的标准方式进行扩展包的安装部署，具体方法参考：部署扩展包 。
| 注意 |
|---|
更新扩展包之前，请做好知识库以及扩展包的备份。 |
2.2.2
...
配置扩展包
拓展包安装完成以后进入依次 扩展包安装完成以后进入依次 运维设置 - 系统选项 - 飞书集成，在对应的栏位输入飞书的应用信息飞书集成，在对应的栏位输入飞书的应用信息。
集成应用信息的来源是，在飞书开发者控制台的 “凭证与基础信息”页面中：
2.3 验证安装效果
利用普通用户登陆飞书，点击 “工作台”，找到对应的应用名称，如图：
点击进入界面，可以正常的展示界面即为正常。
