本文将介绍如何通过生态对接功能将企业知识问答机器人引入到企业微信应用中。
开通生态对接权限
点击授权链接后点击同意授权,将会为您自动创建所需的服务角色并为角色授权。您可以使用此角色来调用OpenSearch-LLM智能问答版实例的API,实现与钉钉、飞书、企业微信等平台的对接。
上海区域授权链接可点击授权链接。
新加坡区域授权链接可点击授权链接。
创建企业微信应用
-
使用移动端企业微信扫码登录企业微信开发者中心,单击企业内部应用。
-
单击应用管理->应用->创建应用。
-
按要求上传应用logo,填写应用名称、应用介绍(选填)、选择可见范围,单击创建应用。
其中,应用名称填写
OpenSearchRobot,应用介绍填写OpenSearchLLM智能问答版生态接入测试。
创建企业微信应用生态对接
-
(可选)创建参数配置:登录OpenSearch-LLM智能问答版控制台,单击要操作实例的管理按钮进入实例管理界面,选择生态对接->参数配置,单击创建按钮,按要求填写参数,具体请参考:问答测试。
-
创建接入点:点击生态对接->接入点,单击创建按钮,生态平台选择企业微信应用。
选择后表单显示以下配置字段:接入点名称、参数配置、URL、TrustedIp、Token、EncodingAESKey、企业ID和Secret。
-
配置接入点:按要求填入接入点名称、企业ID、Secret,然后单击确认按钮。
说明接入点名称:长度为1-30个字符,以字母开头,可以包含大小写字母,数字和下划线,且不能和其它名称重复;
企业ID:企业微信应用下我的企业->企业信息->企业ID;
Secret:在应用中找到刚刚创建的应用,单击进入应用可以查看企业微信应用的Secret。单击查看后会发送至移动端APP。
配置企业微信应用
-
单击应用下接收消息内的设置API接收。
在应用详情页的接收消息区域中,可见设置API接收入口,单击即可进入消息接收配置页面。
-
配置URL、Token、EncodingAESKey信息,核对无误后单击保存。
在选择需要接收的消息事件类型区域,勾选用户发送的普通消息、自定义菜单操作、审批状态通知事件、外部联系人变更回调、微信客服消息和事件、支付和退款通知、上下游变更回调、直播状态变更回调、会议室预定状态变更回调,不勾选上报地理位置和上报进入应用事件。
说明-
URL:和OpenSearch-LLM智能问答版生态接入点的URL保持一致;
-
Token:和OpenSearch-LLM智能问答版生态接入点的Token保持一致;
-
EncodingAESKey:和OpenSearch-LLM智能问答版生态接入点的EncodingAESKey保持一致;
-
注意保证输入信息的准确性。
-
这三个字段位于修改接入点对话框中,可在此查看并复制对应的值用于企业微信应用配置。
如果填写完URL提示域名主体校验未通过,需在企业域名处添加二级域名:
在企业微信管理后台,单击顶部导航栏我的企业,选择左侧菜单企业信息,在主内容区找到企业域名一行并单击添加。
添加完成后绑定域名,将绑定的域名解析映射到IP:47.116.125.250上,最后把添加的域名替换原本的URL的IP地址即可。
重要域名解析后需映射到IP:47.116.125.250上,解析成功后在cmd控制台ping域名应提示的IP为 47.116.125.250。详情如下所示:
→ turing-scholar git:(master) x ping wechat.lakewhale.top PING wechat.lakewhale.top (47.116.125.250): 56 data bytes 64 bytes from 47.116.125.250: icmp_seq=0 ttl=91 time=32.633 ms 64 bytes from 47.116.125.250: icmp_seq=0 ttl=91 time=36.534 ms (DUP!) 64 bytes from 47.116.125.250: icmp_seq=1 ttl=91 time=32.436 ms 64 bytes from 47.116.125.250: icmp_seq=1 ttl=91 time=37.479 ms (DUP!) 64 bytes from 47.116.125.250: icmp_seq=2 ttl=91 time=49.770 ms 64 bytes from 47.116.125.250: icmp_seq=2 ttl=91 time=53.135 ms (DUP!) 64 bytes from 47.116.125.250: icmp_seq=3 ttl=91 time=32.415 ms 64 bytes from 47.116.125.250: icmp_seq=4 ttl=91 time=32.744 ms 64 bytes from 47.116.125.250: icmp_seq=4 ttl=91 time=35.564 ms (DUP!) 64 bytes from 47.116.125.250: icmp_seq=5 ttl=91 time=33.229 ms 64 bytes from 47.116.125.250: icmp_seq=5 ttl=91 time=34.887 ms (DUP!) 64 bytes from 47.116.125.250: icmp_seq=6 ttl=91 time=75.814 ms 64 bytes from 47.116.125.250: icmp_seq=6 ttl=91 time=79.044 ms (DUP!) 64 bytes from 47.116.125.250: icmp_seq=7 ttl=91 time=119.272 ms 64 bytes from 47.116.125.250: icmp_seq=7 ttl=91 time=123.021 ms (DUP!) 64 bytes from 47.116.125.250: icmp_seq=8 ttl=91 time=164.750 ms 64 bytes from 47.116.125.250: icmp_seq=8 ttl=91 time=172.727 ms (DUP!) -
-
保存完成后会提示如下配置信息。
配置信息包括接收消息服务器配置(URL、Token、EncodingAESKey 三个字段)和接收的消息事件类型(用户发送的普通消息、自定义菜单操作、审批状态通知事件、外部联系人变更回调、微信客服消息和事件、支付和退款通知、上下游变更回调、直播状态变更回调、会议室预定状态变更回调)。可单击编辑或删除对服务器配置进行修改。
-
单击应用下开发者接口内的企业可信IP,点击配置按钮配置IP。
-
填写OpenSearch-LLM智能问答版生态接入点的TrustedIp,核对输入信息无误后点击确定。
说明-
企业可信IP与OpenSearch-LLM智能问答版生态接入点的TrustedIp一致。
-
注意核对输入信息的准确性
在生态接入点配置页面,填写接入点名称,选择生态平台为企业微信应用,并配置URL、Token、EncodingAESKey、企业ID、Secret和TrustedIp等参数。
-
企业微信中使用企业微信应用
-
在左上角搜索框输入企业微信应用的应用名称。
在搜索建议下拉列表的应用分组中,单击目标企业微信应用名称即可打开该应用。
-
打开单聊框输入需要提问的问题,即可对OpenSearch-LLM智能问答版中上传的知识进行问答。