AB
AiBoss
Tutorials

元气AI Bot

Tutorials

安装并配置元气AI Bot:接入飞书、跑通会议安排与文档处理

面向飞书用户的元气AI Bot 配置教程:从获取安装包、完成首次授权,到用 @ 唤醒机器人安排会议、用斜杠指令做摘要翻译与流程图,再到日志排查与私有化部署的注意事项。

元气AI Bot 是一款运行在飞书生态里的 AI 助手:它不是一个需要单独打开的独立应用,而是以机器人的形式挂在飞书聊天窗口里,通过 @ 唤醒或斜杠指令来调用。它主要解决三类重复劳动——会议的组织与记录、文档的摘要与翻译、以及技术日志的初步排查。适合日常在飞书里办公、希望把「订会议室、写周报、翻文档、看报错」这些动作压缩成一句话的人;企业用户还可以进一步考虑私有化部署与权限对接。站内也整理了同类工具的入口,可以先从 元气AI Bot 这一条目看起,再回到本文按步骤配置。

需要先说明的是,本文讲的是「怎么把它装起来、授权好、然后真正跑通一个场景」,而不是功能罗列。下面所有命令与指令都来自公开的配置说明,涉及版本号、安装包体积、准确率、合规认证等易变信息时,请以官网当前公布的信息为准。

准备工作

在动手之前,先把下面几件事确认清楚,能省掉后面大半的排错时间。

账号与客户端

  • 飞书客户端:机器人依附于飞书运行,首次启动时会自动检测本机飞书客户端,兼容 6.8 及以上版本。版本过低会直接导致机器人不响应,这一点在后面的排查章节还会提到。
  • 登录方式:支持扫码与账号密码两种验证方式,任选其一即可。
  • 企业用户:如果所在组织已经开通了企业版,可以在首次配置时一键导入组织架构,省去逐个添加成员的步骤。

按设备类型选择安装包

不同终端的获取方式不一样,先对号入座:

设备类型获取方式说明
Windows / Mac轻量客户端安装包体积小于 50MB,适合个人日常使用
Android应用分发渠道提供的安装包素材中提到的版本为 v1.8.1,约 42.3MB,要求 Android 10 及以上
iOSApp Store 搜索「元气AI」提供企业签名版
企业服务器Docker 镜像包用于私有化部署,见后文注意事项

桌面端与移动端的功能入口基本一致,区别在于桌面端更适合处理文件与长文档,移动端更适合随时用 @ 唤醒。企业用户如果打算做私有化,不要从个人版安装包开始,直接走 Docker 镜像那条路径。

权限预期

首次启动时只需要授权两项权限:消息接收与文件上传。前者让机器人能读到你在聊天里发给它的指令,后者让它能处理你上传的文档。除此之外不需要额外授权,如果安装过程中出现要求更多权限的提示,应当先核对来源是否可信。

操作步骤

第一步:下载并启动安装向导

从官方渠道获取对应平台的安装包后,双击启动安装向导。安装程序会自动识别当前设备类型,并给出匹配的安装选项。整个流程是静默式的,中途不需要反复点「下一步」。

安装路径默认推荐系统分区。如果系统盘空间紧张,可以在向导里改到其他分区,但要注意后续升级时保持路径一致,避免出现两个版本并存的情况。

第二步:完成首次启动配置

安装结束后首次启动,程序会依次做三件事:

  1. 检测本机飞书客户端是否存在、版本是否满足要求;
  2. 引导你完成扫码或账号密码登录;
  3. 请求「消息接收」与「文件上传」两项授权。

企业用户在这一步会额外看到「导入组织架构」的入口,勾选后可以批量同步成员,不必手工维护名单。

第三步:在飞书里唤醒机器人

配置完成后,机器人会出现在飞书的联系人列表里。唤醒方式是在任意聊天窗口输入 @元气AI 加上你的需求,例如:

@元气AI 安排周三下午产品评审会

这条指令会触发一串连锁动作:预定会议室并同步所有参会人的日历、生成标准化议程、发送材料提醒邮件。也就是说,一句话替代了原本要在三个界面里分别完成的操作。

第四步:用斜杠指令处理文档

文档类任务走的是另一套入口:先把文件上传到对话里,再发送斜杠指令。常用指令有三个:

/总结 核心要点
/翻译 en-US
/生成流程图
  • /总结 核心要点:对上传的文档生成摘要,后面的「核心要点」是提示词,可以按需替换成其他关注点。
  • /翻译 en-US:做中英互译,参数位填目标语言代码。
  • /生成流程图:把文档里的流程性内容转成可视化图形。

这三个指令可以连续使用,比如先总结再翻译,机器人会在同一段对话里保留上下文。

第五步:用日志排查技术故障

遇到报错时,把错误日志直接粘贴进对话,机器人会做三件事:定位出问题的模块、给出若干种解决方案、关联历史上相似的案例。这一步的价值在于省掉「拿报错去搜索引擎里翻半小时」的过程,但结论仍然需要你自己判断,尤其是涉及生产环境变更时。

第六步:开发者相关的调试能力

如果用途偏向开发,还有几项能力值得了解:内置的 RESTful 测试环境可以直接在对话里发请求调试接口;日志分析会把错误代码与解决方案做关联;多模型切换允许在不同 AI 引擎之间无缝切换,适合对比同一任务在不同模型下的输出质量。

一个完整示例

下面把上面的步骤串成一个从头到尾能跑通的最小流程,场景是「开完一场评审会,把纪要整理成周报素材」。

前置状态:飞书客户端已登录,元气AI Bot 已安装并完成两项授权,机器人出现在联系人列表。

第 1 步,发起会议安排。在任意聊天窗口输入:

@元气AI 安排周三下午产品评审会

预期结果是会议室被预定、参会人日历收到同步、议程与材料提醒邮件发出。此时不需要再手动去日历里补任何东西。

第 2 步,会议中获取转录。会议期间由机器人的实时转录能力记录中英文内容,会后得到一份文字稿。

第 3 步,处理文字稿。把文字稿作为文件上传到对话,然后依次发送:

/总结 核心要点
/生成流程图

第一条得到摘要,第二条把讨论中的流程部分转成图。如果团队里有非中文成员,再补一条 /翻译 en-US。

第 4 步,产出周报。把摘要内容交给报告生成能力,从模板里选周报格式,得到初稿后再人工润色。整个链路里,人只负责判断和修改,收集、转录、归纳、排版这些动作都交给了机器人。

这条链路跑通一次之后,后续每周只需要重复第 1 步和第 3 步的指令,其余环节是固定的。

注意事项

安装阶段的常见问题

提示「证书不受信任」。企业版安装包在部分系统上会遇到这个提示,需要在系统的「设置 - 通用 - 设备管理」中手动授权后才能继续。个人版一般不会触发。

安装包来源。素材里提到的第三方应用分发站点与官网地址,本文不逐一列出,也不建议从非官方渠道获取安装包——机器人需要读取消息与文件,来源不可信的安装包风险很高。请以官方当前公布的下载入口为准。

机器人无响应时的排查顺序

按下面三项依次检查,绝大多数无响应问题出在其中之一:

  1. 网络代理设置:代理配置异常会导致机器人收不到消息。
  2. 飞书版本号:低于 6.8 的客户端不兼容,需要先升级飞书。
  3. 机器人开关状态:确认机器人在当前会话里处于启用状态,而不是被静音或移除。

数据与合规

传输环节采用加密方式,素材中提到通过了 ISO27001 认证;企业版在合规层面还涉及等保 2.0 三级与 GDPR 合规。这些认证的具体范围与有效期属于会变化的信息,签约或采购前应当以官方当前披露为准,不要以本文描述作为合规依据。

权限管控方面,企业版提供细粒度的 RBAC 与 LDAP 对接,可以把机器人的可用范围限制在特定部门。审计追踪会完整记录所有 AI 操作日志,这一点在有内审要求的组织里比较关键。

私有化部署

对数据主权有要求的企业可以选择私有化部署,支持的环境包括 Kubernetes、VMware 与裸金属,也支持混合云方案。部署细节不在安装包的范畴内,需要参考企业版专门的部署文档。需要注意的是,私有化部署与个人版客户端是两条独立的路径,配置方式、升级节奏都不同,不要混用。

关于能力指标的说明

素材中给出了若干量化描述,例如会议转录的准确率、报告模板的数量、邮件处理节省的时间比例、安装包体积的缩减幅度等。这类数字随版本迭代变化很快,且与实际使用环境(口音、网络、文档格式)强相关,本文不把它们当作承诺值。评估是否适用时,建议用自己团队的真实会议录音和真实文档做一轮小范围试用,再决定推广范围。

指令使用的两个细节

一是斜杠指令后面的提示词不是固定的,/总结 后面跟什么,决定了摘要偏向哪个维度,写「核心要点」和写「待办事项」得到的结果完全不同。二是 @ 唤醒只在有机器人的会话里有效,跨会话调用需要先把机器人拉进对应群组。

把上面这些配置做完,日常使用其实就归结为两类动作:在聊天窗口里 @ 它安排事情,在上传文件后发斜杠指令处理内容。剩下的时间,交给它跑。