Criar um bloco de tópico reutilizável

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é Todos > Interfaces conversacionais > Virtual Agent > Designer.
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.
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:
      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:

      

   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 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).
      Por exemplo, o bloco de tópicos de Pesquisa contextual pré-criado fornece os seguintes parâmetros de entrada:

      

   4. Clique em 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.

   

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