一、整体概述
这篇档介绍了如何将基于智能体开发平台开发的 Agent 应用,发布至企业微信。
二、创建企微应用
1. 登录 企业微信平台,进入应用管理 > 应用,单击创建应用。
2. 填写应用名称等相关信息。
三、设置企微应用主页
1. 进入智能体开发平台 > 应用发布 > 调用信息 > 体验链接。
2. 进入企微应用详情 > 应用主页,单击设置后填入该链接即可。
3. 配置企微应用主页地址为智能体应用体验链接。
四、进入企微访问
1. 在企业微信工作台中,点击腾讯云智能体应用后可以开始对话。
注意:使用手机号登录即可。
2. 体验效果如下:
五、配置方式二
更适合企业定制化开发,但需要一定的开发成本。
六、准备工作
由于企业微信对于企业对接有域名限制,所以需要你准备一个已经备案好的域名作为代理服务器,将企微请求转发到智能体平台,否则无法完成消息收发功能,如下为 Nginx 代理转发配置示例(需提前安装 Nginx,建议版本1.18+,配置步骤请参考 Nginx 产品文档):
server { listen 443; # 为安全起见,要求你的域名为https协议 server_name www.example.com; # 请将server_name替换为你已备案的完整域名 location ~ ^/cgi-bin/ { # 请求企微代理 proxy_pass https://qyapi.weixin.qq.com; proxy_http_version 1.1; proxy_set_header Connection "close"; proxy_buffering off; proxy_read_timeout 600s; proxy_send_timeout 600s; } location ~ ^/online/channel/callback/ { proxy_pass https://chan.lke.cloud.tencent.com; # 代理到腾讯云智能体平台回调接口 proxy_http_version 1.1; proxy_set_header Connection "close"; proxy_buffering off; proxy_read_timeout 600s; proxy_send_timeout 600s; }}
七、创建企微应用
登录 企业微信平台,进入应用管理 > 创建应用(同配置方式一 操作指引)。
八、获取企微应用信息
创建完成后获取 AgentId 和 Secret。
九、获取企业ID
在右上角点击我的企业,可查看到企业 ID。
十、创建智能开发平台应用
创建企微应用成功后进入智能开发平台发布页面,单击企业微信应用进行创建。
十一、设置企微应用回调
1. 填写企业 ID 和企微应用信息后,单击创建。
注意:1. URL 需替换为你已经配置好的域名。
注意:2. 需要先点击创建按钮成功后,再将服务器地址(URL)、Token、EncodingAESKey 信息填入企微后台。
注意:说明:
注意:{你的域名} 中仅填写域名,不需要填写 IP 地址。
2. 进入企微后台应用详情,单击设置API接收。
3. 将开发平台企微应用渠道详情中的信息填入企微后台。
十二、设置企微应用可信 IP
进入应用详情页面找到 企业可信IP配置。
可信 IP 是你代理服务器的 IP(准备工作中请求 cgi / bin 接口机器的出口 IP),否则企微会拦截。
十三、发布应用
发布应用时勾选“企业微信应用”渠道,发布成功后可在“服务状态”中查看渠道的发布状态。
十四、进入企微应用聊天
发布成功后,进入企业微信并打开工作台,找到创建的应用,进入聊天窗口。
十五、如何确认我的 nginx 配置正常?
命令:curl https://{你的域名}/cgi-bin/gettoken
如下收到微信回包,则证明 nginx 配置正确