文档Bot 与群组

Bot 与群组

消息、附件与运行卡

发送图片、文件和语音,查看运行过程,停止任务或领取结果。

使用指南6 分钟
更新于 2026-11-04

Bot 在已连接的飞书群里接收任务。最稳妥的开始方式是在群主区明确 @ Bot,并说清要它做什么;选择「独立话题」(多会话)的群会为这条消息开新话题,后续在话题内继续。是否可以不 @,取决于群的聊天方式和「免 @」设置;智能模式还会判断该不该接话。

发送文字、图片、文件与语音

你发送的内容Bot 如何处理遇到问题时
文字或富文本把消息正文交给当前会话。引用回复时,会尽力把被引用消息一并交给它。先确认群已连接、Bot 已启用,并明确 @ 到这位 Bot;没有回复时查看「诊断」。
图片读取直接发送的图片和富文本中的图片,作为图像输入交给 Provider;单条消息最多处理 9 张。图片读不到时重发原图,或用文字描述关键信息。
文件附件下载直接发送的附件,告诉 Provider 文件名和可读取的位置;单条消息最多 9 个,每个不超过 50 MB。能否读取还受 Provider 和群权限限制;Codex 的受限权限档不能读取该临时附件。若附件下载失败或 Provider 读不到,重发、缩小文件,或粘贴文字;处理文件前先核对执行权限。
语音开启「语音转文字」且识别可用时,先转成文字再交给 Provider;转写结果会随回复展示。未转写时会尝试把原音频交给 Provider,并说明转写失败。听写不准或读不到音频时,改发文字;超过 20 MB 的语音不会转写。
合并转发可读取转发消息中的文字;其中的图片会尽力获取。飞书可能拒绝获取合并转发子消息里的图片或文件。需要 Bot 分析附件时,请把原文件或原图直接发到群里。

发送附件时,最好在同一条消息里说明任务,例如“请总结这份文件的三个结论”。文件下载与 Provider 读取都需要时间;文件很大时先确认它在上述限制内。

看运行卡、停止与重试

Bot 开始处理后,会在群里更新运行卡,显示正在进行的步骤和输出。任务结束后,卡片显示最终结果。运行卡上的「停止生成」可中止当前运行;只有任务发起人或 Bot 管理员能操作停止。若卡片显示可重试,先核对这一轮是否已产生副作用,再点「重试」;网络瞬断也可能由 Bot 自动重试。

当这位 Bot 的并发运行名额已满,Bot 会先显示「排队中」卡片和排队位置;多个群共用这位 Bot 的并发名额,上限在该 Bot 的「设置 → 运行上限 → 同时处理的任务」调整。在开始前可点「取消排队」。若 Bot 在排队或运行期间停止,未执行的消息会提示重发。要确认是否真的完成,请看最终卡片,而不是只看正在更新的文字。

运行中补充一句话

在同一会话运行时继续发消息,群设置里的「运行中来了消息」会决定处理方式:「插话」尝试把补充交给当前轮,适合纠正方向;「排队」等当前轮结束后再处理,适合下一件事。若当前 Provider 或这次运行无法接收插话,消息会按实际状态进入后续处理。发送后看 Bot 的回执和运行卡,避免因未见即时变化而重复发同一任务。

正在运行 /goal 自治目标的会话不接普通插话或排队任务。要停止目标,用运行卡上的「终止」;想让当前轮完成后结束,用「结束目标」。目标结束后再发新的任务。

沟通方式页中的聊天方式可选独立话题、连续交谈和智能;群内响应单独控制免@;运行中来了消息可选插话或排队。
沟通方式 · 三项设置分别影响上下文、触发和运行中消息点击放大
  1. 聊天方式独立话题对应多会话,连续交谈对应单会话;智能由 Bot 判断何时、在哪里回复。
  2. 群内响应决定不 @ 是否也能发起任务,不会替你改变聊天方式或权限。
  3. 运行中的新消息Codex 可插话或排队;Claude 使用排队。以当前 Provider 显示的选项为准。

领取 Bot 生成的文件

Bot 在回复里引用可领取的本地文件时,点击文件名称,Bot 会把它作为飞书附件发送到当前会话;发送成功后,该入口会指向附件消息。单个附件须是可读取的普通文件,非空且不超过 30 MB。

只有本群允许使用 Bot 的成员可以领取。领取时还会重新检查群当前的执行权限:如果文件不在当前允许访问的范围内、已移动或已改变,领取会被拒绝。看到「上次发送结果未确认」时先检查会话里有没有附件,再请 Bot 重新引用文件,避免重复发送。

在云文档评论里 @ Bot

拥有者或管理员可以在受支持的飞书文档评论中 @ Bot 并写明问题。Bot 会读取该条评论及其引用内容,在同一评论串里回复;同一评论串中的后续 @ 会接着此前会话。支持文档、电子表格和多维表格的评论。评论回复不是群运行卡,处理时可能只看到飞书的“正在输入”反馈。

评论任务使用单独的「云文档评论」配置,包括 Provider、模型、权限与回复规则,不直接沿用某个群的聊天设置。Bot 需要能读取评论且有对应飞书权限;知识库里的文档还可能需要知识库权限。没有回复时,先确认是管理员本人 @ 了 Bot、文档类型受支持、评论里有实际问题,再查看 Bot 的「诊断」和飞书权限。

私聊的用途

当前版本中,私聊 Bot 会打开管理卡片,供主人和管理员查看或调整设置;普通任务请发到已连接的群。群内不能用 /settings 改设置,相关入口在私聊管理卡片、Vonvon 客户端或命令行。