Variáveis

Disponível em: Lightning Experience

Disponível em: Edições Enterprise, Performance, Unlimited e Developer. As licenças complementares necessárias variam de acordo com o tipo de agente.

Uma variável de contexto, também chamada de variável vinculada, é mapeada para um campo de objeto. Por exemplo, os agentes de Serviço Agentforce incluem variáveis de contexto mapeadas de campos de objeto Sessão do Messaging, incluindo campos personalizados.

Por exemplo, esse Script do agente define uma variável de contexto que armazena o ID de registro da sessão de mensagens.

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

Uma variável personalizada, também chamada de variável mutável, é exclusiva para o agente em que está e contém um valor apenas durante a sessão da conversa. Variáveis personalizadas podem armazenar um destes tipos de dados: string, número, lista, objeto, booleano. Por padrão, essas variáveis são apenas internas, o que significa que elas só podem ser definidas no agente. Você pode torná-los externos, o que significa que eles também podem ser definidos com a API do agente.

Por exemplo, esse Script do agente define uma variável de string personalizada que armazena o nome de um usuário.

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

As variáveis do sistema são predefinidas e contêm um valor apenas durante a sessão da conversa. Essas variáveis são somente leitura.

Aqui estão alguns exemplos de Script do agente de como você pode usar variáveis em todo o raciocínio e interações do agente.

• Defina uma variável para uma entrada ou saída de ação. A ação usa o valor da variável definida como entrada ou armazena o valor de saída na variável definida.

  run @action.Get_Order_Details
      with order_number=@variables.orderNumber
      set @variables.order_id=@outputs.order_id
  

• Use uma variável em um filtro.

  get_order_details: @actions.Get_Order_Details
      available when @variables.isVerified == False
  

• Use variáveis em expressões lógicas.

  if @variables.order_summary == "":
      run @actions.lookup_current_order
        with member_email=@variables.memberEmail
        set @variables.order_summary=@outputs.order_summary
  

• Defina valores de variável.

  set @variables.userName = ”New User”

• Use valores de variável em respostas do agente. Por exemplo, você pode dizer ao agente para usar uma variável de uma maneira específica nas instruções do subagente.

  | Refer to the user by the name {!@variables.userName}.

• Use uma variável do sistema para informar ao agente sobre a sessão atual. Por exemplo, peça para o agente formatar datas de maneira diferente para uma conversa de texto ou voz em instruções no nível do agente.

  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".

• Criar variáveis no Agentforce Builder
  Use variáveis para armazenar e reutilizar valores no raciocínio do agente e controlar como um agente toma decisões. Por exemplo, quando você atribui uma variável a uma entrada de ação, seu agente pode usar apenas a variável atribuída para preencher o valor da entrada.