Criar um bloco de tópico reutilizável

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 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.

    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é Tudo > Interfaces conversacionais > Virtual Agent > Designer.
    2. Na página inicial, 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.
    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 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 criadas para ela. Para obter mais informações, consulte Implantando tópicos Virtual Agent em outros 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.

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

      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.

      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 para seus blocos de tópico.
    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.
        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 tópicos Virtual Agent.

        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 do bloco de tópicos da Pesquisa contextual incluem contexto, consulta, portal e kb_knowledge_base.

      4. Selecione Salvar.
      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.
    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 folha Propriedades do segmento final, selecione + 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).
        Por exemplo, o bloco de tópicos de Pesquisa contextual pré-criado fornece os seguintes parâmetros de entrada:

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

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

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

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