Shopify 目录连接可让 Humind 使用当前产品和相关商业数据进行发现和推荐。连接只是第一步，您必须验证正确的店铺、市场上下文、产品数量、代表性记录、可见性以及店面体验。

本指南记录了当前的 Shopify 连接和重新连接流程。市场中显示的其他目录集成并不能以相同方式使用，也不应被表述为可用的 Shopify 替代方案。

这如何融入 Humind

目录数据是产品发现和推荐的事实基础。集成状态、产品可见性、metafield 过滤器、集合、促销、市场以及店面部署，都会影响购物者能看到什么，以及 Agent 能解释什么。

在通过 Agent 指导来补救之前，请先验证源数据。如果目录中的价格、变体、集合或属性有误，请先更正或重新同步该来源，然后在 Humind 中重新测试完全相同的产品旅程。

开始之前

访问权限：在 Humind 中需要公司或目录管理权限，并且完成 OAuth 的操作员必须对该 Shopify 店铺具有相应权限。

• 对目标商店使用永久的 myshopify.com 域名。
• 确认哪个 Shopify Market 是主市场，以及哪些附加市场应拥有单独的 Humind 公司。
• 在更改实时目录连接之前安排一个检查窗口。

分步工作流程

1. 连接 Shopify 店铺

   打开 Integrations 或 Settings、Catalog、Shopify。选择 Connect，并以预期的 myshopify.com 格式输入店铺域名。Humind 会启动 Shopify 授权流程，请为您打算连接的同一店铺完成该流程。

   不要在店铺字段中使用店面的 vanity 域名。如果该公司已经显示了一个已连接的 Shopify 域名，请在发起重新连接之前先验证它。

2. 检查 Shopify Markets

   对于拥有多个市场的店铺，Shopify Markets 部分会列出主市场、已激活市场以及可以激活的市场。激活附加市场会创建一个带有市场范围的 Humind 公司上下文，并启动其目录同步。

   如果现有的 Shopify 授权早于所需的市场范围，Humind 会显示重新连接提示。在尝试解释缺失的市场列表之前，请先完成重新连接。

3. 验证产品列表

   打开 AI Agent、Catalog，然后选择 Products。比较总数与已同步数量，搜索有代表性的产品，并检查标题、变体、价格、可用性、图片、集合、描述以及相关的 metafield。

   请使用多种产品类型和边界情况，而不只是畅销产品。完整的数量仍可能掩盖会影响推荐的字段质量问题。

4. 准备过滤器并运行产品测试

   源数据稳定后，检查 Filters 和 Collections。只启用有用且一致的属性，并验证特定市场的产品组。使用 Test product 进行聚焦提问，使用 Playground 进行更广泛的发现。

   测试可用和不可用的变体、价格敏感问题、比较问题，以及一个本应不返回结果的查询。当目录中不存在匹配产品时，Agent 不应编造一个匹配产品。

权限和重要注意事项

• 激活新的 Shopify Market 会创建单独的 Humind 公司上下文，而不是将所有市场合并到一个目录视图中。
• Reconnect 是修复授权的步骤，继续之前请确认店铺。
• 目录更改可能需要时间才能同步并体现在过滤器中。
• 当该系统仍是事实来源时，请更正 Shopify 上游数据。

验证结果

在认为工作完成之前，请使用此检查清单：

• 已连接的 myshopify.com 域名与活动中的 Humind 公司一致。
• 主 Shopify Markets 和附加市场均按预期体现。
• 同步后，数量和代表性产品字段均正确。
• 产品测试能够准确处理有效、不可用和无结果查询。

故障排除

店铺域名被拒绝

请以 store-name.myshopify.com 的形式输入永久 Shopify 域名，不要包含协议或店面路径。重试前请确认拼写和所有权。

市场缺失或 Humind 要求重新连接

使用重新连接操作，为同一店铺授予当前 Shopify 市场范围。然后重新加载 Markets 部分，并在激活另一个市场之前确认主市场。

产品或字段不完整

确认活动中的公司和市场，等待同步完成，在 Shopify 中检查产品，并在适当时更正源数据。在下一次成功同步后重新测试。

相关指南

• 连接 Shopify 并同步您的目录
• 配置市场、语言和允许的域名
• 设置目录集合和 AI 筛选条件
• 在 Playground 中测试你的 Agent