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集成,单击添加机器人

  4. 添加IM机器人弹窗中,机器人模式选择标准机器人,机器人类型选择企业微信机器人,并填写以下信息:

    参数

    说明

    机器人名称

    输入机器人的展示名称。

    机器人模式

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

    选择 Endpoint

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

    选择协议规范

    选择消息处理的协议规范。如尚未创建,单击右侧 + 按钮新建。

    企业微信应用 ID

    步骤一中获取的企业微信机器人应用 ID(AgentId)。

    企业微信应用 Secret

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

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

    说明

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

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

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

群聊中使用

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

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

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

私聊中使用

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