mirror of
https://github.com/labring/FastGPT.git
synced 2025-07-23 05:12:39 +00:00
e9d52ada73
* chore(ui): login page & workflow page (#3046) * login page & number input & multirow select & llm select * workflow * adjust nodes * New file upload (#3058) * feat: toolNode aiNode readFileNode adapt new version * update docker-compose * update tip * feat: adapt new file version * perf: file input * fix: ts * feat: add chat history time label (#3024) * feat:add chat and logs time * feat: add chat history time label * code perf * code perf --------- Co-authored-by: 勤劳上班的卑微小张 <jiazhan.zhang@ggimage.com> * add chatType (#3060) * pref: slow query of full text search (#3044) * Adapt findLast api;perf: markdown zh format. (#3066) * perf: context code * fix: adapt findLast api * perf: commercial plugin run error * perf: markdown zh format * perf: dockerfile proxy (#3067) * fix ui (#3065) * fix ui * fix * feat: support array reference multi-select (#3041) * feat: support array reference multi-select * fix build * fix * fix loop multi-select * adjust condition * fix get value * array and non-array conversion * fix plugin input * merge func * feat: iframe code block；perf: workflow selector type (#3076) * feat: iframe code block * perf: workflow selector type * node pluginoutput check (#3074) * feat: View will move when workflow check error;fix: ui refresh error when continuous file upload (#3077) * fix: plugin output check * fix: ui refresh error when continuous file upload * feat: View will move when workflow check error * add dispatch try catch (#3075) * perf: workflow context split (#3083) * perf: workflow context split * perf: context * 4.8.13 test (#3085) * perf: workflow node ui * chat iframe url * feat: support sub route config (#3071) * feat: support sub route config * dockerfile * fix upload * delete unused code * 4.8.13 test (#3087) * fix: image expired * fix: datacard navbar ui * perf: build action * fix: workflow file upload refresh (#3088) * fix: http tool response (#3097) * loop node dynamic height (#3092) * loop node dynamic height * fix * fix * feat: support push chat log (#3093) * feat: custom uid/metadata * to: custom info * fix: chat push latest * feat: add chat log envs * refactor: move timer to pushChatLog * fix: using precise log --------- Co-authored-by: Finley Ge <m13203533462@163.com> * 4.8.13 test (#3098) * perf: loop node refresh * rename context * comment * fix: ts * perf: push chat log * array reference check & node ui (#3100) * feat: loop start add index (#3101) * feat: loop start add index * update doc * 4.8.13 test (#3102) * fix: loop index;edge parent check * perf: reference invalid check * fix: ts * fix: plugin select files and ai response check (#3104) * fix: plugin select files and ai response check * perf: text editor selector;tool call tip;remove invalid image url; * perf: select file * perf: drop files * feat: source id prefix env (#3103) * 4.8.13 test (#3106) * perf: select file * perf: drop files * perf: env template * 4.8.13 test (#3107) * perf: select file * perf: drop files * fix: imple mode adapt files * perf: push chat log (#3109) * fix: share page load title error (#3111) * 4.8.13 perf (#3112) * fix: share page load title error * update file input doc * perf: auto add file urls * perf: auto ser loop node offset height * 4.8.13 test (#3117) * perf: plugin * updat eaction * feat: add more share config (#3120) * feat: add more share config * add i18n en * fix: missing subroute (#3121) * perf: outlink config (#3128) * update action * perf: outlink config * fix: ts (#3129) * 更新 docSite 文档内容 (#3131) * fix: null pointer (#3130) * fix: null pointer * perf: not input text * update doc url * perf: outlink default value (#3134) * update doc (#3136) * 4.8.13 test (#3137) * update doc * perf: completions chat api * Restore docSite content based on upstream/4.8.13-dev (#3138) * Restore docSite content based on upstream/4.8.13-dev * 4813.md缺少更正 * update doc (#3141) --------- Co-authored-by: heheer <heheer@sealos.io> Co-authored-by: papapatrick <109422393+Patrickill@users.noreply.github.com> Co-authored-by: 勤劳上班的卑微小张 <jiazhan.zhang@ggimage.com> Co-authored-by: Finley Ge <32237950+FinleyGe@users.noreply.github.com> Co-authored-by: a.e. <49438478+I-Info@users.noreply.github.com> Co-authored-by: Finley Ge <m13203533462@163.com> Co-authored-by: Jiangween <145003935+Jiangween@users.noreply.github.com>
97 lines
3.8 KiB
Markdown
97 lines
3.8 KiB
Markdown
---
|
||
title: "接入飞书机器人教程"
|
||
description: "FastGPT 接入飞书机器人教程"
|
||
icon: "chat"
|
||
draft: false
|
||
toc: true
|
||
weight: 504
|
||
---
|
||
|
||
从 4.8.10 版本起，FastGPT 商业版支持直接接入飞书机器人，无需额外的 API。
|
||
|
||
## 1. 申请飞书应用
|
||
|
||
开一个免费的测试企业更方便进行调试。
|
||
|
||
1. 在[飞书开放平台](https://open.feishu.cn/app)的开发者后台申请企业自建应用。
|
||
|
||
|
||
|
||
添加一个**机器人**应用。
|
||
|
||
## 2. 在 FastGPT 新建发布渠道
|
||
|
||
在fastgpt中选择想要接入的应用，在 发布渠道 页面，新建一个接入飞书机器人的发布渠道，填写好基础信息。
|
||
|
||
|
||
|
||
## 3. 获取应用的 App ID, App Secret 两个凭证
|
||
|
||
在飞书开放平台开发者后台，刚刚创建的企业自建应用中，找到 App ID 和 App Secret，填入 FastGPT 新建发布渠道的对话框里面。
|
||
|
||
|
||
|
||
填入两个参数到 FastGPT 配置弹窗中。
|
||
|
||
|
||
|
||
（可选）在飞书开放平台开发者后台，点击事件与回调 -> 加密策略 获取 Encrypt Key，并填入飞书机器人接入的对话框里面
|
||
|
||
|
||
|
||
Encrypt Key 用于加密飞书服务器与 FastGPT 之间通信。
|
||
建议如果使用 Https 协议，则不需要 Encrypt Key。如果使用 Http 协议通信，则建议使用 Encrypt Key
|
||
Verification Token 默认生成的这个 Token 用于校验来源。但我们使用飞书官方推荐的另一种更为安全的校验方式，因此可以忽略这个配置项。
|
||
## 4. 配置回调地址
|
||
|
||
新建好发布渠道后，点击**请求地址**，复制对应的请求地址。
|
||
|
||
在飞书控制台，点击左侧的 `事件与回调` ，点击`配置订阅方式`旁边的编辑 icon，粘贴刚刚复制的请求地址到输入框中。
|
||
|
||
| | | |
|
||
| --- | --- | --- |
|
||
|  |  |  |
|
||
|
||
## 5. 配置机器人回调事件和权限
|
||
|
||
* 添加 `接收消息` 事件
|
||
|
||
在`事件与回调`页面，点击`添加事件`。
|
||
|
||
搜索`接收消息`，或者直接搜索 `im.message.receive_v1` ，找到`接收消息 v2.0`的时间，勾选上并点击`确认添加`。
|
||
|
||
添加事件后，增加两个权限：点击对应权限，会有弹窗提示添加权限，添加上图两个权限。
|
||
|
||
| | |
|
||
| --- | --- |
|
||
|  |  |
|
||
|
||
不推荐启用上图中的两个“历史版本”，而是使用新版本的权限。
|
||
- 若开启 “读取用户发给机器人的单聊消息”， 则单聊发送给机器人的消息将被送到 FastGPT
|
||
- 若开启 “接收群聊中@机器人消息事件”， 则群聊中@机器人的消息将被送到 FastGPT
|
||
- 若开启（不推荐开启）“获取群组中所有消息”，则群聊中所有消息都将被送到 FastGPT
|
||
|
||
## 6. 配置回复消息权限
|
||
|
||
在飞书控制台，点击左侧的 `权限管理` ，搜索框中输入`发消息`，找到`以应用的身份发消息`的权限，点击开通权限。
|
||
|
||
|
||
|
||
## 7. 发布机器人
|
||
|
||
点击飞书控制台左侧的`版本管理与发布`，即可发布机器人。
|
||
|
||
|
||
|
||
然后就可以在工作台里找到你的机器人啦。接下来就是把机器人拉进群组，或者单独与它对话。
|
||
|
||
|
||
|
||
## FAQ
|
||
|
||
### 发送了消息，没响应
|
||
|
||
1. 检查飞书机器人回调地址、权限等是否正确。
|
||
2. 查看 FastGPT 对话日志，是否有对应的提问记录
|
||
3. 如果有记录，飞书没回应，则是没给机器人开权限。
|
||
4. 如果没记录，则可能是应用运行报错了，可以先试试最简单的机器人。（飞书机器人无法输入全局变量、文件、图片内容） |