logo
开发者文档
搜索
采集用户表单

采集用户表单

当需要收集多个结构化信息(姓名 + 联系方式 + 订单号……)时,模型可以在当前渠道原生渲染出一张表单发给用户,而不是让用户在聊天里自由打字(容易含糊,或几项挤成一句)。

核心行为:表单发出即完成,不等答案

模型发出表单后立即结束本轮,不会挂起等待用户填写。它通常会紧接着说一句「请填写上方表单」。用户提交的内容会作为下一条新消息重新进入对话。

所以:表单发出后本轮就结束了,用户填完提交才触发新一轮——这是设计,不是没反应。

出现前提与字段能力

  • 采集表单只在当前渠道支持原生表单时才对模型出现;不支持的渠道,模型改为纯文本一问一项地收集。
  • 每张表单最多 10 个字段,每个选择字段最多 10 个选项,超出会被截断。
  • 附件字段:可以让用户上传图片、发票、证件等(可设允许的文件类型,以及数量 1–9 个)。
  • 表单的标题和说明由模型按对话语言即时生成,不是后台预设,因此不同语言下文案会不同,也无法在后台「改表单文案」
  • 若希望控制表单触发时机,可在身份提示中用@指令呼出表单采集工具,增加何时发送表单,发送表单字段的控制提示词。

渠道差异

渠道 表单体验
Web 家族(网站 / 分享页 / 嵌入 / Widget / 调试) 聊天里直接出多字段表单卡
LiveDesk 发送原生表单
Telegram、LiveChat 点按钮打开托管表单页填写
WhatsApp 及其它未适配渠道 文字降级:模型改纯文本一问一项收集
  • 目前所有渠道都是整表一次填完,没有「逐字段」体验。
  • 渠道不支持表单时,模型会自动文字降级,绝不会发一个打不开的死链。

附件排查

  • 客户上传了图 / 文件,但智能体读不到内容:先确认智能体的多模态输入设置已开启对应类别(图片 / 文档等),并确认附件字段允许的类型覆盖了它。否则附件只会以链接形式进入,模型不会真正识图 / 读文件。
  • Telegram / LiveChat 托管页:请尽快在弹出的表单页提交(正常在秒级完成);间隔太久再提交可能导致附件按纯文本处理。