Shopify AI Support

Shopify AI Support 在你的店铺上放一个聊天窗口，全天候回答顾客。每个回答都来自三个来源：

Shopify 实时数据：商品搜索、商品与变体详情、顾客所在市场的当前价格与库存，以及你的店铺政策和 FAQ。只需填写店铺域名，不需要任何 API 令牌。
你的页面：你已经发布的 FAQ、政策、品牌介绍或导购页面，在问题需要时读取。
你的要求：你用自己的话写下它该怎么帮顾客 —— 语气、推荐方式、订单问题该引导到哪里。

它用顾客提问的语言回答，只给出店铺上真实存在的链接。它看不到订单、购物车或账户，顾客也不会接触到你的工作区。

开始之前

一家 Shopify 店铺，主题店或 headless/Hydrogen 店面都可以。不需要在 Shopify 后台安装 App。
Gosper 额度。顾客消息由你的默认 AI 模型回答，费用从你的额度中扣除。

1. 建立一个助手

在 Gatekeepers 页面开通 Shopify AI Support。
打开侧栏 Apps 里的 AI Support，点 New assistant。
填写基本信息，然后点 Create：
- Store name：助手和聊天窗口标题对你店铺的称呼；
- Support email：它帮不上忙时，引导顾客联系的邮箱；
- Shopify store：你的 your-store.myshopify.com 域名（即使顾客用的是自定义域名，这里也填 .myshopify.com 的那个）；
- Allowed websites：允许运行聊天窗口的站点，精确匹配，一行一个，例如 https://acme.com。顾客会用到的域名都要列上，比如自定义域名和 https://acme.myshopify.com 两个都填。其他站点的请求一律拒绝。测试时可以填 http://localhost。

只填这些，助手就已经能依据 Shopify 回答商品、价格、库存和政策问题。

2. 告诉它知道什么

Assistant 部分是一个条目列表，按需添加，然后点 Save changes。

条目	字段	用来写什么
Text	Title、Content	你的要求和事实：它的角色与语气、怎么推荐、当前促销、订单和退款问题引导到哪里。助手会遵照执行。
Web page	URL、Page summary	问题需要时它去读的页面：FAQ、配送与退换、保修、尺码表、品牌故事。最多 8 个公开的 HTTPS 页面，HTML、Markdown 或纯文本均可。

助手根据 Page summary 判断什么时候打开这个页面，所以要写清页面里有什么，例如“配送、退换与保修 FAQ”。顾客看不到它。
页面的修改大约一分钟内就会被助手读到（另加你网站自身的缓存时间）。内容不会被复制进 Gosper，只需维护页面本身。
如果店铺已经有一份涵盖全部内容的文档（比如 llms.txt 或帮助中心导出），添加这一个页面就够了。
所有 Text 条目合计上限 64 KB。写摘要即可，整页内容请改用 Web page 条目。
在 Custom message for when it can’t answer 里，可以写下无法回答时顾客看到的话，比如附上你的联系页面链接。它会原样显示（最多 500 字符）。留空则显示一句带有你客服邮箱的默认提示。

页面内容只作为参考资料，不能改变助手的行为；只有你的 Text 条目可以。价格和库存始终以 Shopify 为准，不取自页面。

要求示例

下面这样一个 Text 条目适用于大多数店铺，按你的情况修改：

你帮助顾客挑选合适的商品，并找到正确的页面。

回答简洁、友好。推荐商品时，结合预算和用途给出 2–4 个选项，各附一句理由。
缺少关键信息时，先问一个简短的问题。

订单、退货和退款问题，引导到 /pages/contact。
欧盟境内订单满 €100 包邮。
不要承诺具体送达日期，引用配送页面上的常规时效。

3. 设置外观

在 Appearance 里上传 logo（PNG、JPEG、WebP 或 SVG，选好即保存），并选择主题色 Color。聊天窗口标题会显示你的 logo 和店铺名。

这些只能在 Gosper 里设置。页面上的代码片段只携带 key，所以被复制或改动的片段无法让聊天窗口冒充别的店铺。

4. 向顾客开放

点 Open to shoppers。Gosper 会请你确认由哪个模型回答、费用从你的额度中扣除。确认之前，助手状态显示为 Waiting for approval。

确认后，Install 部分会显示嵌入代码。

5. 粘贴代码

复制嵌入代码，粘贴到店面 </body> 之前：

主题店：Online Store → Themes → Edit code → layout/theme.liquid。
Hydrogen：根布局文件。

<script src="https://service.gosper.ai/shopify-ai-support/v1/embed.js" data-key="sas_…" async></script>

这个 key 本来就是公开的：它出现在页面源码里，只标识是哪个助手，不代表任何权限。请求仍然必须来自允许的站点，并通过限流。
这段脚本只是一个很小的加载器，在页面空闲或顾客开始操作时才加载聊天窗口，不会拖慢页面。聊天窗口运行在独立的 Shadow DOM 中，不受主题样式影响，你的网站也无需安装 React。
Gosper 对聊天窗口的更新，大约五分钟内触达所有顾客。
如果你的店面设置了 Content-Security-Policy（Hydrogen 默认会设置），请为脚本和网络连接放行 https://service.gosper.ai。
在 Shopify 主题店上，聊天窗口会从主题获取顾客所选的市场，价格和库存与之对应。其他情况下，助手会根据你的站点、当前页面和你的要求判断市场，在市场关键而又不明确时会先问顾客。

日常管理

每个助手名称下方会显示它安装在哪个站点、今天和本周的消息数，以及今天有多少条没能回答。
修改任意部分后点 Save changes，新的回答即按新设置进行。
More actions（…）里是会影响页面上代码片段的两个操作：
- Replace key：签发新的 key，旧代码片段随即失效，请粘贴新的嵌入代码；
- Disable：立即停止聊天，并清除它的所有对话。
额度用完后，顾客会看到你设置的“无法回答”提示，直到你充值。

让你的 agent 帮你看

你的 Gosper agent 可以告诉你客服表现如何，并修正它答错的地方。店铺数据不会自动加入你的工作区：在要使用的工作区里，把 Shopify AI Support 添加为连接（agent 也可以请你添加）。然后可以这样问：

“这周店铺客服表现怎么样？”
“哪些问题它没答上来，为什么？”
“昨天平均每次对话花了多少额度？”

agent 会读取每日数据（聊天加载次数、对话数、消息数、回答数、未回答的消息及原因、消耗的额度），打开没答上来的对话，对照你给助手的资料，针对相应条目提出修改建议。每一处修改都要经你批准。 想定期检查，可以建一个定时任务，比如每周回顾一次。

两个值得留意的信号：

连续几天有访问后，聊天加载次数降到零：代码片段被删掉了，或者网站改版了。
出现来自未允许站点的请求：如果是你自己的站点，把它加进允许列表；否则就是有人复制了你的代码片段，而白名单阻止了它生效。

顾客体验

用顾客自己的语言回答，推荐的商品链接指向顾客正在浏览的店面上的真实商品页。指向你自己页面的链接在当前标签页打开。
对话会跟随顾客跨页面延续，所以“那第二款呢？”这样的追问也能理解。对话保存在 Gosper 服务端，最后一条消息 7 天后删除。
一次一条：回复还在生成时发出的第二条消息会被拒绝。
它绝不索要密码、支付信息或证件号码，也不能查询订单、修改购物车或收款；遇到这些问题，它会引导顾客前往你的联系页面或客服邮箱。
无法回答时（额度用完或模型出错），顾客看到的是你设置的“无法回答”提示，不会看到任何技术细节。