视频教程:BV1Fu4y1z7gX
视频链接:BV1Fu4y1z7gX
发布日期:2023-09-20
视频时长:10:15
播放量:3.1万
所属合集:FastGPT 教程系列
视频概要
演示如何将 FastGPT AI 知识库接入飞书(Lark),让团队在飞书中直接与AI助手对话。覆盖飞书开放平台应用创建、事件订阅、消息回调配置全过程。
知识点清单
A. 飞书开放平台配置
| 知识点 | 说明 | 重要程度 |
|---|---|---|
| 飞书开放平台 | open.feishu.cn,管理飞书应用 | ★★★★★ |
| 创建应用 | 创建企业自建应用 | ★★★★★ |
| App ID | 应用唯一标识 | ★★★★★ |
| App Secret | 应用密钥 | ★★★★★ |
| 权限配置 | 消息读写、用户信息等权限 | ★★★★ |
飞书开放平台操作路径:
1. 登录 open.feishu.cn
2. 创建企业自建应用
3. 获取 App ID 和 App Secret
4. 添加权限:
- im:message # 读取消息
- im:message:send_as_bot # 以机器人身份发消息
- contact:user.base:readonly # 读取用户基本信息
5. 发布应用版本
B. 事件订阅配置
| 事件 | 说明 | 必要性 |
|---|---|---|
| im.message.receive_v1 | 接收消息事件 | 必须 |
| url验证 | 飞书验证回调URL | 必须 |
| Encrypt Key | 消息加密密钥 | 推荐 |
| Verification Token | 验证令牌 | 推荐 |
事件订阅配置:
1. 进入应用 → 事件与回调
2. 设置请求地址(FastGPT提供的Webhook URL)
3. 添加事件:im.message.receive_v1
4. 保存配置
C. FastGPT 飞书接入
# 在FastGPT后台配置飞书接入
# 应用管理 → 选择应用 → 外部接入 → 飞书
# 需要填写的信息:
# - App ID: cli_xxxxxxxxxx
# - App Secret: xxxxxxxxxxxxx
# - Encrypt Key: (可选)
# - Verification Token: xxxxxxxxx
D. 消息处理流程
用户在飞书中@机器人或私聊机器人
↓
飞书将消息转发到事件订阅URL
↓
FastGPT接收消息事件
↓
提取用户消息内容
↓
在关联的知识库中检索
↓
AI模型生成回答
↓
通过飞书API发送回复
↓
用户在飞书中看到回答
常见问题
| 问题 | 解答 |
|---|---|
| 机器人没有反应? | 检查事件订阅URL是否可达,权限是否配置完整 |
| 权限申请被拒? | 需要管理员审批,确保已提交正确权限 |
| 应用无法发布? | 检查是否填写了所有必填信息,权限是否已审核 |
| 消息发送失败? | 检查App Secret是否正确,token是否过期 |
| 如何群聊使用? | 在群聊中@机器人即可触发对话 |
学习建议
- 飞书开放平台的操作步骤比较多,建议边看边做笔记
- 先完成FastGPT的基础部署再尝试接入飞书
- 如果是个人使用,建议创建测试企业来练习
- 飞书和企业微信的接入思路类似,学会一个另一个也容易