Skip to main content

飞书

一、托管接入

版本要求: 专业版及以上

提示

托管接入是Link平台提供的一键接入服务,无需部署程序,只需在线填写配置即可完成。飞书的托管接入在 专业版 可用。

飞书应用 支持企业内部员工访问,支持一对一单聊和内部群中使用。

1. 飞书应用创建和权限配置

1.1 进入飞书开发平台 ,点击创建企业自建应用


1.2 在添加应用能力菜单中,为应用添加机器人能力


1.3 添加权限

点击权限管理,复制下面的权限配置,然后粘贴到权限配置下方的输入框内,全选筛选出来的权限,点击批量开通,最后点击确认:

im:message,im:message.group_at_msg:readonly,im:message.p2p_msg:readonly,im:message:send_as_bot,im:resource,contact:contact.base:readonly,contact:user.base:readonly,im:chat:readonly

2. 填写配置

2.1 在凭证与基础信息内获取 App ID 和 App Secret


2.2 在 事件订阅 内获取 Verification Token


注意: 在获取Verification Token时,需确保Encrypt Key为未开启状态

2.3 LinkAI控制台配置信息填写

在LinkAI控制台的 应用接入 菜单中选择 飞书 渠道,点击托管,根据弹窗的操作步骤填写第1~2步:


3. 配置事件订阅

3.1 复制回调地址


3.2 在飞书开放平台-事件与回调-事件配置中,将3.1的回调地址填入请求地址中,点击保存


3.3 在同一页面,点击下方的添加事件,搜索“接收消息”,选择“接收消息v2.0”,确认添加。


4. 发布和使用

完成全部配置后,点击版本管理与发布,点击创建版本,并申请线上发布,在飞书客户端查看审批消息,并审核通过。


审核完成并发布后后,即可在飞书与AI机器人进行对话,同时可以在 客户端管理 中进行进一步配置和管理(如配置机器人飞书群聊对话能力、开启流式输出效果等),如图所示:


单聊使用时,可在飞书搜索框内直接搜索机器人名称(第1步创建应用时的应用名称)。
在群内使用时:1、前往客户端管理配置机器人名称;2、将机器人添加进群并@机器人进行对话(路径:群设置-群机器人-添加机器人)

使用提示
  1. 目前飞书基础免费版对于每月的自建应用API调用存在次数限制。本功能会对API调用次数产生消耗,如超出可能需要升级您的飞书付费版本,否则无法正常使用本功能,详情查看说明
  2. 如客户端绑定的应用有配置数据库,建议关闭流式输出功能。当用户提问触发数据库查询时无法兼容流式输出效果,会造成机器人无法正常回复。

5. 使用效果

以下是接入飞书的使用效果示例:

智能体接入飞书,企业员工可通过私聊或群聊与AI机器人进行AI智能对话、知识库智能问答、获取知识库中的图片/文件/视频等素材;使用Dall-E插件或Midjourney插件进行图像创作、AI识别理解图像;使用内容总结插件总结公众号文章或使用网页速读插件总结网页内容等功能。飞书AI机器人支持流式输出与markdown格式。同时可在LinkAI对话管理页面实时查看AI与公众号渠道的用户对话记录:

1. 知识库智能问答、联网搜索等插件调用

基于企业私有知识进行问答,为员工提供管理、业务等方面的咨询支持:


2. 内容总结、网页速读

使用内容总结插件总结文件、公众号文章或网页内容:


3. AI 图像识别

AI识别图像内容后基于提问和图像信息进行回答:


4. 图像创作

同时支持 dall-e-3 和 midjourney:


5. 流式输出



6. 更多用法

可将LinkAI控制台 URL 配置到一个新的「企业自建应用-网页应用」中,即可实现从飞书一键直达LinkAI后台,快速处理应用搭建、对话管理人工回复任务,以及使用广场对话等。效果示例如下:



二、自建接入

注意

自建接入基于开源项目 chatgpt-on-wechat 进行部署,以单进程方式运行,建议对性能、稳定性有要求的生产需求使用 托管模式 接入。参考该项目的 飞书接入文档 进行项目的运行。

自建接入的方式通过开源项目实现,非LinkAI官方功能,使用者需根据开源项目协议、使用教程和相关文档自助使用。LinkAI不提供自建接入的任何技术支持或使用咨询服务,也不对因使用开源项目自建接入所产生的任何问题或后果承担责任。

1. 准备

需要的资源有:

  1. 一台服务器,国内国外均可
  2. 一个飞书账号,具有企业应用管理权限

2. 项目配置

在该开源项目中将LinkAI接入飞书 同样只需修改三个配置:

"use_linkai": true,
"linkai_api_key": "YOUR API KEY",
"linkai_app_code": "YOUR APP CODE"

linkai_api_keylinkai_app_code 的获取可以参考 个人微信 中的说明。

其余项目配置参考 飞书接入文档