Agent Skills
返回列表
飞书交互按钮卡片

飞书交互按钮卡片

办公效率 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_a5827f21/feishubutton。

技能介绍

解决的问题

当 Hermes Agent 在飞书里只发送文本时，审批、确认、任务反馈等场景会比较弱：用户看不到可点击的操作入口，后端也很难区分用户选了哪个按钮。

如何工作

这个技能把飞书交互卡片封装成可复用的 Python 模块：

  • approval.py 提供审批流程：send_exec_approval() 发送带按钮的审批卡片，handle_card_action() 处理按钮回调，update_approval_card() 在点击后更新卡片状态。
  • builder.py 负责卡片构建：build_streaming_pre_answer_card() 生成流式回答卡片，build_complete_card() 生成最终卡片，split_reasoning_text() 从响应中提取推理文本。
  • cardkit.py 处理低层发送与更新：send_interactive_card() 发送交互卡片，patch_interactive_card() 更新已有卡片。

飞书按钮通常使用 primary、default、danger 三种类型，分别适合主操作、次操作和危险操作；按钮的 value 会在点击时回传给后端，用来区分具体动作。

适用边界

它面向 Feishu / Lark 平台，不是通用消息按钮方案。Discord、Telegram、Slack 需要各自的消息组件格式。该技能依赖 Python 3.11+ 和 hermes_feishu_plugin，并在 Hermes Agent 的技能目录中加载。

使用场景

  • Hermes Agent 在飞书里请求用户确认执行危险命令，需要发送带“同意/拒绝”按钮的审批卡片。
  • 用户点击按钮后，后端根据 value 回调更新同一张卡片为“已批准”或“已拒绝”。
  • Agent 输出流式回答时，先用占位卡片展示，再 patch 成最终结果卡片。
  • 在飞书群聊中让用户选择 primary/default/danger 按钮来触发不同任务分支。

适合人员

  • 维护 Hermes Agent 飞书通道的 Python 工程师，想给 Agent 回复加可点击审批按钮。
  • 在飞书群中接入 AI 助手的后端开发者，需要处理按钮回调并更新卡片状态。
  • 做内部审批流集成的应用工程师，希望把执行确认、拒绝、危险操作做成飞书卡片。
  • 负责 Agent 对话体验的产品工程师，需要把流式回答和最终结果以可更新卡片呈现。