> ## Documentation Index
> Fetch the complete documentation index at: https://docs.memorylake.cn/llms.txt
> Use this file to discover all available pages before exploring further.
# 企业微信集成
> 把工作空间的记忆接进企业微信：私聊机器人，或把它拉进群 @ 它提问
## 概述
企业微信集成把一个**工作空间**里的智能体接到您自己的企微智能机器人上。接好之后，团队成员不必打开控制台：
* 私聊机器人，或在企微群里 @ 它，立刻拿到基于团队记忆库的回答
* 回答**流式呈现**，无需等待完整生成
* 发一份文档或一张截图给它，就能接着追问里面的内容
* 每次问答都会沉淀为记忆，同事再问时不必有人重复解释
机器人的回答基于您指定的项目记忆生成，而非通用模型的一般性回答。
## 开始之前
* 团队的 **owner** 或 **admin** 角色（member 既看不到也改不了集成）
* 一个工作空间，里面至少有一个项目
* 至少一个**已关联到该工作空间**的智能体（在工作空间的「智能体」标签页关联）
* 企业的**超级管理员**，或被加入「可创建智能机器人的成员」范围的普通成员
* 一个用于测试的企微群（可选，但建议）
企微侧配置约 3 分钟，没有审核环节。
如果工作空间页里**没有**「集成」标签页，说明该部署没有启用 IM 渠道功能，或者您的角色是 member。请联系团队管理员确认。
## 第一部分：在企业微信创建智能机器人
这一部分在企业微信侧完成，目标是获取两个值：**BotID** 与 **Secret**。
智能机器人提供两个创建入口，任选其一：
* **管理员**：登录 [企业微信管理后台](https://work.weixin.qq.com/wework_admin/) → **安全与管理** → **管理工具** → **智能机器人** → **创建** → **创建机器人**
* **普通成员**（需事先由管理员加入「可创建智能机器人的成员」范围）：企业微信**电脑端或手机端** → **工作台** → **智能机器人** → **创建智能机器人**
带截图的详细说明请参考官方帮助文档：[如何使用企业微信智能机器人](https://open.work.weixin.qq.com/help2/pc/21663)。
创建方式有三种：AI 自动生成、手动创建、**API 模式创建**。请选择 **API 模式创建**——仅该方式支持对接企业自有模型与数据，即本集成所需的形态；前两种方式创建的机器人基于企微内置模型，无法接入本平台。
创建过程中有两项配置需要注意：
* **名称与头像**将展示给企业成员，建议使用团队易于辨认的名称，例如「记忆库助手」
* **可见范围**决定哪些成员可以与机器人私聊，请按实际需要设置
进入机器人详情的 **API 模式**设置，页面上会给出：
| 值 | 格式 |
| ---------- | -------------- |
| **BotID** | `aib` 开头的一串字符 |
| **Secret** | API 模式专用的长连接密钥 |
请复制保存这两个值，下一部分将填入控制台。
**请勿在非必要时重置 Secret。** 重置会使已配置的集成失效。如确需重置，请**立即**在控制台将集成更换为新的 Secret，不要以机器人当时是否仍在应答来判断影响。
## 第二部分：在控制台创建集成
在 [MemoryLake 控制台](https://app.memorylake.cn) 里进入 **MemoryLake → 工作空间**，打开目标工作空间，切到 **集成** 标签页，点 **开始接入**。
在「选择要接入的平台」里选 **企业微信**。
| 字段 | 说明 |
| ---------- | ---------------------- |
| **BotID** | 智能机器人的 BotID（`aib` 开头） |
| **Secret** | API 模式里的长连接 Secret |
填写完成后点击 **下一步：智能体与记忆**。
一个智能机器人只能接入一处。如果该 BotID 已被其他集成占用，输入框下方会即时提示，并提供「去编辑那一条」的入口。
| 字段 | 说明 |
| --------------- | ------------------------------- |
| **名称** | 只用于控制台里辨认这条集成，已预填好，可改 |
| **智能体** | 负责回答企微侧消息。只能选**已关联到当前工作空间**的智能体 |
| **读写项目**（必选） | 机器人检索并写入记忆的项目 |
| **额外的只读项目**（可选） | 机器人可以检索、但绝不写入的项目 |
**读写项目是一次授权决策。** 所有能用这个机器人的人，都在往这个项目里写记忆，也都能读到里面已有的内容。选一个本来就打算团队共享的项目，不要选放着敏感资料的那个。
点击 **创建并连接**。集成创建后**默认为启用状态**，系统会立即开始连接。
卡片上的状态会从「连接中」变成「已连接」——通常几秒。
集成卡片上的状态徽标显示**已连接**。
如果状态变成「异常」并提示凭证问题，回到编辑弹窗核对 BotID 与 Secret。
## 第三部分：验证并开始使用
### 私聊
企业成员在企业微信中打开该机器人的会话即可开始对话，直接发送问题、无需 @。**首次打开会话时机器人会发送一条欢迎语**，介绍可用能力。
### 群聊
将机器人**添加进群**，之后 **@ 机器人 + 问题**即可提问。机器人会**引用**您的提问进行回复——即使群内消息较多也不会错过答案。
机器人在某个群里第一次被 @ 时，会额外附一句能力说明，之后不再重复。
群里**只有 @ 了机器人的消息**才会发送给机器人。这是企微平台的规则，也意味着机器人看不到群里的其他聊天内容。
### 发送文档与截图
* **私聊**：直接把文件或图片发给机器人，然后追问内容
* **群里发图**：把图片粘贴进输入框，和 @ 放在**同一条消息**里发出
* **群里发文件**：先把文件发到群里，再**引用那条消息**并 @ 机器人
直接向群里发送文件，机器人是**收不到的**——企微会把「@ + 附件」拆分为两条消息，文件那一条不带 @，不会发送给机器人。通过引用，机器人才能获取到该文件。
单个文件上限 **20 MB**，支持 PDF / Word / Excel / PPT / 图片 / 文本。
### 引用一条消息重新提问
引用群里任意一条**文字**消息并 @ 机器人，它会围绕被引用的内容回答；仅引用并 @、不附加文字时，视为「请回答被引用的这条内容」。
### 会话与上下文
* **私聊是连续会话**：不会因为隔了多久而断，隔夜再问也接着上下文。想从头开始，发 `/new`
* **群聊按话题**：同一个人连续提问会接着上下文；**8 分钟**没说话之后再提问算新话题（刚发过文件时这个窗口放宽到 30 分钟，方便围绕同一份文件追问）
* 群里**每个人的上下文相互独立**，多人同时提问互不干扰
* 私聊里发过的文件**不会过期**，一直跟着这个会话；同时最多带最近 **5 个**，发第 6 个时最早那个就不再参与了。`/new` 会一并清掉
### 暂不支持的消息类型
发送视频、表情包、小程序卡片等暂不支持的内容时，机器人会给出明确提示，不会静默无响应。
## 管理已有集成
| 操作 | 位置与说明 |
| ------------- | ---------------------------------------------- |
| **停用 / 启用** | 集成卡片上的开关，**立即生效** |
| **轮换 Secret** | 编辑 → Secret 旁的「更换」按钮 → 填入新值并保存。不点「更换」则不会改动现有密钥 |
| **更换智能体** | 编辑 → 智能体。**会重置该集成下所有进行中的会话**，成员正在进行的对话上下文将从头开始 |
| **调整记忆范围** | 编辑 → 读写项目 / 只读项目。保存后立即生效 |
| **删除集成** | 卡片菜单 → 删除。会一并清除会话记录、身份映射和会话附件，**不可恢复** |
**BotID 创建后不可修改**——它是这条集成的身份标识。如需更换为另一个机器人，请删除后重新创建。
## 常见问题
两个可能：
1. **该部署没有启用 IM 渠道功能。** 这个开关默认关闭，需要平台管理员开启。
2. **您的角色是 member。** 配置集成要写第三方凭证，属于敏感写操作，只有团队的 owner 与 admin 有权限。
企微侧拒绝了我们的连接，几乎总是这三种情况：
* BotID 或 Secret 复制时多了空格、少了字符
* Secret 在企微侧被**重置**过，控制台里还是旧值
* 填的是另一个机器人的凭证
处理方式：编辑这条集成，核对 BotID；要换密钥，点 Secret 旁的「更换」填入新值。改完保存会立刻重连。
如果提示中带有错误码并注明「可能是平台频率限制」，通常等待几分钟即可自动恢复，无需改动凭证。
旧凭证失效存在一定延迟，机器人可能在重置后的一段时间内仍正常应答，随后转为异常。
请勿据此判断「重置没有影响」——重置后请立即在控制台更换 Secret，不要等到状态报错。
按顺序检查：
* **群聊里真的 @ 了机器人吗**：群里只有 @ 到机器人的消息才会发送给机器人
* **机器人的可见范围**：企微侧如果限制了使用范围，要用的人得在范围里
* **集成开关是否被停用**（停用时机器人会回「机器人当前不可用，请联系管理员。」）
* **是否将同一个机器人接入了两个环境**：表现为两边都间歇性失联。删除其中一条即可恢复
欢迎语在成员**当天首次**打开该机器人会话时发送，且每位成员**仅会收到一次**。如果您当天已经打开过会话（即使没有发言），当天不会再次收到。
未收到欢迎语不影响任何功能，直接发送消息即可开始对话。
企微会把「@ + 附件」拆分为两条消息，文件那一条不带 @，不会发送给机器人。
**正确操作：先把文件发到群里，再「引用」那条消息并 @ 机器人。**
群里发送**图片**不受此限制——粘贴进输入框、与 @ 在同一条消息中发出即可。私聊中文件与图片均可直接发送。
两种情况：
* **超过 20 MB**：机器人会明确回复文件超出大小限制
* **超过 100 MB**：企微平台**不会把该消息送达机器人**，因此不会有任何提示——这是平台限制，并非故障
大文件建议拆分或压缩后再发送。
机器人异常期间收到的消息**不会补发**。如果发送消息后机器人没有响应，且控制台显示当时状态异常，请在恢复后重新发送一次。
不能。一个 BotID 只能被一条集成使用，重复接入会导致机器人无法稳定工作。
如果提示这个 BotID 已被占用：
* 占用者在**同一个工作空间**：直接改那一条（提示里有「去编辑那一条」的入口）
* 占用者在**同团队的其他工作空间**：先删掉原来那条，再在这里接入
* 占用者在**其他团队**：出于安全考虑不会披露占用方，请在企微管理后台另行创建一个机器人
需要一个机器人服务多个工作空间的记忆，正确做法是把这些项目作为**只读项目**加进同一条集成。
访问范围由**企微侧**统一管理，本平台不提供额外的白名单配置。
* **私聊**：由机器人在企微侧的可见 / 使用范围决定
* **群聊**：由**群成员**决定——机器人在群里，群成员就能 @ 它
分两层看：
* **对话上下文**是按人隔离的。群里每个人各有独立上下文，A 的提问不会出现在 B 的对话里。
* **项目记忆是共享的。** 沉淀进读写项目的记忆，所有能用这个机器人的人都能检索到——这正是这个功能的价值，也是为什么创建时要把读写项目当成一次授权决策来选。
个人相关的记忆会归到各人的记忆身份下，不进共享池。
两句话对应两件不同的事：
* **「当前账户额度已用尽，请联系管理员升级套餐后再试。」** 团队的套餐额度耗尽了。**不充值不会自动恢复**，请联系管理员充值或升级套餐。
* **「当前请求较多，正在排队，请稍后再发一次。」** 是我们这边一时繁忙，不是您发得太快，稍后重发即可。
会一并清除这条集成的会话记录、企微用户与记忆身份的映射关系，以及会话里挂着的附件引用，且不可恢复。
**已经沉淀进项目的记忆和已入库的文件不会被删**——它们属于项目，不属于集成。
只是临时停用的话，用卡片上的开关就够了，不要删。