原创教程公开来源整理
飞书机器人消息分流:分类后生成卡片与待审草稿
理解事件到卡片的集成骨架,并保留人工发送。
适用场景把飞书群消息整理成类型、紧急度、互动卡片与待审草稿
飞书群里用机器人收集消息,经 Jev 判断类型与紧急度,推送互动卡片,并生成待审草稿。适合值班与内部支持;默认不自动对外发送。本站原创,非飞书官方实测。
来源 · JevLog 原创 · 本站原创
2026-09-22 新增飞书工具场景教程;判断≠自动回帖。
背景 / 问题
Section titled “背景 / 问题”内部支持群消息密度高:权限申请、故障申告、「帮我看看」混在一起。值班需要卡片化摘要与草稿,而不是让机器人直接 @所有人。
决策顺序:事件进站 → Jev 选类型 → 渲染飞书消息卡片 → 草稿进审核。发送/回帖默认手动。
- 飞书开放平台测试企业与机器人(按官方文档创建);本文不提供违规抓取。
- 事件订阅权限最小化;先在测试群验证。

群聊消息进入分流和待审草稿,由人工确认后处理。AI 概念插画,非平台截图。
1. 用官方事件订阅接到测试群
Section titled “1. 用官方事件订阅接到测试群”按飞书文档配置机器人与事件加密。先打印原始事件到日志,确认能拿到 text、sender、chat_id。不要在这一步调用模型。
2. Jev 做类型决策(有限标签)
Section titled “2. Jev 做类型决策(有限标签)”把正文送进 System One:type Choice + urgency Score + needs_human 复核概率。类型示例:access、incident、howto、noise。
from typesafe_sdk import Choice, Noul, Score, TypeSafeClient
text = "生产环境登录 502,影响下单"
with TypeSafeClient() as client: res = client.system_one( state={"message": text}, questions={ "type": Choice( instructions="Route an internal Feishu support message.", criteria={ "incident": "Service degradation / outage", "access": "Permission or account access", "howto": "How-to / documentation", "noise": "Chit-chat", }, ), "needs_human": Noul(instructions="Needs on-call acknowledgment?"), "urgency": Score(instructions="1-5 urgency", criteria=["低", "中", "高"]), }, )print({"type": res.choices["type"].choice, "urgency_score": res.scores["urgency"].score, "human_review_probability": res.nouls["needs_human"].noul})3. 渲染消息卡片 + 草稿,不自动回帖
Section titled “3. 渲染消息卡片 + 草稿,不自动回帖”用飞书互动卡片展示:类型、紧急度、建议处理人、草稿。按钮只做「确认发送 / 转交 / 忽略」。确认前不得调用回复 API。
4. 验收:故障类必须可升级,水聊可一键忽略
Section titled “4. 验收:故障类必须可升级,水聊可一键忽略”三条样例:502 故障、权限申请、闲聊。检查卡片字段齐全、忽略路径不产生回复、密钥不在日志中。
你能在测试企业跑通:飞书事件 → Jev 类型决策 → 卡片 → 人工发送草稿。
- 测试群内卡片字段含类型、紧急度、草稿。
- 默认不调用回复 API;确认按钮可审计。
- 忽略路径无副作用。
一定要互动卡片吗?
Section titled “一定要互动卡片吗?”不是。卡片利于值班协作;也可先 Webhook 文本,但同样要人工确认发送。