# 智能消息管理
# 概念对齐
智能消息管理是管理各种消息渠道与AI技能关联的功能模块。当前主要管理企微智能机器人与七巧AI关联的玩法。
企微智能机器人是企微推出的AI聊天虚拟员工，用户可以与其单聊、群聊，它会基于配置，智能地回答用户问题。
企微智能机器人支持接收用户的文本、图片、图文混排、文件、语音、引用的消息。
# 服务设置
当前企微的智能机器人属于自建应用接口，非服务商三方接口。所以企业需要私有部署七巧AI的“智能消息服务”，然后获取服务请求地址。该服务很小，不会占用太多硬件资源，具体请联系七巧商务人员。
点击【服务设置】，打开弹窗，填写服务地址，确定即可。
# 添加规则&配置企微智能机器人
1、进入企微管理后台-安全与管理-管理工具-智能机器人。
https://work.weixin.qq.com/wework_admin/frame#/aiHelper/list?from=manage_tools (opens new window)
2、创建机器人。切换成API模式。
3、完善基本信息，随机获取token和AESKey。
4、不要关闭企微管理后台。新开标签页进入七巧管理后台-AI中心-智能消息管理。点击添加。
5、完善智能消息规则
1）基本信息
规则名称、id、备注
2）基础能力
将第三步获取的token、AESKey，复制粘贴。
机器人名称、机器人id仅用于记录区分企微智能机器人信息，可以不填。
3）拓展能力
支持智能机器人收到用户消息后，将消息发给指定的拓展能力。例如将收到的消息发给七巧AI技能。
目前，七巧支持三种拓展能力
应用回调函数： 触发七巧应用的回调任务，通过低代码脚本处理用户消息。
AI平台技能： 触发七巧AI平台技能，进而启动技能关联的智能体。
AI应用技能： 触发七巧AI应用技能，进而启动技能关联的智能体。
对于AI平台技能、AI应用技能，可以配置AI会话类型：
所有消息共用对话：群内所有用户与同一个智能机器人产生的对话，将纳入同一全局上下文。不同用户的交互内容，将共享上下文，会形成连续的对话逻辑。
发送用户独享对话： 单个用户与同一个智能机器人的交互，独立形成专属上下文。仅该用户可基于自身历史对话延续交互，其他用户无法获取、关联此上下文信息。无论是单聊还是群聊，用户自己都是独享上下文。
总是新对话： 每一次用户与同一个智能机器人的对话，均作为独立会话。不继承任何历史交互上下文，会话间逻辑完全隔离，每次交互都是 “从零开始” 。无论是单聊还是群聊，每次对话都是全新开始。
对于消息输出，目前七巧AI支持控制企微智能机器人的两种输出：
1、即时回复
企微智能机器人收到用户消息后，只要七巧AI在6分钟内回复，机器人可以直接呈现AI输出内容。
其中，有两种提取方法：
a：不提起，直接显示。七巧AI需要输出符合企微智能机器人的格式结构体，系统不会自动提取组装。适用于带模板卡片或者复杂内容的场景。
b：系统提取后展示。七巧AI输出文本或者markdown，系统自动组装成企微智能机器人所需的格式结构体。适用于普通客服回答的场景。
2、延迟回复
企微智能机器人收到用户消息后，企微智能机器人会立刻回复一条文案。然后，七巧AI可以在1个小时内，通过推送链接将回复内容推给智能机器人。机器人再呈现给用户。
用户可以设置立即回复的文案。可以是普通文本，也可以是符合企微智能机器人的格式结构体（例如流式回复+模板卡片）。
4）事件配置
目前，可以针对“进入会话”事件配置默认文案。用户每天第一次进入该机器人的单聊时，机器人会自动推送该文案。
6、复制URL，确定保存智能消息规则
URL是七巧AI的智能消息规则与企微智能机器人关联绑定的唯一依据，一对一绑定。
复制URL后，一定要先确定保存规则，再进行第7步的粘贴，否则企微那边会校验不通过。
7、回到企微管理后台，将URL填写到机器人的URL输入框，确定创建机器人。
8、进入企微通讯录，搜索机器人名称，与其对话。
可以与其单聊，或者将其添加到群聊。
备注：使用企微智能机器人输出结果，需要注意按照企微规定的格式输出。即智能体输出的数据结构体需要符合企微规范。注意，必须是流式消息回复。如果期望智能机器人渲染模板卡片，就必须用流式+模板。
流式消息回复结构体，如果没有图片，msg_item为空即可。注意，企微要求图片是base64，但在七巧输出只需要url，七巧会自动转化为企微所需base64：
{
"msgtype": "stream",
"stream": {
"id": "STREAMID",
"finish": false,
"content": "将答案填写到此，支持markdown语法",
"msg_item": [
{
"msgtype": "image",
"image":{
"url":"将第一张的url放到这里。"}
},
{
"msgtype": "image",
"image":{
"url":"将第二张图片的url放到这里。同理，如果有更多图片，就多一个msgtype+image的组合"}
}
]
}
}
# 禁用/启用
禁用/启用智能消息规则。禁用后，关联的智能机器人无法响应用户的聊天。
# 编辑
编辑智能消息规则。
# 删除
删除智能消息规则，删除后，关联的智能机器人无法再响应用户的聊天。
# 使用企微智能机器人
# 1.1、聊天类型-单聊
1）搜索智能机器人，进入单聊窗口
2）发送消息
企微智能机器人支持接收以下类型的信息：
文本：纯文本发送
图文混排：图片和文案一起发送
语音：语音条发送（不是语音转文字，而是直接的语音）
图片、文件：单独发送图片（不带文本）、文件。需要配合引用消息一起使用。
引用消息：用户引用消息发送时，被引用的消息内容会被一起接收。例如，用户发了一份文件，然后引用文件再发送。那七巧AI就能接收该文件的URL、以及用户新发送的消息。
# 1.2、聊天类型-群聊
1）将企微智能机器人拉入群聊。
2）发言并@智能机器人，智能机器人才会响应。支持接收的内容与单聊一致。
# 2、事件
1）进入会话
用户每天第一次进入与企微智能机器人的单聊时，企微智能机器人会发送一句默认文案（请先在“智能消息管理”里配置）。例如，用户进入单聊后，机器人发送欢迎语和使用文档链接。
2）用户反馈
针对企微智能机器人回复的消息，用户可以点赞/点踩，七巧AI可以接收该类型事件，帮助用户更好记录保存优秀答案或者错误答案，以修正AI回答行为。
3）模板操作
企微智能机器人支持模板卡片，而模板卡片上有若干按钮。用户点击按钮后，七巧AI可以接收点击事件，帮助用户更好地触发相关业务行为。
# 3、智能机器人回复用户
3.1、即时回复/被动回复
企微智能机器人收到消息后，在6分钟内，七巧AI需要回复完整。如果AI处理时间太久，建议使用延迟回复。
3.2、延迟回复
企微智能机器人收到消息后，可以在1小时内回复用户。即，企微智能机器人将用户消息转发给七巧AI后，七巧AI可以在1小时内，将回复内容推送回去。
