Criar um controle personalizado Virtual Agent

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 3 min. de leitura
  • Crie um controle de resposta personalizado que os autores do tópico possam usar em tópicos ou blocos de tópicos. Em conversas Virtual Agent, um controle de entrada coleta informações dos usuários finais, enquanto um controle de resposta exibe informações para os usuários finais.

    Antes de Iniciar

    Criar a definição de controle personalizada.

    Importante:
    Para implementar entradas seguras (password2) em seu controle personalizado Virtual Agent, você deve aderir aos requisitos de aplicação com escopo em Workflow Studio. Para obter detalhes, consulte Requisitos de aplicação com escopo Workflow Studio para entradas seguras.
    Dica:
    Os desenvolvedores e autores de tópicos podem precisar acessar controles personalizados criados em outros escopos da aplicação. 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

    Procedimento

    1. Navegar até Tudo > Interfaces conversacionais > Virtual Agent > Designer.
    2. Na página inicial, selecione Criar.
    3. No formulário, preencha os campos.
      Tabela 1. Formulário de propriedades
      Campo Descrição
      Tipo

      Lista de ativos que você pode criar em Designer do Virtual Agent.

      Escolha o tipo de controle personalizado:
      • Controle da Entrada Personalizada
      • Controle da Resposta Personalizada
      Nome Nome exclusivo para o controle personalizado que reflete sua finalidade.
      Descrição Breve explicação da finalidade e funcionalidade do controle.
      Propriedades avançadas (opcional)
      Tornar entradas seguras

      [Somente controles de entrada personalizados]

      Habilitar Comutador de alternância que permite que um controle de entrada personalizado passe por entradas seguras, como senhas.
      Disponível na paleta
      Habilitar Chave de alternância que determina se o controle personalizado aparece como seu próprio ícone na seção Utilitários da paleta na guia Fluxo. Isso fornece acesso fácil ao controle para outros autores.
      Adicional
      Categorias Lista de categorias. As categorias identificam e agrupam tópicos relacionados, blocos de tópicos ou controles personalizados. Se aplicável, escolha uma categoria para o seu controle.
    4. Selecione Criar.
      A guia Fluxo é aberta e exibe um fluxo inicial que contém um nó de controle personalizado.
    5. Selecione o nó Início e defina os parâmetros de entrada para o controle.
      Os autores do tópico fornecerão esses parâmetros e valores de entrada do tópico de chamada.
      1. Selecione + Adicionar.
      2. No formulário, 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.

      3. Selecione Save (Salvar).
      4. Repita essas etapas para parâmetros adicionais.
    6. Selecione o nó Final e defina os parâmetros de saída e os valores retornados do controle personalizado.
      Os autores do tópico podem usar o valor de saída no tópico de chamada.
      1. Selecione + Adicionar novo.
      2. Insira o nome e o valor do parâmetro.
      3. Repita essas etapas para parâmetros adicionais.
      4. Selecione Save (Salvar).
    7. Selecione o nó de controle personalizado e preencha a folha de propriedades da seguinte forma:
    8. Para criar o controle, selecione Salvar e Publicar.

    Resultado

    Se você selecionou Disponível na paleta na página Propriedades, o ícone Controle personalizado será exibido como seu próprio ícone na seção Utilitários da paleta. O controle está listado na página Tópicos e você pode usar o menu Tipo para mostrar somente controles personalizados.

    O que Fazer Depois

    Adicione um controle personalizado a um tópico ou bloco de tópicos Virtual Agent..