智能体表单外链
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_e6037293/agent-intake-form-link。
技能介绍
要解决什么问题
用户经常用自然语言丢给智能体一个任务,但关键字段往往缺失:日期、金额、选项、文件路径等。若全靠多轮闲聊补齐,容易漏项、歧义,也不利于后续用强类型值继续执行。另一方面,很多 Agent 平台并没有内置的「表单卡片」渲染能力,硬要在对话里堆一长串问题也不体面。
本技能面向的是:在信息不足以推进下一步时,用结构化采集补齐缺口;信息已够则照常执行,不要为每个任务都造表单。
技能如何工作
核心是一条可停等的 intake 流程:
- 阅读用户任务,判断是否可直接执行。
- 若缺信息,只列出推进下一步所必需的字段,设计表单 schema(
kind、id、header、label等;single/multi的选项以value为准)。 - 为每次表单生成稳定的
interactionId(如form_expense_001);多步时可带parentInteractionId与step。 - 默认 copy-back 模式:生成自包含的外部 HTML 表单页(可基于
assets/form-template.html注入 schema),用户填写后页面产出 JSON,复制回对话;无后端即可闭环。仅在环境明确提供提交端点时才用 backend 模式。 - 发出链接或本地路径后停止并等待;下一条消息先解析
form_submissionJSON,校验interactionId与status(submitted/cancelled),以values为权威数据继续原任务。
字段类型覆盖 text、textarea、email、url、number、date、datetime、file 等;首表建议 3~8 个字段,优先 typed 字段与已知选项,避免无谓收集敏感信息。
适用边界与注意点
- 单个小澄清:只需一句追问时,用普通对话即可,不必开表单。
- copy-back 下的文件字段:不能假设能上传原始文件;适合文件名、本地路径、URL 或平台文件引用。
- 提交后做轻量校验(必填、
single/multi选项、邮箱/URL/数字范围等);失败可聊天补全或生成更小的跟进表单。 - 若无法生成外链页面,可回退为同 schema 的对话式结构化采集与相同解析规则。
使用场景
- 用户只说「帮我做费用报销」,未提供金额、发生日期和费用类别时,智能体生成外链表单补齐字段,用户粘贴提交 JSON 后继续生成报销说明或草稿。
- 部署任务描述含糊(环境、域名、镜像标签缺失),需要一次性收集多项配置时,用带 `single`/`multi` 选项的 intake 表单避免来回猜选项。
- 项目立项需求散落在聊天里,需要固定字段(截止日期、负责人邮箱、优先级选项)时,生成 3~8 项短表,提交后以 `values` 驱动后续文档或工单步骤。
- 平台没有原生表单卡片组件,但仍要在对话中暂停等待用户填完结构化信息时,采用自包含 HTML 页 + copy-back 模式完成闭环。
适合人员
- 在自研 Agent 里编排任务流、需要在信息不足时暂停并采集强类型字段的后端或平台工程师
- 为企业内报销、立项、变更申请类对话机器人维护 intake 流程、且宿主不支持表单卡片的产品或运维同学
- 用 Claude/Cursor 等环境写技能、希望用外链页替代长串追问的独立技能作者
- 对接客户 onboarding 或实施清单、要把「缺哪些字段才继续」写成可复用 schema 的解决方案顾问