Guia Fluxo de tópico

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 7 min. de leitura
  • Use a guia Fluxo de tópico para criar o fluxo de conversa. Use os controles para entradas de usuário, respostas de bot e utilitários para definir o fluxo.

    Guia Fluxo (exibição padrão)

    Figura 1. Exemplo da guia Fluxo na exibição padrão
    Exibição da guia Fluxo do tópico Designer do Virtual Agent com 10 textos explicativos realçados. Para a descrição de texto, consulte a tabela a seguir.
    Tabela 1. Legenda (exibição padrão)
    Recurso Descrição
    1. Barra de navegação Trilhas para navegar do design de volta para a página Tópicos. Ao atualizar designs, o canto direito exibe uma mensagem indicando o status do design. Por exemplo, uma mensagem pode indicar que você tem mudanças não publicadas para os mapeamentos de idioma do seu tópico ou do Compreensão da linguagem natural (NLU).
    2. Barra de cabeçalho do tópico Guias e opções de design para seu tópico:
    • Guias: cada guia apresenta uma exibição diferente para trabalhar na sua conversa.
    • Exibição de tabela: opção que mostra uma exibição de tabela dos nós no fluxo de conversa. Você pode usar esta opção para alternar entre a exibição de tabela e a exibição de diagrama ao projetar sua conversa.
    • Ativo/inativo: opção que muda o estado do design para que ele fique ativo (disponível aos usuários) ou inativo (em desenvolvimento e não disponível aos usuários). Selecione essa opção para ver as opções a seguir:
      • Incluído na descoberta de tópicos: opção para permitir que o tópico seja descoberto por meio de palavras-chave, NLU ou Serviço Now LLM. Se inativo, o tópico será incluído ao executar fallback de pesquisa.
      • Incluído na lista de tópicos: opção para tornar o tópico visível na lista de tópicos "Mostrar tudo".
    • Salvar: salva o design atual.
    • Teste: abre o design em uma janela de teste de bate-papo para que você possa visualizar e testar a conversa. Se o painel do Now Assist ou a aplicação Microsoft Teams estiverem configurados para o seu ambiente, as opções de visualização desses canais serão exibidas na lista de botões de teste. Clique em Visualizar no painel do Now Assist ou em Exibição no Microsoft Teams na lista para testar seu tópico nesses ambientes.
    • Publicar: ativa o design e o disponibiliza aos clientes do bate-papo. Se você estiver usando modelos de NLU específicos ao idioma, selecione Revisar e publicar na lista Publicar para especificar os idiomas.
    • Ícone de mais ações nos tópicos
      • Duplicar: copiar o design atual para criar uma versão não publicada do design.
      • Excluir: remover a versão atual e publicada do design.
    3. Paleta Barra lateral recolhível com as guias Componentes e Variáveis.
    A guia Componentes mostra uma lista de controles que você pode arrastar para a tela para criar uma conversa. Os seguintes tipos de controles estão disponíveis:
    • Entrada do usuário: controles usados para solicitar e capturar informações do usuário em uma conversa. Quando Now Assist está habilitado e você está trabalhando com um tópico de modelo de linguagem grande (LLM), a seção Entrada do usuário habilitada para LLM indica quais controles são compatíveis com LLM.
    • Resposta do bot: controles para exibir as respostas do Virtual Agent em uma conversa.
    • Utilitários: controles para executar ações em um tópico, como executar um script, adicionar diferentes caminhos de conversa (ramificações) em um tópico ou adicionar blocos de tópico.
    A guia Variáveis inclui entradas e scripts.
    Seção de entradas
    • Variáveis do atendente especificadas na guia Propriedades do tópico para fornecer informações contextuais da sessão do Virtual Agent para o atendente.
    • Variáveis de entrada definidas por controles de entrada do usuário e utilitários adicionados ao fluxo na tela.
    • Entidades NLU "sem nó" adicionadas pelo autor do tópico que são usadas como variáveis de entrada preenchidas por slot para o tópico.
    Seção de scripts
    A seção de scripts inclui os scripts encontrados nos nós da tela. O autor do tópico pode adicionar mais variáveis de script para armazenar valores fora das variáveis de controle. As variáveis de script permitem cenários de script mais complexos.
    4. Tela Área que exibe o fluxo da conversa graficamente. Ao arrastar um controle para a tela, ele se torna um nó no fluxo de conversa. Inclui uma folha de propriedades associada que é aberta no painel à direita. Cada fluxo tem um nó inicial e um final. Ao adicionar ou remover controles, o layout dos controles na tela é ajustado automaticamente.
    5. Pesquisa de nó Opção para encontrar rapidamente nós específicos no fluxo de conversa. Selecione o ícone de pesquisa de nós para expandir o campo de pesquisa e insira o nome do nó que você deseja encontrar. Quando um nó correspondente é encontrado, ele é realçado no fluxo. Use as setas para a esquerda ou direita para pesquisar o nó anterior ou o próximo que corresponda ao nome do nó de pesquisa.
    Figura 2. Pesquisa de nós mostrando o nó realçado
    Pesquisa de nó, mostrando o nó realçado no fluxo e a barra de pesquisa realçada.
    6. Folha de propriedades Propriedades específicas do nó selecionado na tela. A lista de propriedades muda com base no nó selecionado. Cada nó tem seu próprio conjunto de propriedades que pode ser definido por você e pode incluir scripts que controlam o comportamento ou o processamento realizado no nó. Se o NLU estiver habilitado, as folhas de propriedades dos controles de entrada terão campos de NLU adicionais. Para obter mais informações, consulte controles Designer do Virtual Agent
    7. Selecionador de cápsula de dados Uma ferramenta para selecionar cápsulas de dados de variáveis de entrada ou de script para usar no campo de propriedade. Escolha o selecionador de cápsula de dados para eleger a partir das variáveis existentes acessíveis no tópico. Você também pode arrastar cápsulas de dados diretamente para os campos de propriedade.
    8. Editor de scripts Uma ferramenta para adicionar ou editar JavaScripts usados em uma propriedade. Fornece assistência de script, incluindo uma lista de elementos válidos no ponto de inserção. Os elementos incluem o nome da função, nomes de objeto e nomes de variáveis disponíveis para o tópico Para obter mais informações, consulte o Editor de sintaxe JavaScript.
    9. Guia da folha de propriedades Abre a exibição da folha de propriedades do nó selecionado no momento na tela.
    10. Guia Recursos Abre a exibição Recursos úteis, que contém um link para a documentação do produto. Em um tópico habilitado para LLM, outros recursos aparecem, incluindo tours guiados na tela e links para vídeos para controles habilitados para LLM.

    Guia de recursos úteis em um tópico do LLM, mostrando links para tour guiado, vídeo e documentação do produto.

    Guia Fluxo com Exibição de tabela habilitada

    A maior parte da funcionalidade da guia Fluxo é a mesma na Exibição de tabela. A figura e a tabela a seguir destacam as diferenças.

    Figura 3. Exemplo de guia Fluxo na Exibição de tabela
    Exibição de tabela da guia Designer do Virtual Agent Fluxo com variáveis, tabela de pesquisa e alternância de tabela realçada. Para a descrição de texto, consulte a tabela a seguir.
    Tabela 2. Legenda (exibição de tabela)
    Recurso Descrição
    Paleta: barra lateral de variáveis A guia Componentes não é mostrada. Somente a barra lateral Variáveis fica visível.
    Exibição de tabela Uma lista de linhas da tabela, em que cada linha corresponde a um nó no fluxo de conversa. Você pode adicionar nós nesta seção. Ao adicionar ou remover nós, as linhas da tabela se ajustam automaticamente. Um nó pode ser qualquer um dos controles a seguir, além dos nós Inicial e Final:
    • Entrada do usuário: controles usados para solicitar e capturar informações do usuário em uma conversa.
    • Resposta do bot: controles para exibir respostas do Virtual Agent em uma conversa.
    • Utilitários: controles para executar ações em um tópico, como executar um script, adicionar diferentes caminhos de conversa (ramificações) em um tópico ou adicionar blocos de tópico.

    Selecione Adicionar novo nó para adicionar um nó. Você pode especificar o tipo de controle na caixa de diálogo.

    Pesquisar tabela Opção para pesquisar nós na conversa (tabela).

    Tour guiado dos componentes do LLM

    Quando você cria ou abre um tópico LLM não somente leitura, uma caixa de diálogo aparece e exibe uma opção para fazer um tour guiado pelos componentes habilitados para LLM em Designer do Virtual Agent. Selecione o ícone de fechar () para fechar a janela ou Iniciar tour guiado para ver os vários componentes. Você também pode fazer um tour selecionando Tour guiado para nós habilitados para LLM na guia Recursos úteis.

    Para parar de ver a caixa de diálogo aberta sempre que você abrir um tópico do LLM, selecione Não mostrar isso novamente antes de fechar a caixa de diálogo ou iniciar o tour. Para restaurar a caixa de diálogo, navegue até Todose insira sys_cb_user_preference_list.do. Na página Preferências do usuário do Designer, localize a preferência LLM_INTRO_MODAL_ENABLED. Abra seu campo Value e defina-o como verdadeiro.

    Figura 4. Caixa de diálogo de tour guiado do LLM
    Apresentando a caixa de diálogo Componentes habilitados para LLM com as opções Não mostrar isso novamente e Iniciar tour guiado.

    Avisos de propriedade incompletos

    Os controles na tela têm propriedades obrigatórias. Se propriedades exigidas estiverem ausentes, Designer do Virtual Agent exibirá o número total de propriedades exigidas ausentes e os controles onde elas estão ausentes. Todos os avisos incompletos devem ser resolvidos para testar ou publicar o tópico.

    No exemplo a seguir, duas propriedades exigidas estão ausentes no tópico. Dois nós são afetados e falta uma propriedade em cada um deles. O nó de resposta de texto não tem a resposta de mensagem.

    Figura 5. Guia Fluxo com propriedades incompletas
    Designer do Virtual Agent Exibição da guia Fluxo com propriedades incompletas. O número de nós incompletos é mostrado na tela. A barra lateral e cada nó mostram o número de entradas incompletas.

    Aponte para a mensagem incompleta para ver uma dica das ferramentas que descreve o que está ausente.

    Figura 6. Selecione a mensagem para obter mais informações
    Designer do Virtual Agent propriedades, com mensagem incompleta selecionada para mostrar itens ausentes no nó.