--- sourceDocument: Interfaces conversacionais de Yokohama sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/conversational-interfaces Release : - yokohama ft:locale : - pt-BR ft:publication_title : - Interfaces conversacionais de Yokohama ft:clusterId : - convint bundleId : - convint workflow : - Platform --- # Designer do Virtual Agent controles # Designer do Virtual Agent controles {#ariaid-title1} * Versão de lançamento: Yokohama * * Atualizado 30 de jan. de 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 min. de leitura R Virtual Agento tópico consiste em uma coleção de controles em um fluxo de tópicos. Use esses controles para coletar, processar e apresentar informações para seus 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. {#virtual-agent-controls__table_ubt_ywt_d2b__entry__2} | 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 começa. | | 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 término de uma conversa. Certifique-se de que todas as ramificações do seu tópico se conectem a este controle. | | [Entrada do usuário](https://servicenow-prod.fluidtopics.net/Rwp03gWqB~lzBK~VXQ3APg "Use a coleção de controles de entrada fornecida por Designer do Virtual Agentpara solicitar e capturar informações do usuário em uma conversa.") | Solicita e captura informações do usuário em uma conversa. | | [Resposta de bot](https://servicenow-prod.fluidtopics.net/WqLMvdULfAdk3q96lBxD1g "Designer do Virtual Agent oferece vários controles para exibir respostas de bot em uma conversa. Como as respostas do bot ocorrem em plataformas de terceiros, o formato de cada saída pode variar.") | Exibe respostas de bot em uma conversa. | | [Utilitários](https://servicenow-prod.fluidtopics.net/ycC9cWDixiWplxfLHiGdVg "Você pode controlar interações em um tópico usando utilitários em Designer do Virtual Agent. Esses utilitários executam várias ações, como adicionar blocos de tópicos (componentes reutilizáveis), executar um script ou adicionar caminhos de conversa diferentes (ramificações) em um tópico. Os utilitários são representados como nós em um fluxo de conversa, mas não exibem nada para o usuário.") | Lida com ações e lógica em um tópico, como executar um script ou adicionar caminhos de conversa diferentes (ramificações) em um tópico. Você também pode usá-los para chamar automatizado Workflow Studiofluxos de trabalho. | [Tabela 1. Tipos de controle] {#virtual-agent-controls__table_ubt_ywt_d2b} Para controles que têm prompts, mensagens, valores padrão ou mensagens de confirmação, você pode inserir qualquer um dos seguintes valores de entrada: * Cadeias de caracteres de texto * Cápsulas de dados * Cadeias de caracteres com cápsulas de dados integradas * Scripts que retornam cadeias de caracteres {#virtual-agent-controls__ul_qf1_1gy_c3b} ## Cápsulas de dados {#virtual-agent-controls__section_i2c_mgz_1gb} Use cápsulas de dados para adicionar informações dinâmicas aos controles de forma rápida e fácil 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 variáveis de entrada definidas pelos controles de entrada do usuário. O uso de cápsulas de dados permite que você acesse rápida e facilmente os dados em suas variáveis. Em contraste, o script fornece opções mais complexas, como lidar com a tradução. Os exemplos a seguir ilustram como usar uma resposta de bot de texto que inclui o nome do cliente, tratada como uma cápsula de dados e um script. {#virtual-agent-controls__table_qkt_kv5_bgb__entry__2} | Método | Resultado | |-|-| | Cápsula de dados | | | Cápsula de dados | | | Script | | | Script | ![Um controle de texto mostrando uma mensagem de resposta dinâmica com script.]() | [Tabela 2. Cápsula de dados e respostas com script] {#virtual-agent-controls__table_qkt_kv5_bgb} O primeiro exemplo usa o seletor 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 lidar com a tradução da mensagem. ## Ocultar ou ignorar este nó (propriedade de condição) {#virtual-agent-controls__section_lmr_5wt_d2b} Quase todos os controles têm uma propriedade de condição. As exceções são o utilitário de decisão e os nós inicial e final. Nos controles de entrada do usuário, a propriedade Condição determina se o controle é usado ou ignorado em uma conversa. Para sempre usar o controle, deixe o campo Condição em branco. Para determinar as condições sob as quais o controle é usado, execute um dos seguintes procedimentos: * 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 retorne 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 ao longo dessa ramificação do tópico. {#virtual-agent-controls__ul_szm_tdp_rsb} Use condições para tornar suas conversas mais dinâmicas com base no contexto, nos dados ou na lógica com script. {#virtual-agent-controls__table_xgn_qy5_bgb__entry__2} | Condição de script | Condição do construtor de condições | |-|-| | Script de amostra para mostrar condicionalmente o nó: (function execute() { var gr = new GlideRecord('incident'); return gr.canCreate(); })() | | [ ] {#virtual-agent-controls__table_xgn_qy5_bgb} Neste exemplo, um script de condição retornará um valor verdadeiro se o usuário atual puder criar registros de incidente. Esta condição impede que um controle de utilitários crie um incidente quando o usuário não tem permissão para fazê-lo.