1. 方案概览
在企业微信中集成一个 AI 助手,只需几步:
|
|
2. 创建大模型问答应用
首先我们可以通过创建一个百炼应用,来获取大模型的推理 API 服务,用于实现 AI 助手。
百炼提供的 新用户免费额度可以完全覆盖本教程所需资源消耗。额度消耗完后按 token 计费,相比自行部署大模型可以显著降低初期投入成本。
2.1 创建应用
- 进入百炼控制台的我的应用,创建应用。
- 在应用设置页面,模型选择通义千问-Plus,其他参数保持默认。
您也可以选择输入一些 Prompt,比如设置一些人设以引导大模型更好的应对客户咨询。
你叫小助,可以帮助用户解答产品选购、使用等方面的问题。
3.在页面右侧可以提问验证模型效果。不过您会发现,目前它还无法准确回答你们公司的商品信息。点击右上角的发布,我们将在后面的步骤中去解决这一问题。
2.2 获取调用 API 所需的凭证
为了在后续通过 API 调用大模型应用的能力,我们需要获取一个百炼应用的API-KEY 和应用 ID:
- 返回我的应用页面,点击查看我的API-KEY,在弹出窗口中创建一个新API-KEY。
- 在应用列表中可以查看所有百炼应用 ID。
3. 创建企业微信应用
接下来您需要在您的组织中创建应用,作为 AI 助手回答用户问题。
3.1 创建应用
- 访问企业微信开发者中心,扫码登录,点击立即创建。根据指引选择以企业身份创建和企业内部应用
- 在顶部导航栏中,选择应用管理,在应用页面下半部分点击创建应用
- 在创建应用页面,填写应用名称和应用介绍,上传应用 logo,选择可见范围,完成后点击创建应用。
3.2 获取企业 ID、应用 AgentId 和 Secret
- 在应用详情页面,复制 AgentID,并查看 Secret,用于下一步创建连接流。
- 点击接收消息卡片中的设置API接收,复制随机生成 Token 和 EncodingAESKey,用于下一步创建连接流。
- 在顶部导航栏中,选择我的企业,在企业信息页面,复制企业 ID,用于下一步创建连接流。
4. 创建企业微信连接流
AppFlow 可以让您在不写代码的情况下,通过界面配置就可以将百炼 RAG 应用和企业微信连接起来。您可以通过预置的 AppFlow 模板创建一个企业微信连接流。
- 使用AppFlow模板创建连接流,点击立即使用进入创建流程。
- 在连接流的账户授权配置向导页,点击前往授权。在创建凭证对话框中,填入之前获取的企业微信的企业ID,应用的 AgentId 和 Secret,接收消息的 Token 和 EncodingAESKey,并设置一个自定义凭证名称。同时复制保存 IP 白名单,用于下一步配置 IP 白名
- 在连接流的账户授权配置向导页,点击前往授权。在创建凭证对话框中,填入之前获取的 API-KEY,并设置一个自定义凭证名称。
- 在执行动作配置向导页,填写应用Id,完成后点击下一步。
- 在基本信息配置向导页,填写连接流名称和连接流描述(建议保持默认),完成后点击下一步。
- 界面提示流程配置成功,复制 WebhookUrl,点击发布。
5. 配置企业微信应用
有了 Webhook 地址后,接下来您可以在企业微信应用中配置接收消息来回答用户问题了。
5.1 配置企业微信应用
- 访问企业微信应用列表。找到刚刚创建的应用,点击应用名称进入详情页面。
- 在应用详情页面,找到接收消息卡片,点击设置API接收。
- 在API接收消息页面,您可以参考下图完成配置。URL填入上一步的 WebhookUrl,Token 和 EncodingAESKey 填入上一步配置的值(如果之前未保存,可以在AppFlow连接凭证页面,在公共连接器>企业微信中,找到刚刚配置的凭证,从凭证中获取)。然后点击保存。
5.2 配置 IP 白名单
- 在应用详情页面,在页面下方开发者接口找到企业可信IP卡片,点击配置。
- 在企业可信IP对话框,粘贴复制的 IP 地址,然后点击确定。
5.3 测试应用
你可以在企业微信中搜索应用并发送消息,查看效果。
- 在企业微信顶部搜索框搜索应用名称,点击应用进入聊天。
- 与应用对话,进行交流互动。
6. 为大模型问答应用增加私有知识
6.1 配置知识库
接下来,我们可以尝试让大模型在面对客户问题时参考这份文档,以产出一个更准确的回答和建议。
假设您在一家售卖智能手机的公司工作。您的企业微信用户会有很多涉及智能手机相关的问题,如支持双卡双待、屏幕、电池容量、内存等信息。不同机型的详细配置清单参考:百炼系列手机产品介绍.docx。
1.上传文件:在百炼控制台的数据管理中点击导入数据,根据引导上传我们虚构的百炼系列手机产品介绍。
2.建立索引:进入知识索引,根据引导创建一个新的知识库,并选择刚才上传的文件,其他参数保持默认即可。知识库将为上一步骤中准备的文档建立索引,以便后续大模型回答时检索参考。
选择向量存储类型时,如果您希望集中存储、灵活管理多个应用的向量数据,可选择 ADB-PG。
3.引用知识:完成知识库的创建后,可以返回我的应用进入到刚才创建的应用设置界面,打开知识检索增强开关、选择知识库,测试验证符合预期后点击发布。Prompt 中会被自动添加一段信息,以便大模型在后续回答时参考检索出来的信息。
6.2 检验效果
有了参考知识,AI 应用就能准确回答您关于百炼手机的问题了。
7. 总结
通过前面的学习,您已经能搭建一个大模型 RAG 应用,并且将其以应用的形式添加到企业微信中来应对客户咨询,过程仅需 0 元(免费试用额度内)10分钟。
7.1 应用评测
建议您在正式上线 AI 应用前,组织业务人员一起参与应用评测,确保大模型应用的回答效果符合预期。如果不符合预期,可以通过优化提示词、完善补充私有知识、调整文档切分策略等方法来改进回答效果。
7.2 域名主体校验未通过怎么办?
当您在企业微信后台配置 API 接收消息,报错提示“域名主体校验未通过,需配置备案主体与当前企业主体相同或有关联关系的域名”时。您可以提交工单,联系我们客服人员,提供连接流 ID、自定义域名,帮您配置并使用您企业的自有域名。