https://github.com/chatopera/chatopera.feishu
通过 Feishu 开放平台和 Chatopera 机器人平台上线企业聊天机器人服务。
Feishu 开发者快速入门 Custom App BOT 服务开发!
Feishu(飞书) 聊天机器人应用(1/3)- 开发快速入门
Feishu(飞书) 聊天机器人应用(2/3)- 定制对话,实现知识库、信息查询、意图识别、多轮对话
Feishu(飞书) 聊天机器人应用(3/3)- DevOps机器人助手,管理 GitLab Issues,BOT 开源示例程序
集成 GitLab 实现项目的 Issue 管理。
功能 -
帮助
list projects
create issue 项目 标题
close issue 项目 #序号
reopen issue 项目 #序号
示例:
list projects
create issue cskefu 优化春松客服 ME 渠道管理创建表单
close issue cskefu #1120
reopen issue cskefu #1120
详细介绍(超链接)
该示例程序的上线过程,请详细阅读下文获得。
以下【Feishu Bot 应用】是指飞书开发者平台上的 Custom App,并且 Capability 为 【bot】。
根据文档创建 Feishu Custom App https://open.feishu.cn/document/uQjL04CN/ukzM04SOzQjL5MDN
在左侧导航栏,进入【Credentials & Basic Info】,得到 App ID
和 App Secret
。
开启 Bot 功能:在 Features 中设置 【Using Bot】为开启状态。
进入【Event Subscriptions】,获得 Verification Token
。
登录 Chatopera 云服务 https://bot.chatopera.com,创建【机器人】。
进入机器人设置页面,得到 Client Id
和 Secret
。
以上提到了两个“Bot 应用”,实际上是一个对话机器人应用的两个部分:"Feishu Bot 应用" 是渠道,"Chatopera Bot 应用"是自然语言对话管理;前者是“嘴”,后者是“脑”。
我们以 Python 语言为例,进入 Python 程序源文件目录app。
复制配置文件示例。
cd feishu/app
cp sample.env .env
vi .env # 使用文本编辑器编辑 .env 文件
参数对应列表
KEY | VALUE | DESCRIPTION |
---|---|---|
APP_ID | App ID |
Feishu Custom App Credentials & Basic Info 页 |
APP_SECRET | App Secret |
Feishu Custom App Credentials & Basic Info 页 |
APP_VERIFICATION_TOKEN | Verification Token |
Feishu Custom App Event Subscriptions 页 |
CHATOPERA_CLIENT_ID | Client Id |
Chatopera 聊天机器人设置页 |
CHATOPERA_SECRET | Secret |
Chatopera 聊天机器人设置页 |
安装 Python 依赖
cd feishu/app
pip install -r requirements.txt
cd feishu/app
./serve.sh
服务默认使用 8000 端口,可以在 .env
中增加环境变量 PORT=YOUR_PORT
自定义。
配置 HTTPs 服务,接入飞书要求使用 https server URL,测试目的建议使用 ngrok
ngrok http 8000
如上,得到 https URL 地址:https://xxx.ngrok.io
。
ngrok 下载和注册:https://dashboard.ngrok.com/。
再次进入 Feishu Custom App Event Subscriptions 页面,编辑 Request URL
的值。
将刚刚获得的 https URL 地址填写上,保存。
1)设置权限 进入飞书 Custom App 管理控制台,打开【Permissions】页面,发布新版本,并且选择权限如下。
2)发布到企业内部使用
进入飞书 Custom App 管理控制台,打开【Version Management & Release】页面。
创建新版本,并提交,此时因为企业内部审核,会自动通过。
在飞书客户端,Workspace 中搜索并激活机器人。
进入对话界面。
cd 根目录/feishu
./admin/build.sh
cd 根目录
cp sample.env .env # 修改 .env 文件,配置变量
docker-compose up -d
建议安装 Node.js 和 npm,然后可使用下面脚本自动重启。
cd feishu/app
# liveload script, auto restart app when modifications happens
./dev.sh
每次重启后,可能会延迟 20s 生效,因为每次重启会和 Feishu 中间重新做安全校验。
接下来,根据文档定制您的 BOT 对话能力,管理对话,是 Chatopera 机器人平台最核心的功能。
本项目提供面向 DevOps 的助手机器人,和 GitLab 集成,参考 README.md。
Powered by Chatopera 机器人平台。
Copyright 2021 北京华夏春松科技有限公司
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。