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


---

# Utilitário de bloco de tópicos

# Utilitário de bloco de tópicos {#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

Use um Bloco de tópicos em um Virtual Agentpara executar uma função ou subfluxo específico que executa determinadas etapas em um tópico de chamada.

## Propriedades do utilitário Bloco de tópicos {#va-topic-blocks__section_xwb_mgn_pdb}

Para obter mais informações, consulte [Adicione um bloco de tópico reutilizável a um tópico de chamada ou bloco de tópico](https://servicenow-prod.fluidtopics.net/JzTYm6XDMIHitqYLU6icIA "Adicione um bloco de tópico reutilizável a um tópico de chamada (primário) ou bloco de tópico para executar uma função ou tarefa específica no tópico de chamada. Você especifica os parâmetros de entrada usados no bloco de tópicos e os parâmetros de saída que são usados pelo tópico de chamada.").  
{#va-topic-blocks__table_nff_y1b_3db__entry__2}

| Propriedade | Descrição |
|-|-|
| Usar bloco de tópicos dinâmico | Defina esta alternância para ativar as opções de Bloco de tópico dinâmico. |
| Bloco de tópicos | Uma lista de blocos de tópicos publicados. Selecione um bloco de tópico para adicionar ao tópico de chamada. Com Usar bloco de tópico dinâmico ativo, use o construtor de condições para inserir uma condição ou script. |
| Nome do nó | Nome do nó do bloco de tópico. O nome é atribuído automaticamente com base no bloco de tópicos selecionado. Por exemplo, se você escolher o bloco de tópicos de Pesquisa contextual da Acme, o. Nome É a Pesquisa contextual da Acme. Com Usar bloco de tópico dinâmico ativo, insira um nome de sua escolha. |
| Mapeamento de entrada | As variáveis a serem usadas como entrada para o bloco de tópico selecionado. Por exemplo, a imagem a seguir tem exemplo de variáveis: O conteúdo desta área muda de acordo com o bloco de tópicos selecionado. As opções podem incluir entrada de cadeia de caracteres, registros referenciados, scripts e assim por diante. Com Usar bloco de tópico dinâmico Ativo, você adiciona todos os mapeamentos de entrada manualmente selecionando o ícone Gerenciar entradas para definir ![Ícone Gerenciar entradas para definir.](). As entradas são tratadas de forma semelhante à caixa de diálogo Parâmetros de entrada no segmento Iniciar de um [bloco de tópico reutilizável](https://servicenow-prod.fluidtopics.net/uYG8dY2B2w1jxUiHbHolhQ "Crie um componente reutilizável que execute um subfluxo específico de tarefas e elementos conversacionais no Virtual Agentconversas."). |
| Mapeamento de saída | As variáveis a serem geradas pelo bloco de tópicos selecionado. Por exemplo, a imagem a seguir tem exemplo de variáveis habilitadas: O conteúdo desta área muda de acordo com o bloco de tópicos selecionado. Com Usar bloco de tópico dinâmico Ativo, você adiciona todos os mapeamentos de entrada manualmente selecionando o ícone Gerenciar saídas para definir ![Ícone Gerenciar saídas para definir.](). As entradas são tratadas de forma semelhante à caixa de diálogo Parâmetros de entrada no segmento Iniciar de um bloco de tópico reutilizável. |
| Avançado ||
| Ocultar este nó ||
| Usar este nó condicionalmente se | Uma declaração de condição sem código ou script de baixo código que especifica uma condição para apresentar este nó na conversa. A condição deve ser avaliada como verdadeira. |
[ ]

{#va-topic-blocks__table_nff_y1b_3db}

## Exemplo de utilitários de bloco de tópico {#va-topic-blocks__section_jxd_nh5_tdb}

## Usando blocos de tópicos dinâmicos {#va-topic-blocks__section_p1r_ytb_jbc}

Alternar a configuração dinâmica no Bloco de tópicos permite que você escolha programaticamente qual bloco ou blocos de tópico invocar, com base em qualquer número de condições. Você pode passar um conjunto dinâmico de entradas sem uma correspondência explícita e um para um para uma definição de Bloco de tópicos.

Por exemplo, suponha que você tenha dois blocos de tópico. Um define sua senha, pegando seu nome de usuário e retornando uma mensagem de sucesso ou falha. O outro redefine sua senha, mas requer que você envie o token de autenticação de dois fatores (2FA) com a solicitação antes de retornar uma mensagem de sucesso ou falha e uma senha temporária.

Você pode criar duas invocações de Bloco de tópicos separadas para lidar com o procedimento de redefinição de senha ou criar um Bloco de tópicos com a configuração dinâmica ativa e definida da seguinte forma:  
* Adicione um script que verifique se o tipo de redefinição é `IncludesTwoFactor: Verdadeiro `. Se a declaração for avaliada como verdadeiro , então você retorna `Redefinição de Faco `, caso contrário, você retornará `Redefinição de senha normal `.
* Defina dois mapeamentos de entrada: `senha `e. `TwoFactorToken `, ambos definidos como iguais a um objeto passado que contém seus valores.
* Defina dois mapeamentos de saída: `bem-sucedido `e. `TempPass `, O último dos quais só será definido se existir no valor de retorno do Bloco de tópicos.
* Defina dois nós de saída para o sucesso ou falha da saída e uma saída para confirmar se o. `TempPass `o valor é verdadeiro.
{#va-topic-blocks__ul_z5h_w5b_jbc}

## Exemplo de expressão de bloco de tópico dinâmico {#va-topic-blocks__section_b5f_zs1_jbc}

    (function execute() {
        /* Return the name of the topic block to run. For example:
            switch (vaVars.car_make) {
                case 'Ford':
                    return 'Ford troubleshooting';
                case 'Toyota':
                    return 'Toyota troubleshooting';
                default:
                    return 'General car troubleshooting';
            }
        */
    })()

O script na expressão de bloco de tópico dinâmico retorna um valor com base na sua entrada. Neste exemplo, se você inserir <kbd class="ph userinput">Ford </kbd>ou <kbd class="ph userinput">Toyota </kbd>, O Virtual Agent chamará o tópico de solução de problemas apropriado. Se você inserir qualquer outro valor, o Virtual Agent retornará um tópico geral de solução de problemas.

