故障排除提示生成器
解决常见提示模板问题。
所需的 Edition
| 适用于:Lightning Experience |
| 适用于:Enterprise、Performance 和 Unlimited Edition,带有 Einstein for Platform、Einstein 或适用于销售的 Agentforce 或 Service 加载项、Agentforce Foundations |
我的预览或测试因错误而失败。
如果您单击预览并出现错误,例如Internal Server Error,请在联系 Salesforce 客户支持之前检查这些项目。
- 确认提示生成器包含在您的 Salesforce 版本和加载项中。支持的版本会显示在此页顶部。
- 确认 Einstein 已打开。从“设置”中,在快速查找框中输入 Einstein 设置,然后选择 Einstein 设置。了解有关启用提示生成器的更多信息。
- 请确认,已为您分配提示模板管理人或提示模板用户权限集,并且权限集包含执行提示模板。了解有关启用提示生成器的更多信息。
- 如果您已验证 Einstein、许可证和权限,并且错误仍在继续,请等待几分钟,然后重试。问题通常是临时服务中断。在创建支持个案之前检查 Salesforce Trust。
我的提示模板在预览中可用,但在客服人员中使用时会失败。
提示模板可以在提示生成器中生成响应,并且在从 Agentforce Builder 调用相同模板或在客服人员对话中运行时仍然失败。客服人员可以传递与您在预览中选择的值不同的输入值。
- 如果模板使用检索器,请确认检索器的数据源处于活动状态,并且检索器自行返回结果。了解有关单个猎犬的更多信息。
- 如果您使用 Agentforce 数据库或非结构化文件对模板进行基础训练,请确认索引已完成。了解有关 Agentforce 数据库故障排除的更多信息。
- 使用客服人员在运行时传递的相同输入值再次预览模板。了解有关预览生成的回复的更多信息。
当 Einstein Trust 层打开时,我的结构化回复缺少字段或为空字段。
当 Einstein Trust 层打开并使用结构化输出生成 JSON 响应时,一些字段可能会返回空或null。Einstein Trust 层在向 AI 模型发送提示之前屏蔽个人信息,例如姓名或电子邮件地址。如果字段在响应返回后未恢复,将显示为空。
在“回复”部分,打开“屏蔽详细信息”,并记录哪些字段被屏蔽,以及它们是否包含个人身份信息。屏蔽个人信息是最常见的原因。了解有关结构化输出的更多信息。要审查屏蔽设置,请参阅 Einstein Trust 层设置。
我的提示模板不使用运行用户的数据访问权限。
如果模板返回用户不应看到的数据,或忽略用户应看到的数据,则添加 Apex 或流操作,以在提示模板中保留数据之前筛选记录。了解有关添加操作的更多信息。
我的文件太大,无法用于基础训练。
用于基础训练的文件限制为每个请求 15 MB,大多数型号支持至少一种文件类型。如果您的文件超过限制,请在将其作为基础源上载之前将其拆分为更小的文件或汇总内容。不支持的文件将从请求中排除,并列在“解决”面板中。了解有关提示生成器限制的更多信息。通过文件输入了解有关接地的更多信息。
缺少对象字段。
您是否看到对象字段取决于提示模板类型。
- 对于字段生成模板,在创建模板时选择对象和对象字段,然后打开工作区。了解有关创建字段生成提示模板的更多信息。
- 对于 Flex 模板,对象资源是可选的。稍后从“资源”选项卡添加它们。对象字段不会出现在初始设置屏幕上。了解有关创建 Flex 提示模板的更多信息。
如果您希望立即看到对象,但您没有看到,请确认您正在创建的模板类型。
我从相同的提示模板中获得不一致的结果。
提示模板使用大型语言模型 (LLM)。AI 模型并不总是为相同的输入返回相同的响应,因此结果在不同的运行中会有所不同。对分类样式任务使用检索器的模板也可能无法将响应解析为有效的 JSON。
- 多次预览相同的输入,以查看问题是否是间歇性的。了解有关预览生成的回复的更多信息。
- 使指令具体化,并为空值或意外值添加显式处理。了解有关细化提示模板的更多信息。
- 不要多次重复相同的合并字段。重复合并字段会导致结果不一致。了解有关组织复杂提示的更多信息。
- 如果故障频繁,例如,大约每两次运行中就有一次,则创建支持个案并包含示例输入。
解析数据提供商时出错。
如果您看到Error occurred while resolving data providers; cannot
describe data provider等错误,则表示资源选项卡中的操作缺失、配置错误或不可用。在提示生成器中,这些资源称为操作。它们包括流、Apex 和检索器操作。
- 打开“资源”选项卡,并查看每个操作。请确认引用的流、Apex 类或检索器仍然存在,并且您有权访问它。了解有关添加操作的更多信息。
- 如果您最近重命名、删除或禁用了流或类,请更新或替换提示模板中的操作,然后再次保存并预览。
我无法删除输入。
您无法删除仍被操作引用的输入。在资源选项卡中,移除或更新使用输入的流、Apex 或检索器操作。然后,删除输入。了解有关添加输入的更多信息。
保存并激活后,我的资源或流丢失。
保存并激活后,请确认您正在查看包含资源的版本。激活模板版本会使该版本不可变,因此无法编辑。
- 刷新页面,然后使用提示模板工作区顶部的版本下拉列表打开您刚激活的版本。了解有关使用多个版本的更多信息。
- 请确认,资源已保存在现在启用的版本上。如果您在激活后添加了流或 Apex 操作,请将工作保存为新版本并激活该版本。了解有关激活和取消激活提示模板的更多信息。
我的提示模板无法保存。
当合并字段、操作或必填输入无效时,保存时间验证失败。
- 检查合并字段语法。例如,使用
{!$Input:Account.Id},而不是 Winter ’24 语法{!$account.Id}。了解有关资源合并字段语法的更多信息。 - 请确认每个必填输入都有值,并且资源中的每个操作仍然解析。了解有关添加输入的更多信息。
- 如果模板使用提示生成器试点中的流或 Apex 类,请为当前语法重新创建这些资源。试用后,了解有关流变化的更多信息。了解试点后 Apex 类变化的更多信息。
我的回应被屏蔽、标记为有害内容或被截断。
Einstein Trust 层扫描有毒语言的提示模板响应。在检测到有毒语言时,有害内容徽章会显示在“响应”部分,并带有警告计数。修改提示模板并再次预览,直到警告计数返回 0。了解有关有害内容通知的更多信息。
如果响应被截断,解析的提示可能会超出 AI 模型接受的范围。当提示过大时,提示生成器可以在分辨率面板中生成汇总。使用汇总提示或缩短模板。了解有关使用大型提示的更多信息。
当 Einstein Trust 层用占位符替换敏感数据然后恢复它们时,响应中的屏蔽值是预期的。在“响应”部分中打开屏蔽详细信息,以检查映射。了解有关数据信任和屏蔽的更多信息。
我需要记录并调试提示模板。
提示生成器不支持模板正文中的内联评论。使用版本比较更改,并简短记录您在每个版本中所做的更改。
- 在重要编辑前单击另存为 | 另存为新版本,以便您可以并排比较回复。了解有关使用多个版本的更多信息。
- 每次使用相同的测试记录预览,并记下您更改了哪些指令或资源。
- 对于复杂逻辑,在预览中自行测试说明文本,然后添加资源并再次预览。了解有关组织复杂提示的更多信息。
