Skip to main content

​
概述

企业微信集成把一个工作空间里的智能体接到您自己的企微智能机器人上。接好之后，团队成员不必打开控制台：
  • 私聊机器人，或在企微群里 @ 它，立刻拿到基于团队记忆库的回答
  • 回答流式呈现，无需等待完整生成
  • 发一份文档或一张截图给它，就能接着追问里面的内容
  • 每次问答都会沉淀为记忆，同事再问时不必有人重复解释
机器人的回答基于您指定的项目记忆生成，而非通用模型的一般性回答。

​
开始之前

MemoryLake 侧

  • 团队的 owner 或 admin 角色（member 既看不到也改不了集成）
  • 一个工作空间，里面至少有一个项目
  • 至少一个已关联到该工作空间的智能体（在工作空间的「智能体」标签页关联）

企业微信侧

  • 企业的超级管理员，或被加入「可创建智能机器人的成员」范围的普通成员
  • 一个用于测试的企微群（可选，但建议）
企微侧配置约 3 分钟，没有审核环节。
如果工作空间页里没有「集成」标签页，说明该部署没有启用 IM 渠道功能，或者您的角色是 member。请联系团队管理员确认。

​
第一部分：在企业微信创建智能机器人

这一部分在企业微信侧完成，目标是获取两个值：BotID 与 Secret。
1

找到创建入口

智能机器人提供两个创建入口，任选其一：
  • 管理员：登录 企业微信管理后台 → 安全与管理 → 管理工具 → 智能机器人 → 创建 → 创建机器人
  • 普通成员（需事先由管理员加入「可创建智能机器人的成员」范围）：企业微信电脑端或手机端 → 工作台 → 智能机器人 → 创建智能机器人
带截图的详细说明请参考官方帮助文档：如何使用企业微信智能机器人。
2

以「API 模式」创建机器人

创建方式有三种：AI 自动生成、手动创建、API 模式创建。请选择 API 模式创建——仅该方式支持对接企业自有模型与数据，即本集成所需的形态；前两种方式创建的机器人基于企微内置模型，无法接入本平台。创建过程中有两项配置需要注意：
  • 名称与头像将展示给企业成员，建议使用团队易于辨认的名称，例如「记忆库助手」
  • 可见范围决定哪些成员可以与机器人私聊，请按实际需要设置
3

复制 BotID 与 Secret

进入机器人详情的 API 模式设置，页面上会给出：请复制保存这两个值，下一部分将填入控制台。
请勿在非必要时重置 Secret。 重置会使已配置的集成失效。如确需重置，请立即在控制台将集成更换为新的 Secret，不要以机器人当时是否仍在应答来判断影响。

​
第二部分：在控制台创建集成

1

打开工作空间的「集成」标签页

在 MemoryLake 控制台 里进入 MemoryLake → 工作空间，打开目标工作空间，切到 集成 标签页，点 开始接入。在「选择要接入的平台」里选 企业微信。
2

第一步：填写机器人信息

填写完成后点击 下一步：智能体与记忆。
一个智能机器人只能接入一处。如果该 BotID 已被其他集成占用，输入框下方会即时提示，并提供「去编辑那一条」的入口。
3

第二步：选智能体与记忆范围

读写项目是一次授权决策。 所有能用这个机器人的人，都在往这个项目里写记忆，也都能读到里面已有的内容。选一个本来就打算团队共享的项目，不要选放着敏感资料的那个。
4

创建并连接

点击 创建并连接。集成创建后默认为启用状态，系统会立即开始连接。卡片上的状态会从「连接中」变成「已连接」——通常几秒。
集成卡片上的状态徽标显示已连接。
如果状态变成「异常」并提示凭证问题，回到编辑弹窗核对 BotID 与 Secret。

​
第三部分：验证并开始使用

​
私聊

企业成员在企业微信中打开该机器人的会话即可开始对话，直接发送问题、无需 @。首次打开会话时机器人会发送一条欢迎语，介绍可用能力。

​
群聊

将机器人添加进群，之后 @ 机器人 + 问题即可提问。机器人会引用您的提问进行回复——即使群内消息较多也不会错过答案。 机器人在某个群里第一次被 @ 时，会额外附一句能力说明，之后不再重复。
群里只有 @ 了机器人的消息才会发送给机器人。这是企微平台的规则，也意味着机器人看不到群里的其他聊天内容。

​
发送文档与截图

  • 私聊：直接把文件或图片发给机器人，然后追问内容
  • 群里发图：把图片粘贴进输入框，和 @ 放在同一条消息里发出
  • 群里发文件：先把文件发到群里，再引用那条消息并 @ 机器人
直接向群里发送文件，机器人是收不到的——企微会把「@ + 附件」拆分为两条消息，文件那一条不带 @，不会发送给机器人。通过引用，机器人才能获取到该文件。
单个文件上限 20 MB，支持 PDF / Word / Excel / PPT / 图片 / 文本。

​
引用一条消息重新提问

引用群里任意一条文字消息并 @ 机器人，它会围绕被引用的内容回答；仅引用并 @、不附加文字时，视为「请回答被引用的这条内容」。

​
会话与上下文

  • 私聊是连续会话：不会因为隔了多久而断，隔夜再问也接着上下文。想从头开始，发 /new
  • 群聊按话题：同一个人连续提问会接着上下文；8 分钟没说话之后再提问算新话题（刚发过文件时这个窗口放宽到 30 分钟，方便围绕同一份文件追问）
  • 群里每个人的上下文相互独立，多人同时提问互不干扰
  • 私聊里发过的文件不会过期，一直跟着这个会话；同时最多带最近 5 个，发第 6 个时最早那个就不再参与了。/new 会一并清掉

​
暂不支持的消息类型

发送视频、表情包、小程序卡片等暂不支持的内容时，机器人会给出明确提示，不会静默无响应。

​
管理已有集成

BotID 创建后不可修改——它是这条集成的身份标识。如需更换为另一个机器人，请删除后重新创建。

​
常见问题

两个可能：
  1. 该部署没有启用 IM 渠道功能。 这个开关默认关闭，需要平台管理员开启。
  2. 您的角色是 member。 配置集成要写第三方凭证，属于敏感写操作，只有团队的 owner 与 admin 有权限。
企微侧拒绝了我们的连接，几乎总是这三种情况：
  • BotID 或 Secret 复制时多了空格、少了字符
  • Secret 在企微侧被重置过，控制台里还是旧值
  • 填的是另一个机器人的凭证
处理方式：编辑这条集成，核对 BotID；要换密钥，点 Secret 旁的「更换」填入新值。改完保存会立刻重连。如果提示中带有错误码并注明「可能是平台频率限制」，通常等待几分钟即可自动恢复，无需改动凭证。
旧凭证失效存在一定延迟，机器人可能在重置后的一段时间内仍正常应答，随后转为异常。请勿据此判断「重置没有影响」——重置后请立即在控制台更换 Secret，不要等到状态报错。
按顺序检查：
  • 群聊里真的 @ 了机器人吗：群里只有 @ 到机器人的消息才会发送给机器人
  • 机器人的可见范围：企微侧如果限制了使用范围，要用的人得在范围里
  • 集成开关是否被停用（停用时机器人会回「机器人当前不可用，请联系管理员。」）
  • 是否将同一个机器人接入了两个环境：表现为两边都间歇性失联。删除其中一条即可恢复
欢迎语在成员当天首次打开该机器人会话时发送，且每位成员仅会收到一次。如果您当天已经打开过会话（即使没有发言），当天不会再次收到。未收到欢迎语不影响任何功能，直接发送消息即可开始对话。
企微会把「@ + 附件」拆分为两条消息，文件那一条不带 @，不会发送给机器人。正确操作：先把文件发到群里，再「引用」那条消息并 @ 机器人。群里发送图片不受此限制——粘贴进输入框、与 @ 在同一条消息中发出即可。私聊中文件与图片均可直接发送。
两种情况：
  • 超过 20 MB：机器人会明确回复文件超出大小限制
  • 超过 100 MB：企微平台不会把该消息送达机器人，因此不会有任何提示——这是平台限制，并非故障
大文件建议拆分或压缩后再发送。
机器人异常期间收到的消息不会补发。如果发送消息后机器人没有响应，且控制台显示当时状态异常，请在恢复后重新发送一次。
不能。一个 BotID 只能被一条集成使用，重复接入会导致机器人无法稳定工作。如果提示这个 BotID 已被占用：
  • 占用者在同一个工作空间：直接改那一条（提示里有「去编辑那一条」的入口）
  • 占用者在同团队的其他工作空间：先删掉原来那条，再在这里接入
  • 占用者在其他团队：出于安全考虑不会披露占用方，请在企微管理后台另行创建一个机器人
需要一个机器人服务多个工作空间的记忆，正确做法是把这些项目作为只读项目加进同一条集成。
访问范围由企微侧统一管理，本平台不提供额外的白名单配置。
  • 私聊：由机器人在企微侧的可见 / 使用范围决定
  • 群聊：由群成员决定——机器人在群里，群成员就能 @ 它
分两层看：
  • 对话上下文是按人隔离的。群里每个人各有独立上下文，A 的提问不会出现在 B 的对话里。
  • 项目记忆是共享的。 沉淀进读写项目的记忆，所有能用这个机器人的人都能检索到——这正是这个功能的价值，也是为什么创建时要把读写项目当成一次授权决策来选。
个人相关的记忆会归到各人的记忆身份下，不进共享池。
两句话对应两件不同的事：
  • 「当前账户额度已用尽，请联系管理员升级套餐后再试。」 团队的套餐额度耗尽了。不充值不会自动恢复，请联系管理员充值或升级套餐。
  • 「当前请求较多，正在排队，请稍后再发一次。」 是我们这边一时繁忙，不是您发得太快，稍后重发即可。
会一并清除这条集成的会话记录、企微用户与记忆身份的映射关系，以及会话里挂着的附件引用，且不可恢复。已经沉淀进项目的记忆和已入库的文件不会被删——它们属于项目，不属于集成。只是临时停用的话，用卡片上的开关就够了，不要删。