Crie um bloco de tópico reutilizável

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 5 min. de leitura
  • Crie um componente reutilizável que execute um subfluxo específico de tarefas e elementos conversacionais no Virtual Agent conversas.

    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 Configure privilégios de acesso entre escopos para blocos de tópicos e controles personalizados.

    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é Tudo > Interfaces conversacionais > Virtual Agent > Designer.
    2. Na página inicial, execute um dos seguintes 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 de cabeçalho, selecione Duplicado .
        2. Insira o nome do novo bloco e selecione Salvar .
    3. Na planilha, preencha os campos.
      Tabela 1. Folha de propriedades do bloco de tópicos
      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 criado para ele. Para obter mais informações sobre canais, consulte Implantando tópicos Virtual Agent em outros canais.

      Atendente
      Variáveis de contexto do atendente Variáveis de contexto do atendente definidas no Configurações gerais de bate-papo .

      Selecione as variáveis que fornecem contexto dinâmico, o que significa informações do Virtual Agent bate-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.

      Disponível para piloto automático do 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 .

      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 para seus blocos de tópicos.
    4. Selecione Criar.
      . Fluxo a guia é aberta. A tela exibe um fluxo com um Iniciar e. Fim nó.
    5. Para definir uma entrada para o bloco, faça o seguinte:
      1. Selecione Iniciar nó na tela.
      2. Na guia Propriedades do segmento inicial, selecione Adicionar
      3. Na planilha, preencha os campos.
        Tabela 2. Adicionar caixa de diálogo de variável de entrada
        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 Agent 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:

        Dica da ferramenta de mapeamento de variável de entrada neste exemplo exibindo "cadeia de caracteres de dica de teste".

        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.

        Por exemplo, o bloco de tópicos de Pesquisa contextual pré-criado fornece os seguintes parâmetros de entrada:

        Os parâmetros de entrada para o bloco de tópicos de Pesquisa contextual incluem contexto, consulta, portal e kb_knowledge_base.

      4. Selecione Save (Salvar).
      O tópico de chamada ou bloco de tópico passa parâmetros de entrada para o bloco de tópicos.
    6. Arraste Designer do Virtual Agent controles 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 assistente controles.
    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).
        Por exemplo, o bloco de tópico de Pesquisa contextual pré-criado passa os seguintes parâmetros de saída:

        Os parâmetros de saída para o bloco de tópicos de Pesquisa contextual incluem resultados retornados e resultados úteis.

      4. Selecione Save (Salvar).
      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.

      A janela de visualização exibe a conversa de bate-papo e uma seção somente visualização que mostra as variáveis de saída e seus valores. Por exemplo, "results_útil":true.

    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.