本文介绍如何将函数计算 AgentRun(函数计算 Agent 运行时)中的 Agent 接入企业微信,实现在企业微信群聊或私聊中通过 @机器人 与 Agent 对话交互。
前提条件
-
已开通函数计算服务并创建 AgentRun Agent。具体操作,可参见快速创建Agent(无代码)。
-
拥有企业微信管理员权限,可登录企业微信管理后台。
步骤一:创建企业微信机器人
1. 创建机器人并获取凭证
-
登录企业微信管理后台。
-
在左侧导航栏选择安全与管理 > 管理工具,找到智能机器人,单击创建机器人。
-
在弹窗中单击手动创建。
-
滑动至创建机器人页面底部,单击API模式创建按钮切换创建模式。
-
按需配置机器人可见范围。在连接方式中选择使用长连接方式,单击获取 Secret。
Bot ID 和 Secret(机器人密钥)用于后续在 AgentRun 中配置企业微信集成,请妥善保存。
-
单击保存,输入机器人名称和简介,单击确定,完成机器人创建。
步骤二:在 AgentRun 配置企业微信集成
-
登录 AgentRun 控制台。
-
单击目标 Agent 名称,进入 Agent 详情页。
-
单击集成与发布页签,单击 IM集成,单击添加IM机器人。
-
在添加IM机器人面板中,机器人模式选择标准机器人,选择平台选择企业微信机器人,并填写以下信息:
参数
说明
机器人名称
输入机器人的展示名称,最多 128 个字符。
描述
(可选)输入机器人的描述信息,最多 256 个字符。
机器人模式
选择标准机器人,使用 Agent Endpoint 进行消息处理。
选择 Endpoint
选择已发布的 Agent Endpoint,机器人将通过该 Endpoint 处理消息。
选择协议规范
选择消息处理的协议规范。如尚未创建,可单击添加协议新建,或单击刷新协议列表更新。
企业微信应用 ID
在步骤一中获取的企业微信机器人应用 ID(AgentId)。可在企业微信开发者中心获取。
企业微信应用 Secret
在步骤一中获取的企业微信机器人 Secret(机器人密钥)。
创建后立即启用
默认勾选。创建成功后机器人立即运行并响应 IM 消息;若取消勾选,创建后机器人为停用状态,可在列表中手动启用。
-
单击创建机器人,完成企业微信集成配置。
说明启用后,AgentRun 将与企业微信建立长连接,预留 1 个实例用于长连接通信。该实例会产生费用,请关注计费概述。
步骤三:在企业微信中使用 Agent
完成配置后,您可以在企业微信群聊或私聊中与 Agent 对话。
群聊中使用
-
在企业微信中创建群聊或打开已有群聊。
-
在群设置中添加您在步骤一中创建的机器人。
-
在群聊中 @机器人名称并输入问题,即可与 Agent 对话。
私聊中使用
通过企业微信搜索栏搜索机器人名称,打开机器人对话窗口,直接发送消息即可与 Agent 私聊对话。