了解目录同步状态和错误
查看同步进度，并将失败或部分完成的目录同步转化为明确的下一步操作。本指南使工作始终聚焦于目录同步，并提供一条可重复执行的路径，供新的 Humind 用户在不更改无关配置的情况下遵循。 目录为 Humind 提供结构化的产品信息，例如产品、变体、价格、可用性、集合和元数据。Shopify 同步会将源数据带入 Humind，而索引和 AI 筛选器决定 Agent 可以使用哪些内容。仅凭同步成功，并不能证明每个产品都已准备好用于客户对话...
查看同步进度，并将失败或部分完成的目录同步转化为明确的下一步操作。本指南使工作始终聚焦于目录同步，并提供一条可重复执行的路径，供新的 Humind 用户在不更改无关配置的情况下遵循。
目录为 Humind 提供结构化的产品信息，例如产品、变体、价格、可用性、集合和元数据。Shopify 同步会将源数据带入 Humind，而索引和 AI 筛选器决定 Agent 可以使用哪些内容。仅凭同步成功，并不能证明每个产品都已准备好用于客户对话。
开始之前
访问权限：检查状态只需要目录读取权限。重新连接或开始同步则需要目录或公司的写入权限。
- 明确已连接的商店和预期的 Shopify Market。
- 记录源数据上次更改的时间。
- 选择一个可以端到端检查的产品。
请在下文所述的最小负责范围内工作，并在准备更改时保持当前面向客户的状态可用。在点击任何最终操作之前，请确认 Humind 中显示的当前公司、Agent、商店、语言和市场。缺少某个控件可能表示只有只读权限，或者该公司尚未配置相应能力。在这种情况下，请记录预期任务，并请管理员核查确切的权限或依赖项。不要通过共享账户、将数据复制到其他区域，或承诺工作区未提供的能力来绕过该边界。
分步工作流程
确认范围和当前状态
打开目录或 Shopify 集成，区分排队中、进行中、已完成、部分完成和失败的工作，并将其与单独的索引状态区分开来。
- 编辑前确认当前公司和 Agent。
- 记录当前状态，以便在更改后比较结果。
- 如果界面或权限与预期任务不符，请停止操作。
准备更改
检查报告的阶段和错误详情，然后确认问题是否由源产品、市场或授权所导致。
- 使用能够完成客户任务的最小更改。
- 将权威信息保留在其所属的源中。
- 保存前检查标签、日期、语言以及客户可见措辞。
保存并等待所需处理完成
仅在已识别原因得到纠正后，再重试或重新连接。避免发起相互重叠的同步，以免掩盖结果。
- 等待界面确认更改已保存。
- 如果需要同步、索引或发布，请等待其最终状态。
- 重新加载该区域，并确认保存的值仍然保留。
测试完整的客户旅程
在最终同步状态和索引状态完成后，确认代表性产品、变体、价格、库存、市场以及 Agent 可用性。
- 使用新的会话和真实的客户场景。
- 当结果显示在店面时，请同时检查桌面端和移动端。
- 如果结果与预期不符，请记录确切失败的步骤。
重要限制和操作说明
- 成功保存只确认已持久化，不代表每个下游同步或公开更新都已完成。
- 工作区权限可能会隐藏某个区域，或允许读取但不允许更改。
- 不要将易变的目录、账户或客户事实复制到叙述性内容中作为变通方法。
- 仅测试当前公司可见且已配置的受支持能力。
- 将目录同步中的更改与无关的 Agent、Knowledge、目录、Inbox 或 Helpdesk 工作分开。
验证结果
- 同步达到明确的最终状态。
- 报告的总数对于预期商店和市场而言是合理的。
- 代表性产品与 Shopify 源数据一致。
- 索引完成后，产品测试可以使用该项目。
请简要记录你测试了什么、使用了哪个客户场景以及发生了哪些变化。这样可以让后续故障排查更精确，也能帮助其他团队成员在不依赖记忆的情况下复现结果。
故障排查
同步始终处于排队中或运行中
等待当前活动任务完成，并刷新其状态。如果它超出了正常运行时间窗口，请先记录商店、阶段、开始时间和可见错误，再请求支持进行调查。
同步完成但产品缺失
分别检查市场激活、源发布、产品可见性和索引。导入完成并不意味着每个源项目都符合 Agent 使用条件。