视频教程:BV1Tp4y1n72T
视频链接:BV1Tp4y1n72T
发布日期:2023-08-23
视频时长:08:49
播放量:2.2万
所属合集:FastGPT 教程系列
视频概要
手把手演示如何将 FastGPT 创建的 AI 知识库机器人接入企业微信,让团队成员在日常沟通工具中直接使用 AI 问答服务。覆盖企业微信应用创建、回调地址配置、FastGPT Webhook 对接全流程。
知识点清单
A. 企业微信应用创建
| 知识点 | 说明 | 重要程度 |
|---|---|---|
| 企业微信管理后台 | 登录 work.weixin.qq.com 管理企业应用 | ★★★★★ |
| 自建应用 | 在「应用管理」中创建自建应用 | ★★★★★ |
| AgentId | 应用唯一标识,后续对接需要 | ★★★★★ |
| Secret | 应用密钥,用于获取 access_token | ★★★★★ |
| 可见范围 | 控制哪些成员可以使用该应用 | ★★★★ |
企业微信管理后台路径:
work.weixin.qq.com → 应用管理 → 自建 → 创建应用
必填信息:
- 应用名称:如「AI助手」
- 应用Logo:上传一个图标
- 可见范围:选择部门或成员
B. 回调地址配置
| 步骤 | 操作 | 说明 |
|---|---|---|
| 1 | 设置接收消息的URL | 填入FastGPT提供的Webhook地址 |
| 2 | Token | 企业微信验证令牌,需与FastGPT一致 |
| 3 | EncodingAESKey | 消息加密密钥,可随机生成 |
| 4 | 验证 | 企业微信会向URL发送验证请求 |
配置路径:
应用管理 → 选择你的应用 → 接收消息 → 设置API接收
回调URL格式:
https://your-domain.com/api/wechat/callback
Token & EncodingAESKey:
需要与FastGPT中配置的值保持一致
C. FastGPT 端配置
| 配置项 | 说明 | 重要程度 |
|---|---|---|
| Webhook URL | 企业微信的消息接收地址 | ★★★★★ |
| CorpId | 企业ID,在「我的企业」页面获取 | ★★★★★ |
| 应用凭证 | AgentId + Secret 组合 | ★★★★★ |
| 知识库关联 | 选择要接入的知识库 | ★★★★ |
FastGPT后台 → 应用 → 选择应用 → 外部接入 → 企业微信
填写:
- 企业ID (CorpId)
- AgentId
- Secret
- Token
- EncodingAESKey
D. 消息流转流程
用户在企业微信发消息
↓
企业微信服务器收到消息
↓
通过回调URL转发给FastGPT
↓
FastGPT在知识库中检索相关内容
↓
AI模型生成回答
↓
通过企业微信API回复用户
↓
用户在企业微信收到回答
完整操作步骤
# 步骤1:登录企业微信管理后台
# https://work.weixin.qq.com/
# 步骤2:创建自建应用
# 应用管理 → 自建 → 创建应用 → 填写名称和Logo
# 步骤3:获取企业凭证
# 我的企业 → 企业信息 → 企业ID
# 应用管理 → 选择应用 → AgentId / Secret
# 步骤4:配置FastGPT
# FastGPT后台 → 应用 → 外部接入 → 企业微信
# 填入企业ID、AgentId、Secret等信息
# 步骤5:设置回调
# 企业微信 → 应用管理 → 接收消息 → 设置API接收
# 填入回调URL、Token、EncodingAESKey
# 步骤6:测试
# 在企业微信中找到应用,发送消息测试
常见问题
| 问题 | 解答 |
|---|---|
| 回调验证失败? | 检查URL是否可达、Token/AESKey是否一致、HTTPS证书是否有效 |
| 消息发送后无回复? | 检查FastGPT日志,确认知识库是否正常运行 |
| 成员看不到应用? | 检查应用可见范围设置,确认已发布应用 |
| access_token过期? | 企业微信的token有效期7200秒,FastGPT会自动刷新 |
| 需要公网服务器吗? | 是的,回调URL需要公网可访问,可用Nginx反向代理 |
学习建议
- 先确保FastGPT知识库本身运行正常再接入企业微信
- 如果没有公网IP,可以使用内网穿透工具(如cpolar)测试
- 企业微信有消息频率限制,大量使用时注意配额
- 建议先看完前面的FastGPT基础教程再看本集