Skip to content
深脑

接入飞书:机器人、妙记导入与自动同步

在飞书里问深脑、把妙记导进来、每天自动导入

在 设置 → 飞书(妙记 / 机器人) 这一页做三件事:绑定飞书机器人、导入飞书妙记、打开每天自动导入。三件事互相独立,用哪件开哪件。

〇、飞书开放平台要填的地址和权限(管理员)

机器人和妙记导入可以用同一个飞书企业自建应用。下面三个地址逐字复制,填到飞书开放平台对应的位置。

事件订阅的请求地址——「事件与回调」→ 订阅方式选「将事件发送至开发者服务器」,请求地址填:

https://shennao.zaowuyun.com/api/feishu/events

同一页「加密策略」里必须设置 Encrypt Key(深脑拒收没有签名的事件);「添加事件」里加「接收消息 v2.0」(im.message.receive_v1)。

机器人绑定的重定向 URL——「安全设置」→「重定向 URL」加一条:

https://shennao.zaowuyun.com/api/feishu/bind/callback

妙记授权的重定向 URL——同一处再加一条,两条并存:

https://shennao.zaowuyun.com/api/integrations/feishu/auth/callback

要开的权限(「权限管理」里搜索权限名开通):

用途权限
机器人:收单聊消息im:message.p2p_msg:readonly
机器人:收群里 @ 它的消息(不要开「获取群组中所有消息」)im:message.group_at_msg:readonly
机器人:回复消息im:message:send_as_bot
机器人:读群成员、判断是不是外部群im:chat:readonly
机器人:绑定时读昵称contact:user.base:readonly
妙记:列出我的妙记(用户身份权限,下同)minutes:minutes.search:read
妙记:标题、开始时间、时长minutes:minutes.basic:read
妙记:导出逐字稿minutes:minutes.transcript:export
妙记:读逐字稿与总结minutes:minutes.artifacts:read
妙记:获取用户 IDauth:user.id:read
妙记:长期有效,不用每 2 小时重新连接offline_access

妙记的 6 个一个都不能少:连接时会一次申请这 6 个,少开一个授权页就报错。

改完权限、事件订阅或重定向地址之后,必须在「版本管理与发布」里发布一个新版本,并等企业管理员审核通过,才会生效。

一、飞书机器人

机器人目前只在深脑开通的飞书企业内可用;妙记导入各企业都可以用自己的应用接入。

绑定:页面顶部「飞书机器人」卡片 → 点「绑定飞书」→ 在飞书授权页点同意 → 回到深脑显示「已绑定:你的名字」。

  • 绑定时你在哪个组织,机器人就按哪个组织回答。想换组织,切到那个组织后重新绑定。
  • 随时可以「解除绑定」。
  • 卡片显示「管理员尚未开通飞书机器人」时,说明深脑这边还没开通,暂时用不了。

单聊:在飞书里直接给机器人发问题。回答和网页侧栏的深脑 Agent 是同一套:按你能看到的内容回答,带出处,点「查看」回到深脑的分析页。

  • 单聊的问答会出现在网页侧栏的对话历史里;30 分钟内接着问,会续在同一段对话里。

群里 @ 它:在群里 @ 机器人提问。为了不把某个人看得到、别人看不到的内容说出来:

  • 只用群里所有人都看得见的内容回答;
  • 群里有人还没绑定深脑、或者是外部群,就不在群里回答,请改成单聊;
  • 群里的回答不带对话历史、不读你的个人记忆;出处只列主题和链接,不贴原话。

没绑定的人来问,机器人只回「请先在深脑设置里绑定飞书」和链接,不回答任何内容。

在飞书里提问和在网页里提问一样计入用量。

二、导入飞书妙记

管理员先做一次:按上面「〇」把妙记的 6 个权限和妙记授权的重定向 URL 开好、发布版本并审核通过,然后回到深脑,在「① 应用凭证」填这个应用的 App ID 和 App Secret,点保存。Secret 加密保存,之后页面上只显示 App ID。只有组织的所有者和管理员能填。

一定要先在飞书开放平台开好并发布,再来填凭证、点连接;顺序反了,飞书授权页会报权限未开通或重定向地址不合法。

每个人各连一次:在「② 连接我的飞书」点「连接飞书」→ 在飞书授权页同意 → 自动回到这一页。每个人只能看到自己有权限的妙记。

挑出来导入:「③ 我的妙记」按时间从新到旧列出你的妙记——你是所有者的,和你参会的,分别标「我的」「他人的」。

  • 每条显示日期和时刻、时长、参会人数和写着真名的前几个人、妙记总结的第一句;底部「加载更多」往更早翻。
  • 已导入的标「已导入」,附「查看素材」和「看分析进度」,不能再勾。
  • 不到 1 分钟的置灰,写「太短,分析意义不大」,不能勾。
  • 勾选要导入的几条(「全选本页」会自动跳过已导入和太短的),点「导入所选」,一次最多 20 条。
  • 列表顶部写着「导入到:某空间」——导进你当前所在的空间。要导到别的空间,先在左侧栏顶部切过去。

导完看结果:每条一行——「已入库」「重复,已跳过」(附原来那条的链接)「没有导入」(逐字稿是空的或太短)「失败」(附原因)。导入后自动排上分析;额度不够时只入库,会单独提示;补充额度后(个人空间联系深脑客服,组织空间找管理员),在素材页点分析。

妙记里写着的 @真名 会直接作为说话人,不用再认一遍人。

三、每天自动导入

连上飞书之后,打开「每天自动导入新妙记」。

  • 每天 07:30(北京时间)导入打开之后产生的新妙记;打开之前的不会补,请用上面的列表手动导入。
  • 不到 1 分钟的跳过;已经导入过的、内容重复的也跳过。
  • 导入后自动分析,每人每天最多自动分析 10 条,超出的只入库不分析,可以在素材页手动分析。
  • 导进打开开关时所在的空间,卡片上写着「同步到:某空间」。要换空间,先关掉,再到另一个空间重新打开。
  • 卡片上显示上次同步的时间和结果:拉到、导入、跳过、失败、未分析各几条。

飞书授权过期了:自动导入会自动关掉,设置页顶部和收件箱都会提醒「飞书授权已过期,请重新连接」。点「重新连接飞书」授权一次,然后手动再打开自动导入——重新连接不会替你打开,免得你以为已经恢复。