SuperAPI AI 工具集

shopify-admin-agentic-policy-readability

办公与效率

查看项目

更新于 10-15 09:34

技能介绍

用途

在 AI 智能体为购物者完成购买之前,它会检查店铺的政策——比如“能配送到我的地址吗?退货窗口多长?”如果配送、退货等政策缺失、为空或仅以图片/PDF 形式存在,智能体无法回答,信心下降,就会放弃订单或把购物者引向别处。该技能审计店铺政策,确保关键政策以干净、纯文本或 HTML 内容存在,使智能体能阅读并引用。修复 shipping-policy-readable 和 returns-policy-readable 相关问题。

主要能力

  • 查询店铺现有政策(类型、正文、URL),识别哪些目标政策缺失、空或仅含图片/链接。
  • 对每项政策分类为 OK / missing / thin / image-only,并在 audit 模式下输出报告。
  • 在 apply 模式下,从 bodies_dir 加载对应 <TYPE>.html 文件,对每个缺口生成前后对比预览,并在非 dry_run 时通过 shopPolicyUpdate 变更更新政策。
  • 支持对 REFUND_POLICY、SHIPPING_POLICY、PRIVACY_POLICY、TERMS_OF_SERVICE 等政策类型进行审计与更新。

使用方式

前置要求:已认证的 Shopify CLI 会话(shopify auth login --store <domain>),需要 API 权限范围 read_legal_policies(或 read_online_store_pages)与 write_legal_policies。

通用参数包括:store(必填,店铺域名)、format(可选,human 或 json,默认为 human)、dry_run(可选,默认为 true,即预览而不写入)。技能特定参数包括:policies(逗号分隔的政策类型列表,默认 REFUND_POLICY,SHIPPING_POLICY)、mode(audit 只报告缺口,或 apply 写入提供的正文,默认 audit)、bodies_dir(当 mode: apply 时,存放 <POLICY_TYPE>.html 文件的目录,作为真实来源)。

工作流包括查询店铺政策、分类(无 API 计算)、以及在 apply 模式下执行 shopPolicyUpdate 变更(仅在 mode: apply 且非 dry_run 时)。技能必须按阶段输出会话追踪信息,包括开始时的横幅、每步后的操作摘要,以及完成时的结果总结(human 或 json 格式)。

适用场景

适用于 Shopify 店铺运营方或开发者,希望确保其配送、退货、退款、隐私和服务条款政策能被 AI 智能体正确读取和引用,以支持智能体回答购物者问题并促成交易。特别适合需要审计现有政策可读性、发现纯图片或空政策并进行修复的场景。

限制

  • 该技能不会自动生成法律文本。在 mode: apply 下,它只写入通过 bodies_dir 提供的正文。
  • 默认模式为 audit + dry_run: true,不会实际写入店铺政策。
  • 更新政策为具有法律约束力的内容,建议由法律/运营人员审核每一份正文后再执行 mode: apply。
  • 如果缺少 write_legal_policies 权限,应保持在 audit 模式并报告缺口供手动填写。
  • 如果 bodies_dir 缺少某个政策类型的文件,则跳过该政策并保留在缺口报告中。
  • 其他未在资料中明确提及的功能、平台或效果暂未提供。