Loading
Agentforce 和 Einstein 生成式 AI
使用结构化输出格式化模型响应

使用结构化输出格式化模型响应

提示生成器中的结构化输出确保模型以一致的 JSON 或 HTML 格式返回响应,提高了工作流、集成和 UI 渲染的可靠性。

所需的 Edition

适用于:Lightning Experience
适用于:EnterprisePerformanceUnlimited Edition,带有 Einstein for Platform、Einstein 或适用于销售的 Agentforce 或 Service 加载项、Agentforce Foundations

结构化输出使用 JSON 或 HTML 定义模型响应的格式。当您的工作流、集成或 UI 需要一致的格式来呈现或解析数据时,此功能会提供结构。

结构化输出不是依赖用户编写的提示指令,而是应用系统级指令,并在模板级设置元数据。此控制提高了使用流或客服人员等工具时的可靠性。

选择预期回复格式

选择 JSON 会应用特殊指令和语法检查,以帮助返回干净、有效的 JSON。当您选择 HTML 时,系统会使用 HTML 格式向模型发出响应的信号。每个模板设置一次格式。该选择适用于使用该模板发送的每个提示,让您在用例之间保持一致。

格式:默认

默认情况下,模型通常使用 Markdown 进行浅格式,例如粗体、斜体或项目符号。早期版本的提示生成器将此格式显示为原始文本。当前版本将 Markdown 呈现为样式输出,提高了可读性,并使响应更易于解释。提示生成器使用与客服人员相同的渲染组件,因此格式与用户在真实情况下看到的内容相匹配。

格式:JSON

选择 JSON 会应用特殊指令和语法检查,以帮助返回干净、有效的 JSON。

重要
重要 JSON 响应格式返回单个 JSON 对象。要生成 JSON 数组,请使用默认格式,并在提示说明中指定数组结构。

仅在原始视图中查看 JSON 响应。字段不会呈现格式化文本,例如标记和回车、\n\r。模型性能在生成 JSON 时有所不同。彻底的测试对于提高准确性和一致性非常重要。为了获得最佳结果,请选择 Lightning 类型来强制执行 JSON 模式。如果您未选择 Lightning 类型,请在提示说明中包含 JSON 结构的示例。

当使用 JSON 作为响应格式时,您可以选择 Lightning 类型来强制执行预定义的输出模式。Lightning 类型定义了模型返回的精确字段、数据类型和必填值。

如果没有 Lightning 类型,JSON 响应仅依赖于提示说明。虽然系统应用语法检查来帮助确保有效的 JSON,但结构本身在响应之间有所不同。Lightning 类型通过将模式定义从提示指令转移到系统强制执行的元数据来消除这种可变性。选择 Lightning 类型后:

  • 提示生成器指示模型精确匹配预定义的模式
  • 模型填充值,而不是确定结构
  • 响应对于流、客服人员和集成来说更加可靠

当您通过以下方式消耗 JSON 输出时,请选择 Lightning 类型:

  • 自动化或编排工具
  • 下游集成
  • 需要一致数据结构的 UI 组件

您可以通过两种方式使用 Lightning 类型:

  • 基于对象的 Lightning 类型,使用 Lightning 类型生成器直接在提示生成器中创建
  • 使用 Apex 类在“设置”中创建基于 Apex 的 Lightning 类型,并在功能中重复使用

在为提示模板配置 JSON 输出时,选择 Lightning 类型。

格式:HTML

选择 HTML 会配置模板,以返回并显示结构化样式内容。提示生成器:

  • 使用 format = rich text 标记模板
  • 指示模型返回 HTML 格式的输出
  • 使用 lightning-formatted-rich-text Lightning Web 组件呈现回复

提示生成器使用 Lightning Web 组件lightning-formatted-rich-text从模型中呈现响应。

  • 此组件支持 HTML 标记子集,行为不像完整浏览器。
  • 提示生成器会在模型响应中保留不支持的 HTML 标记,但不会在视图中呈现。
  • 所有取消屏蔽的数据都出现在“响应”部分。要查看原始值和屏蔽值之间的映射,请在“响应”部分中打开“屏蔽详细信息 (屏蔽图标)”窗口。
  • 有关支持标记的完整列表,请参考 Salesforce 组件库文档。仅在 Salesforce 中使用富文本输出,因为它未针对外部 Web 平台上的完整渲染进行优化或验证。
 
正在加载
Salesforce Help | Article