SuperAPI AI 工具集

funnels

营销与增长

查看项目

更新于 10-15 10:56

技能介绍

用途

该技能用于把商家的自然语言需求转化为一份完整、可审阅的 Lexsis 店铺漏斗定义。漏斗是可复用的购物者旅程逻辑,不是页面;运行本技能时不应编辑页面源码,也不应添加 FunnelRuntime island。典型用途包括产品查找测验(product-finder quizzes)和分支式导购流程。

主要能力

  • 读取漏斗能力:通过 lexsis_capture action funnel_capabilities 获取权威的 schema 版本、节点类型、触发器、结果和激活可用性。
  • 使用后端模板:通过 lexsis_capture actions funnel_templates 和 funnel_template 列出并读取最接近的模板,以减少不必要的自定义工作,但不创建空壳。
  • 解析真实目标:使用 lexsis_catalog 和 lexsis_pages 在把标识符放入结果之前解析真实商品、集合或页面目标;不虚构 ID、价格、奖励、折扣、商品关系或目标。
  • 澄清关键决策:仅澄清会改变旅程的缺失决策,包括受众、目标、问题、分支逻辑、每条路径的结果、期望呈现方式和最终入口点。
  • 创建与更新草稿:通过 lexsis_drafts actions funnel_create 和 funnel_update 创建或更新完整的 version-2 草稿;更新时需读取草稿并把其确切 revision 作为 expected_revision 传入,替换完整定义而非基于过期状态打补丁。
  • 校验与预览:用 get_funnel 重新读取,运行 validate_funnel 并修复所有错误;用 preview_funnel 创建签名预览,通过宿主浏览器能力打开,并在移动端和桌面端宽度下走通每条可达路径。

使用方式

  1. 读取 funnel_capabilities,以返回的 schema 版本、节点类型、触发器、结果和激活可用性为准。
  2. 列出后端拥有的模板;当模板能减少不必要自定义工作时读取最接近的模板,不创建空壳。
  3. 仅澄清会改变旅程的缺失决策:受众、目标、问题、分支逻辑、每条路径的结果、期望呈现方式、最终入口点。
  4. 解析每个引用的商品、集合或页面;不虚构 ID、价格、奖励、折扣、商品关系或目标。
  5. 在变更前呈现简洁的漏斗计划:入口触发器与模态/内联呈现;有序问题与答案选项;分支条件与默认路径;每条可达路径的终端结果与预期结果;未解决的激活工作。
  6. 商家批准计划后,用 lexsis_drafts action funnel_create 创建一个完整的 version-2 草稿。
  7. 用 get_funnel 重新读取,运行 validate_funnel 并修复所有错误;警告必须报告,仅当涉及后续发布或激活步骤时才可保留。
  8. 用 preview_funnel 创建签名预览,通过宿主浏览器能力打开,并在移动端和桌面端宽度下走通每条可达路径。预览答案是本地的,不能证明捕获、分析、挂载或实时运行时行为。
  9. 修订时再次读取草稿,并把其确切 revision 作为 expected_revision 传给 funnel_update;替换完整定义,不要基于过期状态修补孤立步骤。

店铺解析顺序:显式提供的工作区/页面 URL、页面绑定、已保存的店铺选择,或 /setup 保存的无歧义默认值。若仍可能存在多个店铺,请商家选择。绝不自动调用 /setup。

遇到不熟悉的参数 schema 时用 lexsis_discover 解析。空的发现结果不是漏斗故障;应调用文档化的路由动作并报告其具体错误。

适用场景

  • 产品查找测验。
  • 分支式导购旅程。
  • 需要按受众、目标、问题、分支逻辑和结果来定义可复用购物者旅程的场景。

限制与安全边界

  • 草稿创建和更新是可逆写入,需要正常的 lexsis_drafts 批准。
  • 当前 MCP 契约中没有漏斗发布、挂载或激活动作;不要用页面编辑或 lexsis_live_ops 替代。
  • 专用漏斗 URL 将是一个带内联漏斗放置的普通 Lexsis 页面,不由本技能创建。
  • 现有按钮、插入按钮、自动和自定义事件触发器是供后续放置激活使用的定义契约;在草稿中记录触发器不会使其生效。
  • 绝不使用任意 JavaScript。当存在稳定的页面块或动作 ID 时,不要使用 CSS 选择器。
  • 在激活和运行时执行分别可用并验证之前,绝不声称某个结果会导航、加入购物车、启动结账、捕获线索或记录分析。

返回内容

报告漏斗 ID、店铺、revision、定义摘要、校验错误与警告、预览 URL 与过期时间、已走通的路径,以及页面放置、激活、结果和发布仍确切需要的工作。