Loading
Agentforce 和 Einstein 生成式 AI
变量

变量

为了提高安全性并确保客服人员行为的一致性,请在客服人员的整个推理和交互中使用变量,例如在筛选器、指令和逻辑表达式中。

所需的 Edition

适用于:Lightning Experience
适用于:Enterprise、Performance、Unlimited 和 Developer Edition。所需的加载项许可证因客服人员类型而异。

上下文变量(也称为链接变量)映射到对象字段。例如,Agentforce 服务客服人员包含从消息传递会话对象字段映射的上下文变量,包括自定义字段。

例如,此客服人员脚本定义了一个上下文变量,用于存储消息传递会话记录 ID。

RoutableId: linked string
    description: "The messaging session ID”
    label: "RoutableID"
    source: @MessagingSession.Id

自定义变量(也称为可变变量)对所在的客服人员唯一,并且仅在对话会话期间保留值。自定义变量可以存储以下数据类型之一:字符串、数字、列表、对象、布尔值。默认情况下,这些变量仅限内部,这意味着只能在客服人员中设置。您可以将它们设置为外部,这意味着它们也可以使用客服人员 API 进行设置。

例如,此客服人员脚本定义了一个存储用户名的自定义字符串变量。

userName: mutable string
    description: "The name of the user"
    label: "Name"
    visibility: "External"

系统变量是预定义的,仅在对话会话期间保留值。这些变量是只读的。

以下是一些客服人员脚本示例,介绍了如何在客服人员的推理和交互中使用变量。

  • 将变量设置为操作输入或输出。该操作使用设置变量的值作为输入,或将输出值存储在设置变量中。
    run @action.Get_Order_Details
        with order_number=@variables.orderNumber
        set @variables.order_id=@outputs.order_id
    
  • 在筛选器中使用变量。
    get_order_details: @actions.Get_Order_Details
        available when @variables.isVerified == False
    
  • 在逻辑表达式中使用变量。
    if @variables.order_summary == "":
        run @actions.lookup_current_order
          with member_email=@variables.memberEmail
          set @variables.order_summary=@outputs.order_summary
    
  • 设置变量值。
    set @variables.userName = ”New User”
  • 在客服人员回复中使用变量值。例如,您可以告诉客服人员在子客服人员指令中以特定方式使用变量。
    | Refer to the user by the name {!@variables.userName}.
  • 使用系统变量告诉客服人员当前会话的相关信息。例如,告诉客服人员在客服人员级说明中以不同方式格式化文本或语音对话的日期。
    if @system_variables.current_modality == "text":
        | Format dates in a readable format, such as "8/17/2025".
    if @system_variables.current_modality == "voice":
        | Format dates for speech, such as "August seventeenth 2025".
  • 在 Agentforce Builder 中创建变量
    使用变量在客服人员的推理中存储和重用值,并控制客服人员的决策方式。例如,当您将变量分配到操作输入时,客服人员只能使用分配的变量来填充输入的值。
 
正在加载
Salesforce Help | Article