SuperAPI AI 工具集

widget-forms

办公与效率

查看项目

更新于 10-13 15:41

技能介绍

用途

Widget Forms 用于让智能体以对话内表单的方式向用户收集结构化输入。它要求使用表单工具而非手写标记,由编辑器聊天将表单渲染成交互式卡片,并返回用户的结构化答案。

主要能力

该技能通过调用 ask_followup_questions 实现,支持多种字段映射:原生 <form-single> 映射为 { type: "single", variant: "default" };<form-multi> 映射为 { type: "multi", variant: "default" };<form-text> / <form-textarea> 映射为 { type: "text" };<form-visual> 映射为 { type: "single", variant: "visual" };语音试听卡片映射为 { type: "single", variant: "voice" };原生 start-scenario 卡片映射为 { type: "single", variant: "scenario" }。工具最多支持 12 个字段。

使用方式

需在调用工具前规划好整个问卷,只发送一次最终表单,而不是先发一个试验表单再发修正表单。如果用户希望有更多问题,应在首次调用前把相关问题合并为组合字段。调用 ask_followup_questions 之后,应停止该轮次,等待提交的答案出现在聊天中;在用户的选择出现在对话之前,不得应用选择、创建素材或依据推荐继续规划。

表单文案(title、prompt、fields[].label、submitLabel、messagePrefix)应像 OpenChatCut 作为一位称职的视频创作伙伴在邀请用户描述需求,而非僵硬问卷:温暖、开放、面向行动,简短易扫读,如实描述能力,不承诺未支持的能力或保证结果,沿用用户语言和既定产品术语。

对于普通单选和多选卡片(variant: "default"),选项保持仅标签;仅在用户无法凭标签区分时添加逐项描述。描述主要用于语音卡片,视觉风格卡片通常只用预览加标签。当允许列表外答案时,添加一个 id 为 "other" 的显式选项,组件会在选中时将其转为文本输入,可用 otherPlaceholder 设置占位提示。

对于视觉卡片,preview 使用真实图片 URL 或 data image URL;设计风格目录选项需先调用 manage_design_style 并 action: "list",再把返回的预设映射为 { id: preset.presetId, label: preset.name },不得硬编码目录预设 id。

对于语音卡片,使用 audioUrl 指定示例文件,优先使用文档化示例路径(如 /voice-samples/doubao-liuchang.mp3)或公开 HTTPS URL,不要传 localhost 示例 URL;用户可见描述保持提供方中立,按原生试听 UI 的方式描述声音(性别/年龄段/语气/用途),选项 id 等于 submit_voice 所需的提供方语音 id。

对于原生 start-scenario 卡片,当用户应选择启动哪个 OpenChatCut 视频工作流时使用,需恰为一个 variant: "scenario" 的单选字段,使用给定规范 id(talking-head、motion-graphics、long-video-to-shorts、app-promo、ai-cinematic-short-film、explainer,以及 other),并提供用户语言的标签;英文、中文、西班牙文标签/描述/起始提示已内置,其他语言需忠实翻译,不提供自定义 preview 或 audioUrl。

表单中不要包含文件上传类问题。如果任务确实需要源媒体而项目/聊天中还没有,应单独请用户在编辑器中上传文件(拖拽、上传按钮或粘贴到聊天输入框);仅当下一步编辑依赖缺失媒体时才请求上传。

适用场景

适用于智能体需要向用户询问结构化输入的场景,例如单选、多选、文本字段、风格选择或语音选择。典型用途包括早期规划或创意采集表单,以及让用户选择要启动的视频工作流场景(如口播剪辑、MG 动画、长视频转短视频、产品/应用宣传、AI 短片、解说视频)。

限制

ask_followup_questions 仅用于结构化答案,不支持原生自定义 HTML、时间线参数桥接、编辑器条目选择或文件上传字段。对于智能体运行时已持有或直接附加到聊天的文件,媒体导入工作流仍然有效;对于用户想直接放入项目的文件,需请其使用 OpenChatCut 编辑器上传 UI。文档未提供收费、价格、平台支持范围等进一步信息。