controles Designer do Virtual Agent

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 3 min. de leitura
  • Um tópico Virtual Agent consiste em uma coleção de controles em um fluxo de tópico. Use esses controles para coletar, processar e apresentar informações aos usuários. Os controles também podem ler, criar e atualizar registros em sua instância.

    Cada conjunto de controles executa funções específicas em um fluxo de conversa.

    Tabela 1. Tipos de controle
    Categoria Descrição
    Segmento inicial Aparece automaticamente em um fluxo de tópico e não pode ser adicionado ou removido de uma conversa. Este controle pode ser configurado com uma resposta de saudação que aparece quando uma conversa se inicia.
    Segmento final Aparece automaticamente em um fluxo de tópico e não pode ser adicionado ou removido de uma conversa. Este controle pode ser configurado com uma mensagem de confirmação final antes do fim de uma conversa. Garanta de que todas as ramificações do seu tópico se conectem a este controle.
    Entrada do usuário Solicita e captura informações do usuário em uma conversa.
    Resposta de bot Exibe respostas de bot em uma conversa.
    Utilitários Executa ações e lógicas em um tópico, como executar um script ou adicionar diferentes caminhos de conversa (ramificações) em um tópico. Você também pode usá-los para chamar fluxos de trabalho Workflow Studio automatizados.
    Para controles que têm avisos, mensagens, valores padrão ou mensagens de confirmação, você pode inserir qualquer um dos valores de entrada a seguir:
    • Cadeias de caracteres de texto
    • Cápsulas de dados
    • Cadeias de caracteres com cápsulas de dados integrados
    • Scripts que retornam cadeias de caracteres

    Cápsulas de dados

    Use cápsulas de dados para adicionar informações dinâmicas aos seus controles com rapidez e facilidade sem usar um script. Selecione o ícone de cápsula de dados Ícone de cápsula de dados.para abrir a interface do seletor de cápsula de dados. Nesta interface, você pode selecionar dados de variáveis de script e de entrada definidas por seus controles de entrada do usuário.

    O uso de cápsulas de dados permite acessar dados de forma rápida e fácil em suas variáveis. Em contraste, o script oferece opções mais complexas, como o processo de tradução. Os exemplos a seguir ilustram como usar uma resposta de bot de texto que inclui o nome do cliente, processada como uma cápsula de dados e um script.

    Tabela 2. Respostas em script e cápsula de dados
    Método Resultado
    Cápsula de dados Seletor de cápsula de dados, mostrando as opções Variáveis de entrada e Variáveis de script.
    Seletor de cápsula de dados mostrando um controle de texto.
    Script Um exemplo de controle de texto mostrando uma entrada dinâmica com script.
    Um controle de texto usando uma mensagem resposta de script.

    O primeiro exemplo usa o selecionador de cápsula de dados para escolher Obter nome, uma variável de entrada que contém o nome do cliente. O segundo exemplo realiza a mesma coisa usando um script. O exemplo de script também usa gs.getMessage para processar a tradução da mensagem.

    Oculte ou ignore este nó (propriedade de condição)

    Quase todos os controles têm uma propriedade de condição. As exceções são o utilitário Decisão e os nós Inicial e Final.

    Em controles de entrada do usuário, a propriedade de condição determina se o controle é usado ou ignorado em uma conversa. Para usar o controle sempre, deixe o campo de condição em branco. Para determinar as condições em que o controle é usado, siga um dos seguintes processos:
    • Crie uma condição usando a interface do Construtor de condições, que permite adicionar cápsulas de dados para especificar condições criadas usando esta interface.
    • Forneça um script para a propriedade de condição que retorna um valor verdadeiro ou falso. Se o valor de retorno for falso, o controle não será usado e a conversa continuará para o próximo controle em toda essa ramificação do tópico.

    Use condições para deixar suas conversas mais dinâmicas, com base em contexto, os dados ou na lógica de script.

    Condição de script Condição do Construtor de condições
    Script de exemplo para mostrar o nó condicionalmente:
    (function execute() {
       var gr = new GlideRecord('incident');
       return gr.canCreate();
    })()
    Amostra do Construtor de condições que define o usuário com o seletor de cápsula de dados definido como Variáveis de entrada para o usuário.

    Neste exemplo, um script de condição retornará um valor verdadeiro se o usuário atual puder criar registros de incidentes. Esta condição impede que um controle de utilitários crie um incidente quando o usuário não tiver permissão para isso.