SuperAPI AI 工具集

creating-surveys

营销与增长

查看项目

更新于 10-16 03:45

技能介绍

用途:通过 MCP 在 PostHog 中创建并发布问卷,无需打开问卷编辑器。根据用户目标推断名称、用途和问题,仅追问会影响受众或投放方式的缺失信息。

主要能力与类型选择:支持应用内弹窗(popover,需启用 surveys 的 PostHog SDK)、常驻反馈按钮(widget,需 SDK 支持与组件配置)、可分享的托管表单(external_survey,仅托管链接,无应用内定向)、应用代码自建表单(api,由应用渲染问题并采集事件)。问题建议 1 至 3 个;NPS/CSAT 用评分加可选开放题,选择题至少两个选项。问题类型、量表、分支和翻译的 JSON 结构应查看当前工具 schema,示例中提供最小起点。

受众与外观:用条件设置 URL、事件、设备和关联 flag 变体;使用前解析已有事件与 flag 标识。URL 条件不定义人群或分群受众。人群/分群定向使用 targeting_flag_filters.groups[].properties[],组间为或、组内属性为且。含行为过滤的分群不能直接用于问卷定向,需说明限制并提供静态快照或等效受众,且需先取得同意,不得丢弃规则或扩大受众。托管表单不使用应用内展示条件或定向 flag。除非需要定制,否则省略外观;whiteLabel: true 需企业版白标权益,不能因请求自定义颜色而推断。surveyPopupDelaySeconds 必须非负。未用字段应省略,不要用 null 代替。

创建与审核:调用 posthog:survey-create,草稿省略 start_date;若用户已要求立即发布,则继续就绪检查并发布,不再重复请求同一批准。保留返回的 survey id,后续工具用 id 而非问题 ID、flag ID 或名称。用 posthog:survey-get 读取已保存问卷,与用户核对问题、类型、受众、排期、响应上限和品牌,始终包含返回的 _posthogUrl。修改时先获取已保存问卷再调用 posthog:survey-update,保留未变字段和已有问题 ID。

发布与验证:发布前确认用户已授权、问卷未归档且 end_date 不在过去;应用内投放需项目启用 surveys 且 SDK 支持所需功能,事件触发问卷需应用中存在实际触发事件;api 问卷需应用代码实现展示与事件采集。用 posthog:survey-launch 发布并核对返回状态,报告草稿、已发布或待 SDK/设置步骤。托管表单返回可验证的公开表单 URL,_posthogUrl 是管理页而非受访者链接。用 posthog:survey-stats 或 posthog:surveys-responses-list 查看后续活动,刚发布零响应不代表投放失败。

限制与错误恢复:创建非幂等,超时或结果不确定时先用 posthog:surveys-get-all 查找可能已存在的草稿,名称相同不足以证明是同一问卷。重试前阅读 validation 字段和原因;外观失败检查品牌权益与字段,定向失败检查分群支持与规则结构,纠正时保留请求行为并说明影响受众或品牌的变更。