AI飞书自动日报培训手册
← 返回培训文档

零基础内部培训 · 从连接到发布

用 AI 智能体完成飞书自动日报

让智能体读取数据、生成文档、私聊给本人审核,再在明确确认后发布到正式汇报对象。

1
连接CLI、应用、机器人、权限
2
建规则日报模板与数据来源
3
每天生成提醒、确认、创建、回读
4
两段审核先私聊本人,再确认发布
开始之前

这套流程解决什么问题

它不是“让 AI 随便写一篇日报”,而是把固定数据、每日重点、文档生成、审核与发布变成一条可重复执行的工作流。

输入数据源 + 今日重点

店铺、人员、收入等固定数据来自指定来源;当天事项由本人补充。

处理AI 提炼与校验

按约定模板生成新文档,并回读检查字段、日期、表格和隐私信息。

审核机器人私聊本人

一条消息内包含文档链接与完整内容,先让本人查看。

发布确认后再转发

只有收到明确的“确认发布”,才发送到大群或其他私聊对象。

最重要的管理规则

“生成”“私聊审核”“正式发布”是三个不同动作。生成日报不等于获得群发权限;任何对外发布都必须设置单独确认门。

基础知识

先认识 6 个名词

不需要学习编程,但要理解谁在读、谁在发、数据从哪里来。

AI 智能体
可以执行多步任务的 AI。它不只回答问题,还能读取文档、运行 CLI、创建文件并检查结果。
飞书 CLI
让智能体通过命令操作飞书的工具。它负责认证、读取文档、创建文档和发送消息。
飞书应用
在飞书开放平台创建的企业自建应用,是权限与机器人能力的载体。
机器人 Bot
应用在飞书里的消息身份。使用 --as bot 时,消息显示为机器人发送。
用户身份 User
完成 OAuth 授权的真实用户。使用 --as user 时,可读取该用户有权限访问的云文档。
Open ID
飞书用户标识,通常以 ou_ 开头。私聊发送时用它指定收件人。
阶段一

连接飞书 CLI,并创建机器人

这一步通常只做一次。每位同事应使用自己的授权或组织统一提供的应用,不能复制他人的密钥和个人 ID。

准备 CLI

按公司或官方渠道安装 lark-cli。在终端执行 lark-cli --help,能显示帮助即表示安装成功。

创建飞书应用

进入飞书开放平台,新建“企业自建应用”,启用机器人能力,并把使用者加入应用可用范围。

发布并建立私聊

发布或安装应用。让使用者打开机器人会话,先给机器人发一条消息,建立可私聊关系。

权限分工

动作使用身份需要什么常见误区
读取用户的飞书文档--as user开发者后台开通 Docs / Drive 对应权限,并由用户完成 OAuth 授权机器人不会自动继承用户的云文档权限
以机器人名义发消息--as botim:message:send_as_bot、应用可用范围、私聊关系机器人权限不足时不应该执行用户登录
发送到群聊--as bot机器人已加入目标群,且用户明确确认正式发布有群 ID 不代表机器人已经在群里
读取电子表格或多维表格通常是用户身份按 CLI 返回的缺失权限逐项开通文档里的嵌入表格不一定会自动展开数据行
初始化 CLI
lark-cli config init --new
发起用户授权
lark-cli auth login --domain docs --domain drive --no-wait --json

智能体应把返回的验证链接和二维码展示给用户。用户完成授权后,智能体再使用当次返回的 device code 完成登录;不要保存或重复使用旧授权码。

检查登录状态并获取本人 Open ID
lark-cli auth status --json --verify

不要在提示词里粘贴 App Secret

密钥应交给 CLI 的安全配置流程保存。不要把密钥、访问令牌或同事的 Open ID 写进日报模板、Skill、自动化提示词或培训群消息。

阶段二

让智能体先“读懂”现有日报

不要直接让 AI 开始生成。先给它一份已经确认正确的日报、所有数据源,以及哪些内容每天变化、哪些内容绝不能猜。

需要提供

  • 一份已确认正确的日报文档
  • 店铺、人员、收入等数据源链接
  • 字段与数据源的对应关系
  • 保密字段和禁止发送对象
  • 日报最终审核人与正式接收对象

智能体需要产出

  • 固定章节与每日变化章节
  • 每个表格的数据来源
  • 计算逻辑与总数校验方法
  • 缺失值和异常值处理规则
  • 生成、私聊、发布的权限边界
提示词:分析现有日报
你现在要帮我搭建一套飞书日报自动生成流程。先不要创建文档,也不要发送消息。

我会提供:
1. 一份已经确认正确的日报文档;
2. 每张表格对应的数据源;
3. 可能涉及的保密信息和接收对象。

请完成以下分析:
- 区分固定内容、每日变化内容和需要人工补充的内容;
- 为每一个字段标明唯一数据来源;
- 列出需要计算或交叉校验的指标;
- 标明哪些信息不可出现在日报或消息中;
- 列出生成前必须向我确认的问题;
- 给出一份“日报生成规则草案”。

分析完成后停下来让我确认,不要擅自执行发送。
阶段三

把日报生成逻辑确认下来

智能体分析完后,应通过一轮问答把规则定死。规则越明确,每天越不需要反复纠正。

必须问清楚

  • 日报标题与日期格式
  • 章节顺序和表格字段
  • 哪些数据必须实时读取
  • 哪些项目由本人当天口述
  • 无内容时写“暂无”还是删除章节
  • 谁可以收到审核稿和正式稿

必须写进规则

  • 不得使用旧日报中的过期数字
  • 不得从语气中推测“需介入事项”
  • 敏感个人行应删除还是隐藏
  • 总收入与明细合计如何比对
  • 私聊审核前必须回读新文档
  • 正式发布必须收到明确确认
提示词:确认自动生成规则
请根据刚才的分析逐项向我确认日报规则,每次只问最影响结果的问题。

最终请整理为一份可执行规则,至少包括:
1. 固定标题、章节顺序和表格表头;
2. 每个字段的唯一数据来源;
3. 每日需要我提供的内容;
4. 数据一致性校验;
5. 隐私与保密规则;
6. 新文档创建和回读检查;
7. 私聊审核消息格式;
8. 正式发布前的确认口令;
9. 禁止发送到的人员或群聊。

我确认规则以前,不要建立定时任务,也不要发送任何消息。
阶段四

设置每日提醒与数据确认

定时任务只负责“提醒和收集”,不要在用户尚未提供当天信息时直接生成并发布。

每天固定时间

例如 15:00,智能体询问当天重点事项,并确认数据源是否更新完毕。

用户回复后

只有收到当天信息和“数据已更新”确认,才进入读取数据与生成文档阶段。

定时任务提示词
每天工作日 15:00 提醒我准备当天日报,只询问:

1. 今天有哪些重点更新事项?
2. 是否有明确标注为“需要关注或介入”的事项?
3. 日报依赖的数据源是否已经更新完毕?

如果我没有提供当天内容,或者没有确认数据源已更新,不要生成文档,不要发送消息。
如果我没有明确说某件事需要关注或介入,则对应栏目写“暂无”,不得自行推测。

如何部署:在正在使用的 AI Agent 产品中找到“Automation / 定时任务 / Scheduled Task”,设置时区、工作日和执行时间,将上面的提示词作为任务说明。若产品没有定时功能,可由公司自动化平台或系统定时器在指定时间调用 Agent。

阶段五

生成新日报,并先私聊给本人审核

每天都创建一个新的日期文档。生成后必须重新读取文档验证,不能只相信“创建成功”。

读取最新数据

逐一读取已确认的数据源,保留原始名称、日期、金额和异常说明。

创建新文档

按规则生成当天的新文档,不覆盖历史日报,不把数据源链接写进日报正文。

回读校验

检查标题日期、章节、表格行数、合计、隐私字段和本人提供的重点事项。

把文档回读成适合消息发送的 Markdown
DOC_JSON="$(lark-cli docs +fetch --as user --doc "$DOC_URL" --doc-format im-markdown --format json)"
BODY_MD="$(printf '%s' "$DOC_JSON" | jq -r '.data.document.content')"
按“链接 + 空行 + 完整正文”拼接
MESSAGE="$(printf '日报文档:%s\n\n%s' "$DOC_URL" "$BODY_MD")"
由机器人私聊本人
lark-cli im +messages-send \
  --as bot \
  --user-id "$SELF_OPEN_ID" \
  --markdown "$MESSAGE" \
  --idempotency-key "$IDEMPOTENCY_KEY" \
  --format json

私聊审核稿的固定格式

第一行是新日报文档链接;接一个真实空行;后面放回读得到的完整日报正文。整套内容只发送一条消息。

核心卡点

为什么表格能直接显示在消息里

关键不是“让 AI 画表格”,而是用正确格式从文档读取,再用正确消息类型发送。

文档层飞书原生表格

表格是文档中的结构化 block,不是截图。

转换层im-markdown

把原生表格序列化成 Markdown 管道表格。

消息层--markdown

CLI 将 Markdown 包装为飞书 post / md 消息。

展示层客户端渲染

飞书客户端把 Markdown 表格显示成可读表格。

智能体回读出的 Markdown
| 项目 | 负责人 | 状态 |
|-|-|-|
| Alpha | 李明 | 进行中 |
| Beta | 王芳 | 已完成 |
日报文档:https://example.feishu.cn/docx/...
项目负责人状态
Alpha李明进行中
Beta王芳已完成

正确做法

  • 读取时使用 im-markdown
  • 发送时使用 --markdown
  • 表头、分隔行、数据行连续存在
  • 链接后使用真实空行
  • 发送后回读消息检查表格文本

会导致失败的做法

  • 使用 --text 发送 Markdown
  • 摘要时删掉 |-|-| 分隔行
  • 把表格转换成截图再发送
  • 链接后出现字面量 \n\n
  • 把嵌入 Sheet 的 token 当成表格数据

文档原生表格与嵌入电子表格不同

文档原生表格可以直接转成 Markdown。嵌入的 Sheet 或 Base 可能只返回引用信息,智能体必须继续读取其中的单元格,再自行构造 Markdown 管道表格。

阶段六

本人审核后,再正式发布

私聊审核与正式发布要使用两道独立权限门。没有明确确认,智能体只能修改并重新私聊,不能自行群发。

第一道门:私聊审核

机器人只发给本人。本人检查文档、数字、表格和表达;有问题就修改、回读、重新审核。

第二道门:确认发布

本人明确回复“确认发布到指定群和指定私聊”后,智能体才按确认清单逐一发送。

提示词:正式发布确认
在我审核日报以后,先向我展示最终发布清单,包括:
- 发送者身份;
- 每一个群聊名称和 chat_id;
- 每一个私聊对象;
- 准备发送的消息格式;
- 是否包含文档链接和完整正文。

只有当我明确回复“确认发布”后,才执行正式发送。
如果我只是说“修改一下”“重新发给我看看”或“确认内容”,都不代表允许发送到大群或其他人员。

每个目标使用独立幂等键。发送完成后回读消息,并汇报成功或失败的目标,不要重复发送成功项。
上线检查

每日执行清单与常见故障

判断自动化是否可靠,不看它有没有说“完成”,而看它是否能回读并提供证据。

生成前

  • 用户已提供当天重点事项
  • 用户已确认数据源更新完毕
  • 数据源链接和日期正确
  • 没有把敏感字段放入草稿

私聊前

  • 新文档标题日期正确
  • 固定章节和表格完整
  • 明细合计与汇总一致
  • 正文保持第一人称或约定语气

私聊后

  • 发送者是指定机器人
  • 收件人是本人私聊
  • 链接后是真实空行
  • 表格分隔行和数据行完整

正式发布前

  • 本人已明确回复确认发布
  • 群聊和私聊对象已逐项确认
  • 机器人已在目标群内
  • 幂等键不会与审核稿冲突

常见故障

机器人提示没有权限
查看错误中的 missing_scopesconsole_url。用户权限通过 OAuth 授权;机器人权限在飞书开放平台开通。不要凭经验随意申请全部权限。
机器人无法私聊某位同事
确认该同事在应用可用范围内、应用已发布、机器人权限已生效,并且同事已经打开过机器人会话或主动发过消息。
消息里表格变成一堆竖线
检查读取是否使用 --doc-format im-markdown,发送是否使用 --markdown;不要用 --text
文档链接没有预览卡片
回读消息,检查链接后是否出现字面量 \n\n。使用 printf 生成真实换行,并确保链接与正文之间有一个真实空行。
电子表格只显示一个 token
这说明它是嵌入的 Sheet 或 Base,不是文档原生表格。继续调用对应表格读取能力,拿到单元格后再生成 Markdown 表格。
消息太长,发送失败
不要静默截断。请用户选择:缩短摘要、仅保留关键表格、附上文档链接,或者明确同意拆成多条消息。
直接使用

一段式部署提示词

已经熟悉流程后,可以把下面的提示词交给支持飞书 CLI 的智能体,让它分阶段引导部署。

完整部署提示词
请帮我搭建一套“飞书自动日报”流程,但必须分阶段执行,未经确认不得跳步。

阶段 1:检查飞书 CLI、用户认证、机器人能力和权限。读取文档使用用户身份,发送消息使用机器人身份。不得要求我在聊天中粘贴 App Secret 或访问令牌。

阶段 2:读取我提供的一份已确认日报和所有数据源,分析固定章节、每日变化内容、字段来源、计算校验和保密规则。只输出规则草案,等我确认。

阶段 3:逐项询问并确认日报标题、章节顺序、表格表头、数据源、每日人工输入、缺失值处理、隐私规则和正式接收对象。

阶段 4:在我指定的每日时间提醒我提供当天重点事项,并确认数据源已更新。未收到当天信息或未确认数据源更新时,不得生成和发送。

阶段 5:每天创建全新日期日报,读取最新数据,生成文档后使用 im-markdown 回读,检查日期、章节、表格、合计和敏感信息。

阶段 6:由机器人先私聊发给我一条消息,格式必须是:
日报文档:<新文档链接>

<回读得到的完整 Markdown 正文>

链接后必须是真实空行,不能发送字面量 \n\n。发送使用 --markdown,保证文档原生表格在对话中渲染为表格。发送后回读消息检查表格和链接。

阶段 7:我审核后,只有明确回复“确认发布”才可以发送到我确认的大群和私聊对象。生成日报、确认内容或要求修改都不代表允许正式发布。

整个流程必须使用幂等键防止重复发送,并且任何跨人员或群聊的发送都要先展示目标清单让我确认。