本系列飞书应用开发的上一篇文章Feishu(飞书) 聊天机器人应用(1/2)- 开发快速入门,本文侧重结合飞书和 Chatopera 服务上线智能对话机器人应用。
在前一篇文章中,重点介绍了在飞书群里使用 Custom Bot,推送消息的功能,但是在群里 @机器人或私聊,得不到回复。本文的目标就是提供一个开源程序,开发者可以让机器人回复群聊或私聊的消息。
通过 Feishu 开放平台和 Chatopera 机器人平台上线企业聊天机器人服务。
- Feishu:高效率的协作办公软件
- Chatopera 机器人平台:定制智能对话机器人的开发者平台
https://github.com/chatopera/chatopera.feishu
以下【Feishu Bot 应用】是指飞书开发者平台上的 Custom App,并且 Capability 为 【bot】。
创建 Feishu Bot 应用
根据文档创建 Feishu Custom App https://open.feishu.cn/document/uQjL04CN/ukzM04SOzQjL5MDN
在左侧导航栏,进入【Credentials & Basic Info】,得到 和 。
开启 Bot 功能:在 Features 中设置 【Using Bot】为开启状态。
进入【Event Subscriptions】,获得 。
创建 Chatopera Bot 应用
登录 Chatopera 云服务 https://bot.chatopera.com,创建【机器人】。
进入机器人设置页面,得到 和 。
以上提到了两个“Bot 应用”,实际上是一个对话机器人应用的两个部分:“Feishu Bot 应用” 是渠道,"Chatopera Bot 应用"是自然语言对话管理;前者是“嘴”,后者是“脑”。
编辑描述文件
我们以 Python 语言为例,进入 Python 程序源文件目录app。
复制配置文件示例。
参数对应列表
安装依赖
- 前提条件 Python3, pip
安装 Python 依赖
启动服务
服务默认使用 8000 端口,可以在 中增加环境变量 自定义。
配置 HTTPs 服务,接入飞书要求使用 https server URL,测试目的建议使用
如上,得到 https URL 地址:。
ngrok 下载和注册:https://dashboard.ngrok.com/。
配置 Feishu Custom App 消息事件订阅
再次进入 Feishu Custom App Event Subscriptions 页面,编辑 的值。
将刚刚获得的 https URL 地址填写上,保存。
发布上线机器人
1)设置权限
进入飞书 Custom App 管理控制台,打开【Permissions】页面,发布新版本,并且选择权限如下。
2)发布到企业内部使用
进入飞书 Custom App 管理控制台,打开【Version Management & Release】页面。
创建新版本,并提交,此时因为企业内部审核,会自动通过。
在飞书客户端,Workspace 中搜索并激活机器人,进入对话界面。
开发
1)修改程序,增加功能
建议安装 Node.js 和 npm,然后可使用下面脚本自动重启。
每次重启后,可能会延迟 20s 生效,因为每次重启会和 Feishu 中间重新做安全校验。
2)增加对话能力
接下来,根据文档定制您的 BOT 对话能力,管理对话,是 Chatopera 机器人平台最核心的功能:
- Chatopera 机器人平台文档中心
- 示例程序
- 视频教程
- Deep Dive
- Python SDK Docs
- Chatopera 机器人平台系统集成文档
Chatopera 文档中心
Create Tickets
Create a custom app on Feish
Develop a bot app on Feishu
Chatopera 云服务入门
Chatopera 云服务 Deep Dive
聊天机器人对话模板:招聘机器人、天气查询、活动通知、寒暄等
- Feishu(飞书) 聊天机器人应用(1/3)- 开发快速入门
- Feishu(飞书) 聊天机器人应用(2/3)- 定制对话,实现知识库、信息查询、意图识别、多轮对话
- Feishu(飞书) 聊天机器人应用(3/3)- DevOps机器人助手,管理 GitLab Issues,BOT 开源示例程序
Copyright 2021 北京华夏春松科技有限公司
Apache License Version 2.0