--- sourceDocument: Interfaces conversacionais do Xanadu sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/conversational-interfaces Release : - xanadu ft:locale : - pt-BR ft:publication_title : - Interfaces conversacionais do Xanadu ft:clusterId : - convint bundleId : - convint workflow : - Platform --- # Criar um bloco de tópico reutilizável # Criar um bloco de tópico reutilizável {#ariaid-title1} * Versão de lançamento: Xanadu * * Atualizado 1 de ago. de 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 min. de leitura Crie um componente reutilizável que execute um subfluxo específico de tarefas e elementos de conversa em Virtual Agent conversas. ## Antes de Iniciar Dica: Desenvolvedores e autores de tópicos podem precisar acessar blocos de tópicos criados em outros escopos de aplicações. Para conceder acesso a eles, consulte [Criar privilégios de acesso entre escopos para blocos de tópico e controles personalizados](https://servicenow-prod.fluidtopics.net/9fTxd6Fu80xiT85iouo2Cw "Permita que os autores e desenvolvedores de tópicos acessem blocos de tópicos Virtual Agent e controles personalizados de outras aplicações com escopo."). Função necessária: virtual_agent_admin ou admin ## Por Que e Quando Desempenhar Esta Tarefa Use blocos de tópico para executar etapas comuns, como recuperar determinados registros. ## Procedimento 1. Navegar até TodosInterfaces conversacionaisVirtual AgentDesigner. 2. Na página de tópicos, siga um destes procedimentos: * Para criar um bloco de tópicos do zero, selecione + Criar. * Para criar um bloco de tópicos com base em um bloco de tópicos pré-criado, abra o bloco de tópicos e faça o seguinte: 1. Na barra de cabeçalho, selecione Duplicar. 2. Insira o nome do novo bloco e selecione Salvar. {#create-topic-blocks__ol_mdm_xxn_fpb} {#create-topic-blocks__choices_pbh_sxn_fpb} 3. Na planilha, preencha os campos. {#create-topic-blocks__table_jlp_q1z_njb__entry__2} | Campo | Descrição | |-|-| | Tipo | Lista de itens que você pode criar em Designer do Virtual Agent. Selecione Bloco de tópicos e defina as propriedades adicionais. Nota: Depois de definir este tópico como um bloco de tópicos, você não poderá alterá-lo para um tópico normal. | | Nome | Nome exclusivo para o bloco de tópico que reflete sua finalidade funcional. Este nome aparece na lista de blocos de tópico que os autores de tópico podem escolher ao criar ou atualizar um tópico. | | Descrição | Breve explicação da finalidade do bloco de tópicos. Por exemplo, para recuperar registros. | | Propriedades avançadas (opcional) || | Quem pode acessar este tópico || | Canais | Clientes de bate-papo nos quais o tópico ou bloco de tópicos será executado. Esses canais são diferentes dos canais padrão que têm suporte nativo do Virtual Agent. Sua instância pode ter canais adicionais para [integrações de bate-papo personalizadas](https://servicenow-prod.fluidtopics.net/F8vvCjzln7z5T_fdKMXXzg "A estrutura de integração de bate-papo personalizada de conversação é uma estrutura avançada que consiste em APIs programáveis e configurações para trazer o ServiceNow Virtual Agent para qualquer interface de conversação.") criadas para ela. Para obter mais informações, consulte [Implantando tópicos Virtual Agent em outros canais](https://servicenow-prod.fluidtopics.net/obvKbVFeVu9X8DMCwcGIew "Ao criar um tópico ou bloco de tópicos, você pode especificar os canais de bate-papo nos quais o tópico ou bloco de tópicos será executado. Durante o design de conversa, Designer do Virtual Agent fornece proteções internas para ajudá-lo a personalizar suas conversas para esses canais."). | | Atendente || | Variáveis de contexto do atendente. | Variáveis de contexto do agente em tempo real que são definidas nas [Configurações gerais de bate-papo](https://servicenow-prod.fluidtopics.net/evbxw7r1efhtkDRdKu7_hw "Especifique variáveis de contexto de bate-papo, também chamadas de variáveis de bate-papo do Atendente, para armazenar informações relacionadas ao bate-papo, como respostas a pesquisas de antes do bate-papo. Essas variáveis contêm informações contextuais que podem ser usadas para determinar a intenção do tópico ou controlar como os bate-papos são encaminhados para atendentes. Você também pode definir variáveis para capturar informações contextuais passadas em scripts de tópico do Virtual Agent para compartilhar com atendentes."). Selecione as variáveis que fornecem contexto dinâmico, o que significa informações do bate-papo Virtual Agent. Essas informações são transferidas da conversa do bot para o atendente. Para obter informações sobre a lista padrão de variáveis de agente dinâmico, consulte [Variáveis de contexto do atendente.](https://servicenow-prod.fluidtopics.net/XAQdFgdZ6l4y1cipnVPZig "Use variáveis de contexto de bate-papo para transmitir determinadas informações do tópico para atendentes ou para controlar como as conversas de bot são roteadas para os atendentes. O Virtual Agent inclui algumas variáveis padrão, e você pode definir novas."). | | Disponível para piloto automático de agente | Comutador de alternância que determina se o bloco de tópicos está disponível para um atendente. Quando habilitado, um agente pode pesquisar o tópico e invocá-lo. Para obter detalhes, consulte [Piloto automático para conversas](https://servicenow-prod.fluidtopics.net/W2vX7NhmEb8BCJjHbY4j3Q#ci-conversation-autopilot "Os agentes podem usar o Piloto automático para conversas para exibir tópicos do Virtual Agent durante as conversas do Bate-papo do agente. Enquanto o solicitante interage com os tópicos do Virtual Agent, os agentes podem realizar outras tarefas e trabalhar em outros itens. O Piloto automático para conversas não está disponível para Prestação de serviços de RH (HRSD)."). | | Disponível na paleta || | Habilitar | Comutador de alternância que determina se o bloco de tópicos aparece como seu próprio ícone na seção Utilitários da paleta na guia Fluxo. Isso fornece acesso fácil ao bloco de tópicos para outros autores. | | Adicional || | Categorias | Categoria que contém este bloco. Você pode definir [categorias de tópico personalizadas](https://servicenow-prod.fluidtopics.net/9MzMKV2bOWici5XGdwdL5w "Crie ou altere categorias personalizadas para organizar e agrupar objetos relacionados Virtual Agent, como tópicos. Você também pode tornar os rótulos de categoria visíveis no menu do seletor de tópicos exibido para os usuários finais.") para seus blocos de tópico. | [Tabela 1. Folha de propriedades do bloco de tópicos] {#create-topic-blocks__table_jlp_q1z_njb} 4. Selecione Criar. A guia Fluxo é aberta. A tela exibe um fluxo com um nó Iniciar e um nó Finalizar. 5. Para definir uma entrada para o bloco, faça o seguinte: 1. Selecione o nó Iniciar na tela. 2. Na folha Propriedades do segmento inicial, selecione + Adicionar 3. Na planilha, preencha os campos. {#create-topic-blocks__id_w2q_ksz_gpb__entry__2} | Campo | Descrição | |-|-| | Nome | Nome da variável de entrada que armazena o valor de entrada. | | Tipo | Tipo de dados que estão sendo passados para o bloco de tópicos. Por exemplo, String, Booleane assim por diante. Os campos mudam de acordo com sua escolha. Para obter mais informações, consulte [Tipos de dados de entrada em tópicos Virtual Agent](https://servicenow-prod.fluidtopics.net/uPsxMHHTekvnOXgK_EHFpA "Você pode definir entradas de tipos de dados Glide Virtual Agent (com.glide.cs.chatbot) usados normalmente em Designer do Virtual Agent sem escrever um script. Defina o tipo de dados de entrada no nó inicial de um controle personalizado ou bloco de tópicos."). | | Necessários | Opção para definir o parâmetro conforme necessário. | | Dica | Dica de ferramenta visível ao criar um tópico de chamada. Veja o exemplo a seguir: | | Tabela | ServiceNow tabela que é usada para consultar a entrada. Este campo estará disponível somente quando Referência ou Matriz.Referência for selecionado no campo Tipo. | | Número máximo de linhas | Número máximo de linhas que o bloco de tópico tem permissão para definir. Este campo estará disponível somente quando Matriz for selecionado no campo Tipo. | | Valor Padrão | Valor padrão para a variável. Este valor pode ser usado ao visualizar o bloco. Valores padrão duplicados não são permitidos com tipos de dados de matriz. | [Tabela 2. Adicionar caixa de diálogo de variável de entrada] {#create-topic-blocks__id_w2q_ksz_gpb} Por exemplo, o bloco de tópicos de Pesquisa contextual pré-criado fornece os seguintes parâmetros de entrada: 4. Selecione Salvar. {#create-topic-blocks__substeps_hqh_hnz_njb} O tópico de chamada ou bloco de tópico passa parâmetros de entrada para o bloco de tópico. 6. Arraste os controles do Designer do Virtual Agent para a tela. Esses controles incluem a entrada, respostas de bot e utilitários. Use-os em combinação para definir a lógica que é executada no bloco de tópicos. Para obter mais informações, consulte [controles Designer do Virtual Agent](https://servicenow-prod.fluidtopics.net/hdI771iTrNpEBwCAW3eRmw "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."). 7. Para definir a saída retornada do bloco de tópicos, faça o seguinte: 1. Selecione o nó Finalizar na tela. 2. Na planilha Propriedades do segmento final, clique em + Adicionar novo. 3. Na planilha, preencha os campos seguintes. * Nome: nome da variável que identifica um valor retornado do bloco de tópicos. * Valor: Uma cadeia de caracteres com variáveis ou um script que pode ser usado no tópico de chamada. O Valor é apresentado como cápsulas de dados para as variáveis de entrada que você definiu (o Valor Padrão especificado nos Parâmetros de Entrada e os valores de entrada do nó no bloco de tópico). {#create-topic-blocks__ul_af4_kzm_1kb} Por exemplo, o bloco de tópicos de Pesquisa contextual pré-criado fornece os seguintes parâmetros de entrada: 4. Clique em Salvar. {#create-topic-blocks__substeps_npf_f5b_sjb} Quando o bloco de tópicos termina de ser executado no tópico de chamada, ele pode passar variáveis de saída para o tópico de chamada. 8. Para ver como o bloco de tópico é executado, selecione Teste. Por exemplo, o bloco de tópicos de Pesquisa contextual retornou os seguintes resultados, incluindo uma mensagem somente de visualização com os valores de saída. A mensagem de visualização ajuda a verificar as saídas esperadas e não está visível para os usuários. 9. Se você estiver pronto para disponibilizar o bloco de tópicos para uso em tópicos de chamada, faça o seguinte: 1. Remova os parâmetros padrão que você usou para teste. 2. Selecione Salvar e depois clique em Publicar. O estado do bloco de tópico muda para Ativo e está pronto para uso em tópicos de chamada. ## O que Fazer Depois [Adicione um bloco de tópico reutilizável a um tópico de chamada ou bloco de tópico.](https://servicenow-prod.fluidtopics.net/H2pUqEmMUSxIN7Crm5ITEQ "Para executar uma função específica ou tarefa, inclua um bloco de tópico reutilizável em um tópico de chamada (pai) ou bloco de tópico. 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.").