准备 CLI
按公司或官方渠道安装 lark-cli。在终端执行 lark-cli --help,能显示帮助即表示安装成功。
零基础内部培训 · 从连接到发布
让智能体读取数据、生成文档、私聊给本人审核,再在明确确认后发布到正式汇报对象。
它不是“让 AI 随便写一篇日报”,而是把固定数据、每日重点、文档生成、审核与发布变成一条可重复执行的工作流。
店铺、人员、收入等固定数据来自指定来源;当天事项由本人补充。
按约定模板生成新文档,并回读检查字段、日期、表格和隐私信息。
一条消息内包含文档链接与完整内容,先让本人查看。
只有收到明确的“确认发布”,才发送到大群或其他私聊对象。
“生成”“私聊审核”“正式发布”是三个不同动作。生成日报不等于获得群发权限;任何对外发布都必须设置单独确认门。
不需要学习编程,但要理解谁在读、谁在发、数据从哪里来。
这一步通常只做一次。每位同事应使用自己的授权或组织统一提供的应用,不能复制他人的密钥和个人 ID。
按公司或官方渠道安装 lark-cli。在终端执行 lark-cli --help,能显示帮助即表示安装成功。
进入飞书开放平台,新建“企业自建应用”,启用机器人能力,并把使用者加入应用可用范围。
发布或安装应用。让使用者打开机器人会话,先给机器人发一条消息,建立可私聊关系。
| 动作 | 使用身份 | 需要什么 | 常见误区 |
|---|---|---|---|
| 读取用户的飞书文档 | --as user | 开发者后台开通 Docs / Drive 对应权限,并由用户完成 OAuth 授权 | 机器人不会自动继承用户的云文档权限 |
| 以机器人名义发消息 | --as bot | im:message:send_as_bot、应用可用范围、私聊关系 | 机器人权限不足时不应该执行用户登录 |
| 发送到群聊 | --as bot | 机器人已加入目标群,且用户明确确认正式发布 | 有群 ID 不代表机器人已经在群里 |
| 读取电子表格或多维表格 | 通常是用户身份 | 按 CLI 返回的缺失权限逐项开通 | 文档里的嵌入表格不一定会自动展开数据行 |
lark-cli config init --new
lark-cli auth login --domain docs --domain drive --no-wait --json
智能体应把返回的验证链接和二维码展示给用户。用户完成授权后,智能体再使用当次返回的 device code 完成登录;不要保存或重复使用旧授权码。
lark-cli auth status --json --verify
密钥应交给 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。
每天都创建一个新的日期文档。生成后必须重新读取文档验证,不能只相信“创建成功”。
逐一读取已确认的数据源,保留原始名称、日期、金额和异常说明。
按规则生成当天的新文档,不覆盖历史日报,不把数据源链接写进日报正文。
检查标题日期、章节、表格行数、合计、隐私字段和本人提供的重点事项。
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,不是截图。
把原生表格序列化成 Markdown 管道表格。
CLI 将 Markdown 包装为飞书 post / md 消息。
飞书客户端把 Markdown 表格显示成可读表格。
| 项目 | 负责人 | 状态 | |-|-|-| | Alpha | 李明 | 进行中 | | Beta | 王芳 | 已完成 |
| 项目 | 负责人 | 状态 |
|---|---|---|
| Alpha | 李明 | 进行中 |
| Beta | 王芳 | 已完成 |
文档原生表格可以直接转成 Markdown。嵌入的 Sheet 或 Base 可能只返回引用信息,智能体必须继续读取其中的单元格,再自行构造 Markdown 管道表格。
私聊审核与正式发布要使用两道独立权限门。没有明确确认,智能体只能修改并重新私聊,不能自行群发。
机器人只发给本人。本人检查文档、数字、表格和表达;有问题就修改、回读、重新审核。
本人明确回复“确认发布到指定群和指定私聊”后,智能体才按确认清单逐一发送。
在我审核日报以后,先向我展示最终发布清单,包括:
- 发送者身份;
- 每一个群聊名称和 chat_id;
- 每一个私聊对象;
- 准备发送的消息格式;
- 是否包含文档链接和完整正文。
只有当我明确回复“确认发布”后,才执行正式发送。
如果我只是说“修改一下”“重新发给我看看”或“确认内容”,都不代表允许发送到大群或其他人员。
每个目标使用独立幂等键。发送完成后回读消息,并汇报成功或失败的目标,不要重复发送成功项。
判断自动化是否可靠,不看它有没有说“完成”,而看它是否能回读并提供证据。
已经熟悉流程后,可以把下面的提示词交给支持飞书 CLI 的智能体,让它分阶段引导部署。
请帮我搭建一套“飞书自动日报”流程,但必须分阶段执行,未经确认不得跳步。
阶段 1:检查飞书 CLI、用户认证、机器人能力和权限。读取文档使用用户身份,发送消息使用机器人身份。不得要求我在聊天中粘贴 App Secret 或访问令牌。
阶段 2:读取我提供的一份已确认日报和所有数据源,分析固定章节、每日变化内容、字段来源、计算校验和保密规则。只输出规则草案,等我确认。
阶段 3:逐项询问并确认日报标题、章节顺序、表格表头、数据源、每日人工输入、缺失值处理、隐私规则和正式接收对象。
阶段 4:在我指定的每日时间提醒我提供当天重点事项,并确认数据源已更新。未收到当天信息或未确认数据源更新时,不得生成和发送。
阶段 5:每天创建全新日期日报,读取最新数据,生成文档后使用 im-markdown 回读,检查日期、章节、表格、合计和敏感信息。
阶段 6:由机器人先私聊发给我一条消息,格式必须是:
日报文档:<新文档链接>
<回读得到的完整 Markdown 正文>
链接后必须是真实空行,不能发送字面量 \n\n。发送使用 --markdown,保证文档原生表格在对话中渲染为表格。发送后回读消息检查表格和链接。
阶段 7:我审核后,只有明确回复“确认发布”才可以发送到我确认的大群和私聊对象。生成日报、确认内容或要求修改都不代表允许正式发布。
整个流程必须使用幂等键防止重复发送,并且任何跨人员或群聊的发送都要先展示目标清单让我确认。