飞书 AI 机器人保姆级教程

飞书机器人教程 AI 机器人配置 飞书开发者指南 AirCode 项目创建 飞书事件订阅
本文详细介绍了如何配置和使用飞书 AI 机器人。首先,用户需要在飞书开发者后台创建应用,并配置相关权限。接着,通过 AirCode 创建一个 Node.js 项目,并复制代码进行部署,同时设置必要的环境变量。然后,将部署后的调用地址配置到飞书后台的事件订阅中,并发布应用。最后,用户可以在飞书上与机器人进行互动。整个过程无需服务器启动,机器人可长期在线。通过本教程,用户可以独立完成飞书 AI 机器人的搭建与使用。
文章内容
思维导图
常见问题
社交分享

微信 AI 机器人已经给大家安排了,怎么少得了飞书机器人呢!

一、配置飞书开发者后台

首先登录到飞书的开发者后台,创建一个名为 ChatGPT 的应用,并上传应用头像。创建完成后,访问凭证与基础信息页面,复制 AppID 和 AppSecret 备用。

在应用能力下,添加机器人。

在权限管理页面进行权限配置,需要开通如下 6 个权限:

  1. im:message
  2. im:message.group_at_msg
  3. im:message.group_at_msg:readonly
  4. im:message.p2p_msg
  5. im:message.p2p_msg:readonly
  6. im:message:send_as_bot

二、创建 AirCode 项目

登录 AirCode ,创建一个新的 Node.js v18 的项目,项目名可以根据你的需要填写,例如填写 ChatGPT。

访问 页面代码,并复制全部代码,按照以下流程进行操作:

  1. 代码粘贴到 AIrcode 默认创建的 hello.js 文件上。
  2. 我们使用了飞书开放平台官方提供的 SDK,以及 axios 来完成调用。点击页面左下角的包管理器,安装 axios 和 @larksuiteoapi/node-sdk。
  3. 填充四个环境变量(APPID【飞书后台的 AppID】、SECRET【飞书后台的 AppSecret】、BOTNAME【机器人名称】、KEY【OpenAI 的 API 密钥】)
  4. 点击 Deploy 按钮进行部署使其生效,配置环境变量可能失败,有时候可能需要多部署几次。

部署成功的话,下方控制台显示内容如下:

点击复制函数的调用地址。

三、配置调用地址并发布

然后返回到飞书后台,来到事件订阅界面,配置订阅方式。将刚才复制的调用地址填充到请求地址里,保存即可。

点击添加事件,搜索接收消息,找到 2.0 版本进行勾选即可,最后确认添加。

最后来到版本控制页面,点击创建版本。版本号和更新说明随意填,满足格式即可。

滑动到页面最下方,点击保存,弹出提示框,选择申请线上发布。

在飞书上会收到这样的消息,点击打开应用就可以开始聊天了。

效果如下:

四、总结

大家根据教程一步一步执行,都可以独立搭建完成,快去体验一下~

这里还不用涉及到在服务器启动的问题,飞书的 AI 机器人可以长期在线。

点击跳转【小册目录】

思维导图生成中,请稍候...

问题 1: 如何开始配置飞书开发者后台?
回答: 首先登录飞书开发者后台,创建一个名为 ChatGPT 的应用,上传应用头像,并复制 AppID 和 AppSecret 备用。然后在应用能力下添加机器人,并在权限管理页面开通所需的 6 个权限。

问题 2: 在 AirCode 项目中需要安装哪些依赖?
回答: 在 AirCode 项目中需要安装 axios 和 @larksuiteoapi/node-sdk 这两个依赖。

问题 3: 如何配置 AirCode 项目的环境变量?
回答: 在 AirCode 项目中填充四个环境变量:APPID(飞书后台的 AppID)、SECRET(飞书后台的 AppSecret)、BOTNAME(机器人名称)、KEY(OpenAI 的 API 密钥)。

问题 4: 如何将 AirCode 项目的调用地址配置到飞书后台?
回答: 在飞书后台的事件订阅界面,将 AirCode 项目的调用地址填充到请求地址中,保存即可。

问题 5: 在飞书后台如何添加事件订阅?
回答: 在飞书后台的事件订阅界面,点击添加事件,搜索并勾选“接收消息 2.0”版本,最后确认添加。

问题 6: 如何发布飞书 AI 机器人?
回答: 在飞书后台的版本控制页面,点击创建版本,填写版本号和更新说明,保存后选择申请线上发布。

问题 7: 飞书 AI 机器人可以长期在线吗?
回答: 是的,飞书 AI 机器人可以长期在线,无需在服务器上启动。

问题 8: 部署成功后如何验证飞书 AI 机器人是否正常工作?
回答: 部署成功后,在飞书上会收到一条消息,点击打开应用即可开始聊天,验证机器人是否正常工作。

问题 9: 如果在配置过程中遇到环境变量部署失败怎么办?
回答: 如果环境变量部署失败,可以尝试多次点击 Deploy 按钮进行部署,直到成功为止。

问题 10: 如何获取 AirCode 项目的调用地址?
回答: 在 AirCode 项目部署成功后,下方控制台会显示调用地址,点击复制即可获取。