使用片段实现可复用的指导
片段为 Agent 提供简短的操作指导。当相同指令应适用于不同对话时，或者当某个产品需要聚焦说明而这类说明不适合放在公开文章或同步的目录字段中时，片段就很有用。 本指南重点介绍片段的生命周期和维护。片段在当前的 Knowledge 设置中保持私有，因此绝不能将其视为公开的 Helpdesk 页面。 这如何融入 Humind Knowledge 是由 Humind 使用的非目录信息维护来源。文章、片段、导入的网页、文档和外部帮助中心...
片段为 Agent 提供简短的操作指导。当相同指令应适用于不同对话时，或者当某个产品需要聚焦说明而这类说明不适合放在公开文章或同步的目录字段中时，片段就很有用。
本指南重点介绍片段的生命周期和维护。片段在当前的 Knowledge 设置中保持私有，因此绝不能将其视为公开的 Helpdesk 页面。
这如何融入 Humind
Knowledge 是由 Humind 使用的非目录信息维护来源。文章、片段、导入的网页、文档和外部帮助中心来源具有不同的归属和可见性规则。请选择与信息维护方式相匹配的来源类型。
公开且已发布的文章也可以投放到 Helpdesk 中。片段仍然是操作指导，而不是公开的 Helpdesk 页面。为每项政策保留一个权威来源可以减少相互冲突的回答，并使更新可审计。
开始之前
访问权限：需要具有 Knowledge 写入权限。以产品为重点的审核还可能需要 Catalog 读取权限。
- 定义确切场景和期望行为。
- 确认事实来源，并检查是否已存在相关文章或片段。
- 准备一个匹配的 Playground 问题和一个不匹配的问题。
分步工作流
判断片段是否合适
对于应影响 Agent 但不需要公开页面的简明、稳定指导，请选择片段。对于结构化政策或说明，请选择文章。对于从商业数据同步的产品事实，请选择 Catalog。
如果该指令每天都会变化、依赖外部系统，或重复了完整政策，请先修正来源设计，再创建片段。
编写片段
打开 AI Agent、Knowledge，选择 New content，然后选择 Snippet。为其提供一个可搜索的标题，用于说明场景、产品或规则。编写一条直接指令，并提供足够的上下文以区分其何时适用。
对于产品相关工作，产品详情或 Test product 面板可以显示产品 Knowledge 操作。请确保指导内容关联到正确的产品，并验证当前公司和市场。
解决重叠和范围问题
在 Knowledge 和相关产品记录中搜索类似表述。应整合冲突，而不是在新片段中添加优先级措辞。团队成员应能够解释哪个来源优先以及原因。
使用稳定的客户意图或产品上下文。避免使用诸如 '始终推荐此产品' 之类的宽泛措辞，除非业务方已批准该行为且例外情况已明确说明。
测试并维护
在 Playground 中运行匹配、不匹配、追问以及产品不可用场景。检查所选产品、事实性说明，以及片段是否压制了更好的替代方案。
添加负责人和审核触发条件。当活动结束、产品发生变化，或某篇维护中的文章成为更好的来源时，请更新或删除片段。
权限和重要注意事项
- 片段保持私有，不会作为 Helpdesk 文章被包含在内。
- 片段不应覆盖错误的 Shopify 产品数据或已维护的公开政策。
- 宽泛指导可能会影响无关对话，因此负向测试是必需的。
- 必须在当前活动公司和市场中检查产品范围。
验证结果
在认为工作完成之前，请使用以下核对清单：
- 片段具有单一用途、负责人、范围和事实来源。
- 没有任何文章、目录值或其他片段与其冲突。
- 匹配测试和追问测试有所改善，而不匹配测试保持不变。
- 团队知道何时应审核或删除该片段。
故障排查
片段似乎从未生效
确认其已保存在当前活动公司中，收紧标题和指令，验证事实来源，并在新的对话中测试一个明确匹配的提示。
片段主导了产品推荐
删除一刀切的推荐措辞，缩小产品或场景范围，并测试一位需求不同的购物者，以确认替代方案仍然可用。
公开读者需要相同的信息
创建或改进一篇结构化的公开 Knowledge 文章作为权威来源，然后如果仍有必要，仅在片段中保留简短的操作性指令。