SuperAPI AI 工具集

interactive-input

办公与效率

查看项目

更新于 10-15 22:09

技能介绍

用途:在聊天回复中直接嵌入交互式 UI 组件,如单选按钮、复选框、文本字段和开关。兼容的客户端会将其渲染为原生界面元素,其他客户端则回退显示为可读的 JSON 代码块。

适用场景:测验与练习(单选、多选、填空)、调查与投票、结构化数据收集(表单),以及任何需要用户从选项中选择或提供结构化输入的场景。

使用方式:在普通 Markdown 回复中,用 ```interactive 代码围栏包裹一个 JSON 块即可,同一消息内可自由混排普通文本与交互块。完整 schema 规范见 references/schema.md。

规则要点:每个交互块必须有唯一的 id 字段,card.body 至少包含一个元素,并在 card.actions 中加入 Action.Submit 以便用户提交。选择题建议用 "style": "expanded" 展示全部选项;选项较多时用 "style": "compact" 下拉;多选题在 Input.ChoiceSet 上设置 "isMultiSelect": true。body 中第一个 TextBlock 会作为提交响应中的题目标签。一条消息可包含多个交互块(如整套测验)。必须使用 interactive 围栏,不能用 json;JSON 需紧凑有效,不能有注释或尾随逗号。

限制:渲染效果取决于客户端是否兼容,不兼容时仅显示 JSON 代码块;其余功能、收费与平台信息暂未提供。