# 智能机器人管理
# 概念对齐
智能机器人管理是管理各种消息渠道与AI技能关联的功能模块。当前主要管理企微智能机器人与七巧AI集成落地。
企微智能机器人是企微推出的AI聊天虚拟员工，用户可以与其单聊、群聊，它会基于配置，智能地回答用户问题。
企微智能机器人支持【接收】用户的文本、图片、图文混排、文件、语音、引用的消息。
企微智能智能机器人支持【回复】markdown格式的内容。其中markdown的图片链接，如果是公域图片，会将图片完整展示出来。也支持渲染特定格式的模板卡片。
企微智能机器人有三种配置模式
1、普通模式
也叫“原生模式”，直接管理机器人的提示词、关联知识集（微盘）、插件、工作流等。效果等同于dify、coze的agent。
也就是，原生模式就是企微推出的智能体搭建平台。
2、API-长连接模式
企微为了连接openclaw推出的长连接模式，企微智能机器人会与“目标产品”构造websocket通道，只要通道存在，双方都可以收发消息。
也就是，“目标产品”可以主动给机器人发消息，机器人主动推送并展示给用户，打破过往的“一问一答”形式。
构建长连接通道需要集成企微SDK，dify、coze等智能体平台没有集成。所以如果这些平台的智能体要主动给机器人发消息，必须通过七巧AI中转。
长连接有个优势：企业不需要公网ip或公网域名，借助七巧就能直接让机器人与智能体集成。
3、API-URL模式
URL回调模式是企微传统的接收消息模式，需要公网ip，而且不支持智能体主动给机器人发消息。只适合一问一答的简单场景。
# 服务设置
温馨提示：如果无公网ip或企业域名，推荐使用长连接模式的机器人。该模式不需要配置服务设置。
当前企微的智能机器人属于自建应用接口，非服务商三方接口。所以企业需要私有部署七巧AI的“智能消息服务”，然后获取服务请求地址。该服务很小，不会占用太多硬件资源，具体请联系七巧商务人员。
点击【服务设置】，打开弹窗，填写服务地址，确定即可。
# 长连接模式：添加规则&配置机器人
1、进入企微管理后台-安全与管理-管理工具-智能机器人。https://work.weixin.qq.com/wework_admin/frame#/aiHelper/list?from=manage_tools (opens new window)
2、创建机器人，手动创建，切换成API模式，选择“长连接”
3、完善机器人基本信息，生成secret，确定保存
完善机器人名称、可见范围。点击【点击获取】secret，获取机器人的长连接密钥。
复制好bot id、secret，就可以保存机器人。
4、进入七巧管理后台-AI中心-智能机器人管理，添加规则，配置好机器人关联信息
打开添加规则弹窗，将第3步的bot id、secret粘贴到此。
5、配置长连接的回复
前提条件：需要配置好dify、coze等智能体。然后在智能体里增加节点，以实现推送消息给机器人。
长连接主动回复URL+回复密钥
dify、coze等智能体可以通过http节点、代码节点，调用该URL，将要发给用户的消息推送回来。七巧AI收到消息后，会通过长连接通道发给机器人，机器人再通知并展示给用户。
推送结构体说明：
1、鉴权：采用bearer鉴权，可以重新随机 主动回复的密钥。
2、chatid：企微会话id，用于定位该条消息发给哪个聊天。因为该机器人可能与多个用户、多个群都产生过聊天。如果是群聊，必须是群聊的明文id。七巧AI收到用户私聊或群聊时，会将chatid作为上下文传给智能体，智能体可以自行提取和记录。
3、chatType：如果chatid是群聊，那就是group。如果单聊，就是single。
4、feedBack：feedback id。只要保证唯一，那用户就可以对机器人回复的消息进行点赞、点踩。七巧AI会将反馈消息重新传回给dify、coze等智能体。需要智能体自行处理反馈内容，例如将点踩的消息收录在案，用于知识库迭代。推荐使用智能体的消息id，以便智能体根据消息id反查消息内容，将消息内容记录下来。
5、msgType：固定是markdown
6、Content：将消息内容以markdown格式赋给markdown变量。
6、配置规则关联的AI技能
配置机器人收到消息，应该触发哪些功能。
目前，七巧支持三种拓展能力
应用回调函数：触发七巧应用的回调任务，通过低代码脚本处理用户消息。
AI平台技能：触发七巧AI平台技能，进而启动技能关联的智能体。
AI应用技能：触发七巧AI应用技能，进而启动技能关联的智能体。
对于AI平台技能、AI应用技能，可以配置AI会话类型：
所有消息共用对话：群内所有用户与同一个智能机器人产生的对话，将纳入同一全局上下文。不同用户的交互内容，将共享上下文，会形成连续的对话逻辑。
发送用户独享对话：单个用户与同一个智能机器人的交互，独立形成专属上下文。仅该用户可基于自身历史对话延续交互，其他用户无法获取、关联此上下文信息。无论是单聊还是群聊，用户自己都是独享上下文。
总是新对话：每一次用户与同一个智能机器人的对话，均作为独立会话。不继承任何历史交互上下文，会话间逻辑完全隔离，每次交互都是 “从零开始” 。无论是单聊还是群聊，每次对话都是全新开始。
7、保存并启用规则
保存规则，并启用。然后就可以去企微搜索该机器人进行对话。
# URL回调模式-添加规则&配置机器人
1、进入企微管理后台-安全与管理-管理工具-智能机器人。https://work.weixin.qq.com/wework_admin/frame#/aiHelper/list?from=manage_tools (opens new window)
2、创建机器人，手动创建，切换成API模式，选择“URL回调”
3、完善基本信息，随机获取token和AESKey。
4、不要关闭企微管理后台。新开标签页进入七巧管理后台-AI中心-智能机器人管理。点击添加。
5、完善机器人集成信息
1）基本信息
规则名称、id、备注
2）基础能力
将第三步获取的token、AESKey，复制粘贴。
机器人名称、机器人id仅用于记录区分企微智能机器人信息，可以不填。
6、配置规则的拓展能力
支持智能机器人收到用户消息后，将消息发给指定的拓展能力。例如将收到的消息发给七巧AI技能。
目前，七巧支持三种拓展能力
应用回调函数：触发七巧应用的回调任务，通过低代码脚本处理用户消息。
AI平台技能：触发七巧AI平台技能，进而启动技能关联的智能体。
AI应用技能：触发七巧AI应用技能，进而启动技能关联的智能体。
对于AI平台技能、AI应用技能，可以配置AI会话类型：
所有消息共用对话：群内所有用户与同一个智能机器人产生的对话，将纳入同一全局上下文。不同用户的交互内容，将共享上下文，会形成连续的对话逻辑。
发送用户独享对话：单个用户与同一个智能机器人的交互，独立形成专属上下文。仅该用户可基于自身历史对话延续交互，其他用户无法获取、关联此上下文信息。无论是单聊还是群聊，用户自己都是独享上下文。
总是新对话：每一次用户与同一个智能机器人的对话，均作为独立会话。不继承任何历史交互上下文，会话间逻辑完全隔离，每次交互都是 “从零开始” 。无论是单聊还是群聊，每次对话都是全新开始。
对于消息输出，目前七巧AI支持控制企微智能机器人的两种输出：
1、即时回复
企微智能机器人收到用户消息后，只要七巧AI在6分钟内回复，机器人可以直接呈现AI输出内容。
其中，有两种提取方法：
a：不提起，直接显示。七巧AI需要输出符合企微智能机器人的格式结构体，系统不会自动提取组装。适用于带模板卡片或者复杂内容的场景。
b：系统提取后展示。七巧AI输出文本或者markdown，系统自动组装成企微智能机器人所需的格式结构体。适用于普通客服回答的场景。
2、延迟回复
企微智能机器人收到用户消息后，企微智能机器人会立刻回复一条文案。然后，七巧AI可以在1个小时内，通过推送链接将回复内容推给智能机器人。机器人再呈现给用户。
用户可以设置立即回复的文案。可以是普通文本，也可以是符合企微智能机器人的格式结构体（例如流式回复+模板卡片）。
4）事件配置
目前，可以针对“进入会话”事件配置默认文案。用户每天第一次进入该机器人的单聊时，机器人会自动推送该文案。
7、复制URL，确定保存智能消息规则
URL是七巧AI的智能消息规则与企微智能机器人关联绑定的唯一依据，一对一绑定。
复制URL后，一定要先确定保存规则，再进行第7步的粘贴，否则企微那边会校验不通过。
8、回到企微管理后台，将URL填写到机器人的URL输入框，确定创建机器人。
9、进入企微通讯录，搜索机器人名称，与其对话。
可以与其单聊，或者将其添加到群聊。
备注：使用企微智能机器人输出结果，需要注意按照企微规定的格式输出。即智能体输出的数据结构体需要符合企微规范。注意，必须是流式消息回复。如果期望智能机器人渲染模板卡片，就必须用流式+模板。
流式消息回复结构体，如果没有图片，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、即时回复/被动回复
长连接支持即时回复：也就是，只要智能体那边正常输出，七巧AI会自动提取内容，流式返回给机器人。机器人流式地展示给用户。
URL回调也支持即时回复。但是否要七巧AI自动提取，看具体规则配置。
无论是长连接，还是URL回电，企微智能机器人收到消息后，在6分钟内，七巧AI需要回复完整。如果AI处理时间太久，建议使用延迟回复（URL回调专属）、主动回复（长连接）。
3.2、延迟回复（URL回调专属）
企微智能机器人收到消息后，可以在1小时内回复用户。即，企微智能机器人将用户消息转发给七巧AI后，七巧AI可以在1小时内，将回复内容推送回去。
3.3、主动回复（长连接专属）
智能体主动调用“主动回复URL”，将消息推送回来。
