阮一峰的网络日志

当办公套件遇上 AI Agent:开源项目飞书 CLI 介绍

一、引言

今年春节前,龙虾 OpenClaw 突然爆火,引发各种云服务纷纷开放 API 让它接入。

有一类非常重要的软件,也在这期间开放了 API,但是没有得到外界的太多关注。那就是办公套件。

Image

大家想象一下,办公文档一旦实现 AI 自动化,可以简化多少工作和流程,而且是多大的一个市场!

我最近就有这方面的需求,想让 AI 在云端自动化管理文档,就去搜索了可以接入 Agent 的办公套件工具包。

下面就是我的搜索结果。

•Google WorkSpace CLI[1]•飞书 CLI[2]•钉钉 CLI[3]•企业微信 CLI[4]

这四个开源工具包都允许用户在命令行调用 API,操作自家的云端 SaaS 服务。

其中,谷歌 WorkSpace CLI 是半官方的,是他们的一个工程师个人在维护,其他三个都是官方项目。

这三个国产办公套件工具包之中,飞书 CLI[5] 比较突出。

Image
Image

上图可以看到,这三家的发布时间相差无几,但是飞书开放的功能最全,项目规模和 Star 数量都是最高。

我用了几天飞书 CLI[6],感觉不错,如果你也想办公套件接入 Agent、实现办公自动化,它可能是这三家里面最容易满足你的需求的工具。下面就是我的简单使用介绍。

二、基本情况

首先,飞书 CLI 是一个很新的工具,今年3月28日刚刚发布,迄今不过40多天。

它的活跃程度非常高,已经发了30个版本,基本上(工作日)一天一个新版本。如果在仓库提问或请求功能,很快会得到响应,这一点比较让人放心。

Image

其次,这个工具包的功能相当全,飞书现有的业务域,它几乎都能操作,已经具备100多项能力。

Image

上面是它现在支持的17个业务域,囊括了企业办公的各方面。我认为,它的最大卖点就是这个:可以开箱即用某一个业务域、某一项能力的 API,也可以深度编排多种能力,定制跨域工作流,实现复杂业务的自动化。

最后,它是一个彻底开源的国际化项目,采用 MIT 许可证,几乎没有使用限制。外部的代码贡献者数量不少,我看有不少外部 PR 被合并进了主干。

三、项目结构和 Skill 封装

在代码上,这个项目采用多层封装的结构。

最底层是飞书 OpenAPI[7],可以看到每一个具体的 API 接口,包括参数、返回值、报错类型等等。

第二层是命令层,每一个命令与 OpenAPI 的定义一一映射。

第三层是快捷方式层,对命令层进行了包装,提供默认参数,简化调用写法,输出便于阅读的格式,尽量对用户友好,降低使用门槛。

除了这三层,还有一个单独的 SKill 部分,也就是为 Agent 封装的能力扩展包,包括专门的脚本和提示词,大大方便了 AI 的调用,目前内置了24个 Skill,都属于官方的最佳实践。

Image

四、AI agent 的接入

这个项目使用 Go 语言开发,封装为 npm 软件包,安装[8]采用 npm 命令。

$ npx @larksuite/cli@latest install

不过,更好、更简单的安装方法,是使用自然语言[9]让 Agent 自己去安装。

Image

整个安装过程是自动的,但是登录和授权需要手动完成。

Image

安装后,Agent 就能控制你的飞书账户了,这时就可以直接下达任务让 AI 去跑。

下面是一个测试示例,在 Claude Code(或其他 Agent)里面,要求 AI 总结近期文档(下图)。

Image

五、典型能力

这个工具能做的事情很多,下面罗列几项。我看官方有一个《飞书 CLI 的 100 多个新本领》[10]的能力清单,大家可以参考。

(1)文档功能。我平时写的是 Markdown 文档,但飞书是可视化编辑器,你可以把 Markdown 原稿提交给 AI,让它调用 Skill 进行排版和发布。

[提示词]
把这篇 Markdown 内容创建成飞书文档,排版要好看。

飞书支持文档评论,我们一般用这个功能发表修改意见,可以让 AI 根据评论自动修改文档。

[提示词]
{{文档链接}} 根据评论修改文档,修改后,用划词评论标识出修改点。

也可以让 AI 生成文档的修改意见。

[提示词]
{{文档链接}}阅读一下这篇文档,看下作为提供给外部用户的说明文档,是否足够清晰、简洁。不要直接改文档,只把你觉得有优化空间的位置划词评论出来,在评论里写上修改意见。

(2)画板功能。画板主要用于生成可编辑的流程图、框架图、时序图等,可以让 AI 根据文档内容,生成相应图形插入文档。

Image

(3)幻灯片功能。它提供预置的飞书 PPT 模板,目前有40多个,足够用了,你可以指定模板,将文档转成幻灯片。

Image

(4)工作流。工作流就是一个跨多个业务域的多步骤操作流程,比如让 AI 获取某个群聊的参与者名单 --> 参看每个参与者的日历,找到所有人空闲时间 --> 为这些人约一个在线会议。

[提示词]
帮我看一下【XX】群里所有人的日历,然后下周找一个大家都合适的时间开一小时的讨论会

再比如,让 AI 读取邮箱,一旦有重要的未读邮件,就转发到讨论群。

[提示词]
查看我所有的未读邮件,重要邮件发摘要到【XX】项目群

六、总结

如果你已经是飞书用户,我认为这个飞书 CLI[11] 是必备工具,搭配 AI agent,会大大提高办公套件的实用性和便利性。

如果还没用飞书,考虑到它是免费的,所有基础设施都已经通过这个工具包向 agent 开放了,不用似乎有点可惜。

看得出来,官方非常重视这个项目,投入很大,一直在密集开发,想要抢占 Agent 市场。我觉得,他们应该会长期做下去。

再加上,项目本身是 MIT 许可证,可以商用,所以也是一个机会,值得大家利用飞书的基础设施,开发二级应用,探索一下企业级办公软件市场。

(完)

References

[1] Google WorkSpace CLI:https://github.com/googleworkspace/cli
[2]飞书 CLI:https://github.com/larksuite/cli
[3]钉钉 CLI:https://github.com/DingTalk-Real-AI/dingtalk-workspace-cli
[4]企业微信 CLI:https://github.com/WecomTeam/wecom-cli
[5]飞书 CLI:https://github.com/larksuite/cli
[6]飞书 CLI:https://github.com/larksuite/cli
[7]飞书 OpenAPI:https://www.feishu.cn/content/785259988660
[8]安装:https://github.com/larksuite/cli#quick-start-human-users
[9]使用自然语言:https://www.feishu.cn/feishu-cli
[10]《飞书 CLI 的 100 多个新本领》:https://bytedance.larkoffice.com/wiki/CLNjwBozvi11IjkeChOcltHinye
[11]飞书 CLI: https://github.com/larksuite/cli