Agent集成企微

更新时间:
复制 MD 格式

本文介绍如何将函数计算 AgentRun(函数计算 Agent 运行时)中的 Agent 接入企业微信,实现在企业微信群聊或私聊中通过 @机器人 与 Agent 对话交互。

前提条件

步骤一:创建企业微信机器人

1. 创建机器人并获取凭证

  1. 登录企业微信管理后台

  2. 在左侧导航栏选择安全与管理 > 管理工具,找到智能机器人,单击创建机器人

  3. 在弹窗中单击手动创建

  4. 滑动至创建机器人页面底部,单击API模式创建按钮切换创建模式。

  5. 按需配置机器人可见范围。在连接方式中选择使用长连接方式,单击获取 Secret

    Bot ID 和 Secret(机器人密钥)用于后续在 AgentRun 中配置企业微信集成,请妥善保存。
  6. 单击保存,输入机器人名称和简介,单击确定,完成机器人创建。

2. 分享机器人

  1. 创建成功后,单击页面右上角更多按钮,按需选择获取机器人二维码获取机器人链接

  2. 将获取的机器人二维码或链接发送给可见范围内的企业微信用户。

  3. 目标用户在手机端使用企业微信扫描二维码或打开链接,即可在手机端与机器人聊天或将其添加至企业微信群聊。

步骤二:在 AgentRun 配置企业微信集成

  1. 登录 AgentRun 控制台

  2. 单击目标 Agent 名称,进入 Agent 详情页。

  3. 单击集成与发布页签,单击 IM集成,单击添加IM机器人

  4. 添加IM机器人面板中,机器人模式选择标准机器人选择平台选择企业微信机器人,并填写以下信息:

    参数

    说明

    机器人名称

    输入机器人的展示名称,最多 128 个字符。

    描述

    (可选)输入机器人的描述信息,最多 256 个字符。

    机器人模式

    选择标准机器人,使用 Agent Endpoint 进行消息处理。

    选择 Endpoint

    选择已发布的 Agent Endpoint,机器人将通过该 Endpoint 处理消息。

    选择协议规范

    选择消息处理的协议规范。如尚未创建,可单击添加协议新建,或单击刷新协议列表更新。

    企业微信应用 ID

    步骤一中获取的企业微信机器人应用 ID(AgentId)。可在企业微信开发者中心获取。

    企业微信应用 Secret

    步骤一中获取的企业微信机器人 Secret(机器人密钥)。

    创建后立即启用

    默认勾选。创建成功后机器人立即运行并响应 IM 消息;若取消勾选,创建后机器人为停用状态,可在列表中手动启用。

  5. 单击创建机器人,完成企业微信集成配置。

    说明

    启用后,AgentRun 将与企业微信建立长连接,预留 1 个实例用于长连接通信。该实例会产生费用,请关注计费概述

步骤三:在企业微信中使用 Agent

完成配置后,您可以在企业微信群聊或私聊中与 Agent 对话。

群聊中使用

  1. 在企业微信中创建群聊或打开已有群聊。

  2. 在群设置中添加您在步骤一中创建的机器人。

  3. 在群聊中 @机器人名称并输入问题,即可与 Agent 对话。

私聊中使用

通过企业微信搜索栏搜索机器人名称,打开机器人对话窗口,直接发送消息即可与 Agent 私聊对话。