发送飞书互动卡片(Card JSON 2.0)。当需要让飞书用户填写表单、做选择、确认操作、或查看 结构化数据时,发送交互卡片代替纯文字问答。需要 feishu-cards 插件工具: feishu_send_card / feishu_send_form / feishu_update_card。
发卡片 而非纯文字的情况:
纯文字:简单回复、解释说明、无需交互时,无需发卡片。
| 工具 | 用途 | 主要参数 |
|---|---|---|
feishu_send_card | 发送卡片消息 | chat_id / user_id,card(JSON字符串) |
feishu_send_form | 发送含表单容器的卡片 | 同上,card 内须含 form 组件 |
feishu_update_card | 更新已发卡片内容 | token(回调中获取),card(新JSON) |
{
"schema": "2.0",
"config": { ... },
"card_link": { "url": "..." },
"header": { ... },
"body": { "elements": [ ... ] }
}
| 字段 | 默认值 | 说明 |
|---|---|---|
streaming_mode | false | 流式更新模式 |
enable_forward | true | 是否可转发 |
update_multi | true | 共享卡片(JSON 2.0 仅支持 true) |
width_mode | default(600px) | compact(400px) / fill(撑满) |
enable_forward_interaction | false | 转发后是否仍可交互 |
summary.content | - | 自定义聊天栏预览文案 |
| 字段 | 说明 | 枚举/格式 |
|---|---|---|
title.tag | 标题文本类型 | plain_text / lark_md |
title.content | 主标题内容 | 字符串,最多4行 |
subtitle.content | 副标题内容 | 字符串,最多1行 |
template | 标题栏颜色 | blue wathet turquoise green yellow orange red carmine violet purple indigo grey default |
icon.tag | 图标类型 | standard_icon / custom_icon |
icon.token | 图标库token | 如 chat_outlined |
text_tag_list[].color | 后缀标签颜色 | neutral blue turquoise lime orange violet indigo wathet green yellow red purple carmine |
padding | 标题内边距 | 默认 12px |
| 字段 | 默认值 | 说明 |
|---|---|---|
direction | vertical | vertical / horizontal |
padding | - | 如 12px 12px |
horizontal_spacing | - | small(4px) medium(8px) large(12px) extra_large(16px) 或 Npx |
horizontal_align | left | left / center / right |
vertical_spacing | - | 同 horizontal_spacing |
vertical_align | top | top / center / bottom |
elements | [] | 组件数组 |