Guia Fluxo de tópico

  • Versão de lançamento: Yokohama
  • Atualizado 4 de mar. de 2025
  • 9 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.
    Nota:
    Uma interface do usuário Designer do Virtual Agent atualizada está disponível quando você instala Now Assist em Virtual Agent e ativa a habilidade Now Assist Tópicos. Este conteúdo pressupõe que você ativou esta habilidade e pode ver a exibição de lista. Se esta habilidade não estiver ativada, você verá a IU legada e a página de tópicos. Para obter mais informações, consulte a página de tópicos legados do Designer do Virtual Agent.
    Tabela 1. Legenda (exibição padrão)
    Recurso Descrição
    1. Barra de navegação Guias para navegar entre seu design e a página inicial. Você pode abrir e navegar entre vários tópicos e a página inicial selecionando o Designer do Virtual Agent ou a guia de um tópico aberto. Selecione o ícone de fechar ícone de fechar. em uma guia para fechar esse tópico.
    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 Now Assist, a aplicação Microsoft Teams ou a aplicação Slack estiver configurado para o seu ambiente, as opções de visualização desses canais serão exibidas na lista de botões Testar. 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 Ícone de mais ações.
      • 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.

    Ao atualizar designs, a barra de cabeçalho exibe uma mensagem de Mudanças não publicadas até que você publique o tópico. Passe o mouse sobre a mensagem para ver uma dica de ferramenta que explica as mudanças não publicadas. Por exemplo, as mudanças podem incluir o design principal do tópico ou mapeamentos de idioma Compreensão da linguagem natural (NLU).Barra de cabeçalho da guia de fluxo do Designer do Virtual Agent mostrando a mensagem de aviso de mudanças não publicadas. Uma dica de ferramenta detalhando mudanças não publicadas aparece quando você passa o mouse sobre a mensagem.

    Se você fechar o tópico sem salvar, um botão Recuperar mudanças aparecerá na barra de cabeçalho. Selecione este botão para recuperar quaisquer mudanças não publicadas que não foram salvas antes do fechamento. O botão Recuperar mudanças é substituído pela mensagem Mudanças não publicadas.Barra de cabeçalho da guia de fluxo do Designer do Virtual Agent mostrando o botão Recuperar mudanças após reabrir um tópico não salvo.

    Se você adicionar um nó e fechar o tópico antes de salvar ou publicar, o nó desaparecerá e o botão e a mensagem serão exibidos quando você reabrir o tópico. Selecione Recuperar mudanças para restaurar o nó e remover o botão.Barra de cabeçalho da guia de fluxo do Designer do Virtual Agent mostrando a mensagem Mudanças não publicadas e o botão Recuperar mudanças. Ambos aparecem após a reabertura de um tópico não salvo com um nó adicionado.

    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 de 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.Guia Variáveis mostrando a entrada e os scripts no tópico que está sendo exibido no Designer do Virtual Agent.
    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ó Ícone de pesquisa. para expandir o campo de pesquisa e inserir 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. Aviso de problemas Contador mostrando o número de problemas que precisam de correção antes que o tópico possa ser publicado. Para obter mais informações, consulte a seção Avisos de propriedade incompleta destes documentos.
    7. Nó Item de entrada ou de saída na tela criada ao arrastar um controle da barra lateral Componentes ou Variáveis. Todos os controles na conversa são representados como nós individuais na tela. Se um nó estiver incompleto, será exibido um contador mostrando o número de problemas no nó. Para obter mais informações, consulte a seção Avisos de propriedade incompleta destes documentos.
    8. 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
    9. Seletor 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.
    10. 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.
    11. Guia da folha de propriedades Abre a exibição da folha de propriedades do nó selecionado no momento na tela.
    12. Guia Problemas de validação Abre a exibição Problemas de validação, mostrando o número de problemas no tópico que precisam de correção antes que o tópico possa ser publicado. Esta guia aparece quando você tenta publicar um tópico incompleto e desaparece quando todos os problemas são resolvidos. Para obter mais informações, consulte Publicar um tópico Virtual Agent.
    13. Guia Recursos Abre a exibição Recursos úteis, que contém um link para a documentação do produto. Em um tópico do LLM, outros recursos aparecem, incluindo tours guiados na tela e links para vídeos para controles do 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 do 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 do 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ó.