SuperAPI AI 工具集

form-responses

数据与分析

查看项目

更新于 10-15 20:09

技能介绍

用途:查看、导出和分析表单回复。当用户询问已提交数据、需要导出回复或需要回复分析时使用。

主要能力:

  • 查看回复:pnpm action list-responses --form <form-id> [--limit 50],按提交时间倒序显示字段标签与值。
  • 分析洞察:pnpm action response-insights(全部可访问表单)或 pnpm action response-insights --formId <id> --days 30 --limit 300,返回 widget: "data-insights"、按日提交的 chartSeries、近期回复 table 及含总数、采样与截断信息的 summary。原生聊天渲染器应使用该契约,MCP Apps/iframe 仅作外部宿主回退。
  • 表单预览:pnpm action preview-form --formId <form-id>,返回字段、回复数、状态、可见性及“Open editor”操作。
  • 导出:pnpm action export-responses --form <form-id> --output data/export.csv(默认 CSV);加 --format json 导出 JSON。CSV 表头来自字段标签,多选数组值以分号连接。

数据结构:回复存于 responses SQL 表,含 id、formId、data(字段 ID 到值的 JSON 字符串)、submittedAt、ip、submitterEmail、pageUrl、clientSurface。pageUrl 与 clientSurface 为隐藏透传字段,仅受信嵌入转发,直接填写时为空,clientSurface 服务端白名单校验。

分析流程:先用 list-forms 找表单 ID;涉及设置或字段用 preview-form;计数、每日提交与表格数据用 response-insights;仅在需要精确行级检查时用 list-responses。报告需说明结果是精确还是采样,并给出行数与截断情况。

限制:资料未提供权限、配额、错误处理等细节;submitterEmail 可能来自登录会话或受信反馈客户端。相关技能:form-building、actions。