# 智能消息管理
# 概念对齐
智能消息管理是管理各种消息渠道与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会话类型：
所有消息共用对话：群内所有用户与同一个智能机器人产生的对话，将纳入同一全局上下文。不同用户的交互内容，将共享上下文，会形成连续的对话逻辑。
发送用户独享对话： 单个用户与同一个智能机器人的交互，独立形成专属上下文。仅该用户可基于自身历史对话延续交互，其他用户无法获取、关联此上下文信息。无论是单聊还是群聊，用户自己都是独享上下文。
总是新对话： 每一次用户与同一个智能机器人的对话，均作为独立会话。不继承任何历史交互上下文，会话间逻辑完全隔离，每次交互都是 “从零开始” 。无论是单聊还是群聊，每次对话都是全新开始。
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的组合"}
}
]
}
}
# 禁用/启用
禁用/启用智能消息规则。禁用后，关联的智能机器人无法响应用户的聊天。
# 编辑
编辑智能消息规则。
# 删除
删除智能消息规则，删除后，关联的智能机器人无法再响应用户的聊天。