--- 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 --- # Crie um bloco de tópico reutilizável # Crie um bloco de tópico reutilizável {#ariaid-title1} * Versão de lançamento: Yokohama * * Atualizado 30 de jan. de 2025 * * ![](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 conversacionais no Virtual Agentconversas. ## Antes de Iniciar Dica: Os desenvolvedores e autores de tópicos podem precisar acessar blocos de tópicos criados em outros escopos da aplicação. Para conceder acesso, consulte [Crie privilégios de acesso entre escopos para blocos de tópicos e controles personalizados](https://servicenow-prod.fluidtopics.net/7cVc7eWdzFO3l6MmBn2nZQ "Permita que autores e desenvolvedores de tópicos acessem Virtual Agentblocos de tópicos 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ópicos para executar etapas comuns, como recuperar determinados registros. ## Procedimento 1. Navegar até TudoInterfaces conversacionaisVirtual AgentDesigner. 2. Na página inicial, siga um destes procedimentos: * Para criar um bloco de tópico do zero, selecione Criar . * Para criar um bloco de tópico com base em um bloco de tópico pré-criado, abra o bloco de tópico e faça o seguinte: 1. Na barra do cabeçalho, selecione Duplicado . 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 definem 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 regular. | | Nome | Nome exclusivo do bloco de tópicos que reflete sua finalidade funcional. Este nome aparece na lista de blocos de tópicos que os autores de tópicos 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ópico será executado. Esses canais são diferentes dos canais padrão compatíveis nativamente com Virtual Agent. Sua instância pode ter canais adicionais para [integrações de bate-papo personalizadas](https://servicenow-prod.fluidtopics.net/ZxeaMtO~hxqXCiJyr0PSZg "A estrutura de integração de bate-papo personalizada conversacional é uma estrutura poderosa que consiste em APIs de script e configurações para trazer o. ServiceNow Virtual Agentpara qualquer interface conversacional.")criado para ele. Para obter mais informações sobre canais, consulte [Implantando Virtual Agenttópicos em outros canais](https://servicenow-prod.fluidtopics.net/7XguEooj3o_Te57h8Gb4ZQ "Ao criar um tópico ou bloco de tópico, você pode especificar os canais de bate-papo nos quais o tópico ou bloco de tópico será executado. Durante o design da conversa, Designer do Virtual Agentfornece proteções integradas para ajudar você a personalizar suas conversas para esses canais."). | | Atendente || | Variáveis de contexto do atendente | Variáveis de contexto do atendente definidas no [Configurações gerais de bate-papo](https://servicenow-prod.fluidtopics.net/iy0Te9CvWKb14vIwpL8H4w "Especifique variáveis de contexto de bate-papo, também chamadas Atendentevariáveis de bate-papo, para armazenar informações relacionadas ao bate-papo, como respostas de pesquisa pré-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 roteados para agentes ativos. Você também pode definir variáveis para capturar informações contextuais passadas Virtual Agentscripts de tópico para compartilhar com os atendentes em tempo real."). Selecione as variáveis que fornecem contexto dinâmico, o que significa informações do Virtual Agentbate-papo. 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 do atendente, consulte [Variáveis de contexto do bate-papo do atendente](https://servicenow-prod.fluidtopics.net/DjPm~H5WqO3EumyyMZAaJg "Use variáveis de contexto de bate-papo para passar determinadas informações do tópico para compartilhar com um atendente ou para controlar como as conversas de bot são roteadas para os atendentes. Virtual Agentinclui algumas variáveis padrão e você pode definir novas."). | | Disponível para piloto automático de agente | Chave 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 invocar o tópico. Para obter detalhes, consulte [Piloto automático de conversa](https://servicenow-prod.fluidtopics.net/_icQovqJ7MUfR5yFlziGnQ#ci-conversation-autopilot "Os agentes podem usar o piloto automático de conversa para exibir Virtual Agenttópicos durante Bate-papo do agenteconversas. Enquanto o solicitante interage com o. Virtual Agent, os agentes podem executar várias tarefas e trabalhar em outros itens. O piloto automático de conversa não está disponível para Prestação de serviços de RH(HRSD)."). | | Disponível na paleta || | Habilitar | Chave de alternância que determina se o bloco de tópicos aparece como seu próprio ícone na seção Utilitários da paleta no 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/3p9GypVyZ47QkybdiOUFoA "Crie ou altere categorias personalizadas para organizar e agrupar relacionadas Virtual Agentativos, 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ópicos. | [Tabela 1. Folha de propriedades do bloco de tópicos] {#create-topic-blocks__table_jlp_q1z_njb} 4. Selecione Criar. . Fluxo a guia é aberta. A tela exibe um fluxo com um Início e. Fim nó. 5. Para definir uma entrada para o bloco, faça o seguinte: 1. Selecione Início nó na tela. 2. Na guia Propriedades do segmento inicial, selecione E 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 Virtual Agenttópicos](https://servicenow-prod.fluidtopics.net/zJ1b4zZTs6CSWVO6pzSXAw "Você pode definir entradas do Glide comumente usado Virtual Agent(com.glide.cs.chatbot) tipos de dados em Designer do Virtual Agentsem escrever um script. Defina o tipo de dados de entrada no nó Iniciar de um bloco de tópico ou controle personalizado."). | | 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ópicos passa parâmetros de entrada para o bloco de tópicos. 6. Arraste Designer do Virtual Agentcontroles na tela. Esses controles incluem 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 [Designer do Virtual Agent controles](https://servicenow-prod.fluidtopics.net/XLB40FlvSx0Tcu9KBduDtA "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."). 7. Para definir a saída retornada do bloco de tópicos, faça o seguinte: 1. Selecione Fim nó na tela. 2. Na guia Propriedades do segmento final, selecione - Adicionar novo . 3. Na planilha, preencha os campos a seguir. * Nome : Nome do 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. . 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 nos valores de entrada do nó no bloco de tópicos). {#create-topic-blocks__ul_af4_kzm_1kb} Por exemplo, o bloco de tópico de Pesquisa contextual pré-criado passa os seguintes parâmetros de saída: 4. Selecione Salvar. {#create-topic-blocks__substeps_npf_f5b_sjb} Quando o bloco de tópico 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ópicos é executado, selecione Teste . Por exemplo, o bloco de tópico 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 pode ser visualizada para os usuários. 9. Se você estiver pronto para disponibilizar o bloco de tópicos para uso na chamada de tópicos, faça o seguinte: 1. Remova os parâmetros padrão que você usou para testar. 2. Selecione Salvar e, em seguida, selecione Publicar . O estado do bloco de tópicos 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/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.").