Yan-英杰的主页

悟已往之不谏 知来者之可追  

C++程序员，2024届电子信息研究生

目录

前言

环境列表

视频教程

1.飞书设置

2.克隆feishu-chatgpt项目

3.配置config.yaml文件

4.运行feishu-chatgpt项目

5.安装cpolar内网穿透

6.固定公网地址

7.机器人权限配置

8.创建版本

9.创建测试企业

10. 机器人测试

前言

在飞书中创建chatGPT机器人并且对话，在下面操作步骤中，使用到了Git克隆项目，需提前安装好Git，克隆的项目是Go语言项目，所以需提前安装Go语言环境。

环境列表

• Git

• Go1.20

视频教程

【飞书接入AI】将A集成到飞书机器人

1.飞书设置

首次注册飞书,我们可以创建个人账号

进入后 我们创建一个飞书企业自建项目

然后设置机器人名称和描述,下面选择图标和颜色

创建成功后,添加一下机器人的能力

2.克隆feishu-chatgpt项目

feishu-chatgpt项目集成了飞书调用chatgpt的功能，这边使用windwos系统 在powershell中使用git克隆项目，选择目录，把项目克隆下来

git clone https://github.com/Leizhenpeng/feishu-chatgpt.git

然后进入code目录

cd feishu-chatgpt/code

修改配置文件名称

mv config.example.yaml config.yaml

3.配置config.yaml文件

在我们上面clone下来的项目目录的code文件夹下,可以看到config.yaml配置文件

打开配置文件,我们可以看到前面两个参数对应的是飞书上面我们创建项目的APP ID和App Secret

打开飞书,复制对应的参数

将这两个参数对应填写到配置文件中

然后下面还有两个参数：APP_ENCRYPT_KEY以及APP_VERIFICATION_TOKEN

同样在飞书里面,点击事件与订阅,然后我们可以看到

第一个值未开启,我们点击刷新即可

然后我们把两个值分别对应填写到配置文件中,记得保存

填写好飞书的参数后，接下来设置配置文件中openAI的参数，我们需要获取openAI的KEY，可以去openAI官网自己账号获取，也可以有一些免费网站获取测试，如https://freeopenai.xyz/ 这个网站，我们可以获取一个key，获取后我们把key值填写到配置文件中，记得保存文件

​ 打开配置文件,我们可以看到前面两个参数对应的是飞书上面我们创建项目的APP ID和App Secret

​ 最后,设备需要使用代理,在最后一行配置代理,不配置的话无法访问chatgpt接口,得不到chatGPT返回的回答

4.运行feishu-chatgpt项目

首次运行会下载相关所需的包,为了防止下载不成功,先设置一下go中的代理,执行下面命令切换国内代理

go env -w GOPROXY=https://goproxy.cn,direct

然后运行main.go文件,启动项目,

go run main.go

注意看图片上面的路径，一定是在feishu-chatgpt项目的code文件夹下操作，启动后我们可以看到端口号，端口号为:9000

服务启动后，接下来我们需要设置飞书机器人连接我们服务的地址，要求我们设置外网地址，不能使用局域网地址。

这里我们用cpolar内网穿透工具将本地9000端口下的服务映射到公网上，它会自动生成返回相应的公网地址，就可以使用这个公网地址设置飞书机器人连接服务，不需要公网IP，不用设置路由器，也不需要公网服务器。

5.安装cpolar内网穿透

cpolar官网：cpolar – 安全的内网穿透工具

访问cpolar官网，注册一个账号，然后下载并安装windows版本的cpolar客户端。

cpolar内网穿透安装成功后，在浏览器上访问本地9200端口【http://localhost:9200】，使用cpolar账号登录。

点击左侧仪表盘的隧道管理——创建隧道，创建一个http隧道，指向9000端口,就是上面我们运行main.go的服务端口号

• 隧道名称：可自定义命名，注意不要与已有的隧道名称重复

• 协议：选择http

• 本地地址：9000

• 域名类型：免费选择随机域名

• 地区：选择China vip

点击创建

隧道创建成功后，点击左侧的状态——在线隧道列表,查看所生成的公网地址，然后复制地址

然后打开飞书机器人,我们填写上面的公网地址,注意,需加上资源路径/webhook/card,然后点击验证

点击验证后没有任何提示表示成功,我们在powershell中也可以看到打印的日志

6.固定公网地址

由于我们刚刚创建的是免费随机临时的隧道，他生成的公网地址会在24小时内随机变化，不适合作为长期使用的链接。所以我们接下来固定这个公网地址。

注意需要将cpolar套餐升级至基础套餐或以上，且每个套餐对应的带宽不一样。

登录cpolar官网后台，点击左侧的预留，选择保留二级子域名，设置一个二级子域名名称，点击保留,保留成功后复制保留的二级子域名名称

保留成功后复制保留的二级子域名地址

访问本地9200端口【127.0.0.1:9200】，登录cpolar web UI管理界面，点击左侧仪表盘的隧道管理——隧道列表，找到所要配置的隧道，点击右侧的编辑

修改隧道信息，将保留成功的二级子域名配置到隧道中

• 域名类型：选择二级子域名

• Sub Domain：填写保留成功的二级子域名

点击更新

更新完成后,打开在线隧道列表,此时可以看到公网地址已经发生变化,地址名称也变成了保留的二级子域名名称,将其复制下来

然后我们打开飞书机器人,把随机地址换成我们固定的公网地址,然后点击保存

然后打开下面的事件订阅,同样把公网地址设置进去,后面的资源路径改为/webhook/event,然后点击保存

7.机器人权限配置

打开权限管理,筛选权限,输入im:message

然后批量开通如下权限

• im:resource(获取与上传图片或文件资源)

• m:message

• im:message.group_at_msg(获取群组中所有消息)

• im:messagegroup_at_msg:readonly(接收群聊中@机器人消息事件)

• im:message.p2p_msg(获取用户发给机器人的单聊消息)

• im:messagep2p_msg:readonly(读取用户发给机器人的单聊消息)

• im:message:send_as_bot(获取用户在群组中@机器人的消息)

• im:chat:readonly(获取群组信息)

• im:chat(获取与更新群组信息)

搜索im:resource,开通这个权限

然后再次输入im:chat,开通如下两个权限

然后添加事件,添加如下三个事件

8.创建版本

点击上面创建版本,填写版本信息和更新说明

然后点击下面保存

保存成功后申请线上发布

9.创建测试企业

点击旁边的测试企业和人员,我们创建一个测试企业

创建好后点击关联应用

然后我们切换账号,切换成我们上面创建的测试企业账号

切换后可以看到我们创建的机器人项目,点击进去

我们可以看到状态已经发布状态

然后我们还要继续设置最后一步,打开凭证与基础信息,查看APPID和APP Secret这两个值

然后把上面的两个值在我们配置文件中替换掉,配置文件使用的是飞书个人账号的值,现在创建了测试企业号,需改为测试企业号的APPID和APP Secret

改完后重新启动即可

10. 机器人测试

下载飞书,打开飞书,登陆的时候选择我们上面创建的测试企业账号

然后点击搜索

输入chat,即可看到我们自己设置的机器人,点击

然后即可进行对话,机器人回复有点慢,因为是海外接口