运行客服人员元素
使用 Agentforce 客服人员在您的流中动态处理任务。选择现有客服人员，或使用自定义说明和操作创建客服人员。
所需的 Edition
权限
要在流中使用现有客服人员，您需要查看设置用户权限。要从 Flow Builder 创建客服人员，您需要自定义应用程序、Einstein Copilot生成器、Einstein 客服人员平台生成器或自助副驾驶生成器用户权限。拥有系统管理员简档的用户，可以创建和使用客服人员。
如果您没有创建客服人员的权限，则“创建客服人员”按钮不会出现在客服人员选择面板中。您只能选择现有客服人员。
使用情况
将运行代理元素添加到流。在客服人员字段中，搜索并选择有效客服人员，或单击创建客服人员，以构建新客服人员。
选择现有客服人员
要使用现有客服人员，请在客服人员字段中按名称搜索客服人员。只有有效客服人员才会显示在列表中。选择客服人员后，在属性面板中配置客服人员的输入和输出。
创建新客服人员
要创建客服人员，请单击创建客服人员。在“新建客服人员”窗口中，配置客服人员的基本信息。
| 字段 | 说明 |
|---|---|
| 标签 | 客服人员的名称。 |
| API 名称 | 唯一性要求仅适用于当前流程内的元素。两个元素可具有相同的 API 名称，只要用于不同的流。API 名称可以包含下划线和字母数字字符，但不得有空格。必须以字母开头，且不得以下划线结尾。也不得包含两个连续下划线。 |
| 描述 | 客服人员工作的描述。 |
| 用户访问权限 | 客服人员运行的用户记录。选择现有用户或让系统创建用户。 |
| 指示 | 描述客服人员操作并指导推理的说明。 |
| 操作 | 客服人员可以使用的操作。从资产库中选择现有操作或创建自定义操作。 |
将操作添加到客服人员
客服人员需要至少一个操作来执行任务。在单击创建并激活前或在激活客服人员后在 Agentforce Builder 中添加操作。
要选择现有操作，请单击选择操作。从资产库中搜索并选择一个或多个操作，然后单击添加到客服人员。可用操作包括 Knowledge 操作、配置为可调用操作的流和标准操作。
要创建操作，请单击创建操作。在“创建操作”窗口中，配置操作。
| 字段 | 备注 |
|---|---|
| 客服人员工具标签 | 操作的名称。 |
| API 名称 | 唯一性要求仅适用于当前流程内的元素。两个元素可以具有相同的 API 名称，前提是它们在不同的流中使用。API 名称可以包括下划线和字母数字字符，没有空格。必须以字母开头，且不得以下划线结尾。也不得包含两个连续下划线。 |
| 描述 | 操作的名称。客服人员使用此信息来确定如何以及何时使用此操作。 |
| 引用操作类型 | 操作的类型，例如 Flow 或 Apex。 |
| 参考操作类别 | 引用操作类型的子类型。并非所有操作都有参考操作类别。 |
| 参考操作 | 要引用的操作的名称。 |
对于每个输入，添加关于输入功能的描述。客服人员使用描述来确定如何在调用操作时使用输入。选择需要输入执行操作，使输入成为必填项。
对于每个输出，添加关于输出返回以及如何在流中使用结果的描述。选择从客服人员上下文中筛选，以从客服人员推理中排除输出。选择在对话中显示以将此输出包含在客服人员的响应中。
单击创建并激活，以创建并激活客服人员。
配置元素
选择或创建客服人员后，在属性面板中配置运行客服人员元素。
| 字段 | 说明 |
|---|---|
| 标签 | 画布和工具箱管理器中操作的标签。 |
| API 名称 | 唯一性要求仅适用于当前流程内的元素。两个元素可以具有相同的 API 名称，前提是它们在不同的流中使用。API 名称可以包括下划线和字母数字字符，没有空格。必须以字母开头，且不得以下划线结尾。也不得包含两个连续下划线。 |
| 描述 | 元素的描述。 |
设置输入值
在属性面板中配置运行客服人员元素的输入。
| 字段 | 备注 |
|---|---|
| 客服人员请求 | 要发送给客服人员以执行此流的问题或请求。客服人员将其指令应用于此特定请求，以生成输出。 |
| 会话 ID | 可选。使用在流中较早运行的运行代理元素返回的会话 ID。客服人员保留对话的完整推理上下文和记忆。如果您未提供会话 ID，客服人员会开始新对话，但您始终可以将先前运行客服人员元素的输出指定为输入。 |
配置结构化输出
要将客服人员配置为返回流可以使用的结构化数据，请定义结构化输出字段。每个字段代表客服人员提取或生成的一条信息。
如果您配置结构化输出，客服人员仅返回结构化客服人员响应字段中的结构化数据。客服人员回复字段返回 null。如果您未配置结构化输出，客服人员仅会在客服人员响应字段中返回非结构化文本。
要配置结构化输出，请单击配置。为每个结构化输出字段配置字段：
| 字段 | 描述 |
|---|---|
| 字段名 | 必需。结构化输出字段的唯一字母数字名称。名称不能包含特殊字符或空格。 |
| 描述 | 与字段名称一起使用以提高大语言模型 (LLM) 准确性的简短描述。 |
| 数据类型 | 必需。字段的数据类型。有效值：字符串、数字、布尔值。 |
| 必填 | 表示 LLM 必须为此输出字段生成响应。需要输出行会导致 LLM 的响应不准确或有害。 |
存储输出值
| 字段 | 备注 |
|---|---|
| 客服人员回复 | 客服人员的非结构化响应。如果配置了结构输出，则返回 null。 |
| 会话 ID | 客服人员响应所在的对话会话的 ID。 |
| 结构化客服人员响应 | 客服人员的结构化输出。如果未配置结构化输出，则返回 null。 |
结构化输出使用情况
在配置结构化输出之前，输入运行客服人员元素的标签和 API 名称，然后保存流。
配置结构化输出时，请在保存前定义至少一个结构化输出字段。
对于每个定义的结构化输出字段，将创建两个字段：一个具有定义的名称，另一个具有相关的布尔值 _set 字段。例如，如果您定义了名为 summary 的结构化输出字段，则也会创建名为 summary_set 的布尔值字段。
| 字段 | 备注 |
|---|---|
| 真 | 该字段包含在结构化客服人员响应中，但没有设置值。 |
| 假 | 该字段未包含在结构化客服人员响应中。 |
当定义的结构化输出返回 null 时，稍后在流中使用其相关的 _set 字段来确定该字段是 null 的原因。
使用备注
- 在激活前测试流，以确保运行客服人员元素如预期正常工作。
- 您可以随时在 Agentforce Builder 中找到并编辑在 Flow Builder 中创建的客服人员。
- 从 API 版本 67.0 开始，AI 客服人员操作不再适用于操作元素。使用“运行客服人员”元素与客服人员协作。当您使用引用 AI 客服人员操作的操作元素打开流时，它会自动显示为运行客服人员元素。保留原始配置。
