Migrar tópicos NLU para tópicos LLM

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 7 min. de leitura
  • Migre um ou mais tópicos existentes de Compreensão da linguagem natural (NLU) ou de palavras-chave para novos tópicos de modelo de linguagem grande (LLM), mantendo seus tópicos originais NLU/palavra-chave. Depois que a migração for concluída, escolha se deseja publicar seus novos tópicos de LLM.

    Antes de Iniciar

    Função necessária: virtual_agent_admin ou sn_vad_genai.topic_migration_admin

    Procedimento

    1. Navegar até Tudo > Interfaces conversacionais > Virtual Agent > Designer.
    2. Selecione Migrar tópicos para o LLM.
      Migrar tópicos para LLM é uma opção no painel lateral Designer do Virtual Agent.
      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.
      O fluxo de trabalho de migração de tópico é aberto em uma nova guia do navegador.
    3. Revise e determine quais NLU e tópicos de palavra-chave você deseja migrar para tópicos do LLM na etapa Selecionar tópicos.
      Figura 1. Etapa de seleção de tópicos
      A etapa Selecionar tópicos do fluxo de trabalho de migração de tópicos permite selecionar tópicos que você deseja migrar de NLU e tópicos de palavra-chave para se tornarem novos tópicos do LLM.
      Dica:
      Selecione o link na coluna Nome para revisar o tópico na tela Designer do Virtual Agent em uma nova guia do navegador. Migre menos de 50 tópicos de uma vez para ter tempo suficiente para revisar os tópicos.
    4. Selecione quais NLU e tópicos de palavra-chave você deseja migrar e selecione Avançar na etapa Selecionar tópicos.
      Importante:
      Se você sair do fluxo de trabalho de migração de tópicos, não poderá retornar de onde parou e precisará reiniciar o processo.
    5. Revise os blocos de tópicos afetados, Virtual Agent notificações e Gatilhos proativose selecione Avançar na etapa Revisar conexões.

      Na guia Blocos de tópicos, somente blocos de tópicos e blocos de tópicos conectados aos tópicos selecionados são exibidos nesta lista. Os blocos de tópicos dinâmicos devem ser selecionados manualmente para migração. Você pode selecionar o link na coluna Bloco de tópicos para exibir o bloco de tópicos na tela Designer do Virtual Agent em uma nova guia do navegador. Embora os blocos de tópicos dinâmicos possam ser publicados opcionalmente, os blocos de tópicos são publicados automaticamente após a migração. As guias Virtual Agent Notificações e Gatilhos proativos só serão exibidas se os tópicos selecionados para migração tiverem notificações ou Gatilhos proativos associados ao tópico NLU original. Você pode selecionar o link na coluna Nome do tópico em suas respectivas guias para exibir o tópico NLU na tela Designer do Virtual Agent em uma nova guia do navegador. As notificações compatíveis com LLM Virtual Agent e Gatilhos proativos são criadas e conectadas aos novos tópicos do LLM somente depois que esses tópicos são publicados por meio da última etapa de publicação no fluxo de trabalho de migração de tópico.

      Nota:
      A guia Gatilhos proativos só será aplicável se você tiver instalado o aplicativo Gatilhos proativos [sn_pt] versão 3.0.1 ou posterior e tiver ativado este recurso. Se você preferir migrar manualmente suas ações para Virtual Agent notificações e Gatilhos proativos em vez de migrá-las automaticamente após a etapa Publicar, defina as propriedades do sistema com.glide.cs.notification.create_llm_actions_after_topic_migration e com.glide.cs.proactive_trigger.create_llm_actions_after_topic_migration como falsas em Tudo > Propriedades do sistema > Todas as Propriedades.
      Figura 2. Exemplo da etapa Revisar conexões com as guias Blocos de tópicos e Notificações
      Revise os blocos de tópicos ou notificações para ver onde eles são usados antes de continuar no fluxo de trabalho de migração de tópicos.
      Nota:
      Se nenhum bloco de tópico, notificação ou Gatilhos proativos tiver sido selecionado ou conectado aos tópicos selecionados, suas respectivas guias não serão exibidas.
    6. Escolha quais configurações serão aplicadas a todos os tópicos que estão migrando para o LLM e selecione Avançar na etapa Configurações.
      Tabela 1. Descrição do campo de configurações
      Campo Descrição
      Selecionar assistente(s) para tópicos migrados Os tópicos de LLM migrados estão associados a esses assistentes. Associar tópicos a um assistente torna esses tópicos detectáveis com esse assistente. Para obter resultados da descoberta de tópicos, associe tópicos do LLM a um assistente.

      Ao selecionar um assistente, você pode exibir se esse assistente é primário ou secundário. Ao testar um assistente primário, os tópicos de assistentes secundários são incluídos na descoberta de tópicos. Ao testar um assistente secundário, os tópicos dos assistentes primários não são incluídos na descoberta de tópicos.

      Escolha como os tópicos migrados serão nomeados Os tópicos recém-migrados incluem o valor inserido no campo Adicionar ao nome do tópico interno como um prefixo ou sufixo (padrão). Esta opção afeta somente o valor do nome interno dos tópicos migrados e não o valor do nome de exibição dos tópicos. O nome do tópico NLU original é usado como o nome de exibição para clientes que interagem com tópicos LLM em Virtual Agent.
      Manter as descrições de tópico atuais? As descrições de tópico atuais são usadas como descrições de tópico LLM em vez de usar IA generativa para criar descrições de tópico para tópicos LLM migrados. Este campo está desativado por padrão. Se este campo estiver ativado e não houver descrição de tópico no tópico NLU original, uma descrição de tópico deverá ser adicionada manualmente ao novo tópico LLM antes da publicação.
      Figura 3. Etapa de configurações
      As configurações incluem três campos principais que você precisa revisar, incluindo os campos Selecionar assistentes para tópicos migrados, Escolher como os tópicos migrados são nomeados e Manter descrições de tópicos atuais.
    7. Revise os tópicos para migração na etapa Migrar tópicos e selecione Avançar para iniciar a migração.
      Nota:
      Deixe a janela do navegador aberta até que o processo de migração seja concluído.
      Figura 4. Exemplo de uma migração de tópico em andamento
      Quando a migração de tópicos está em andamento, uma barra de progressão é exibida e a tela é atualizada dinamicamente com quais tópicos estão sendo concluídos ou com falha na migração.
      Figura 5. Exemplo de uma migração de tópico concluída
      Quando a migração do tópico estiver concluída, a opção Revisar log de migração será exibida e você poderá selecionar essa opção para exibir dados adicionais sobre o sucesso ou a falha da migração do tópico.
      A barra de progressão da migração concluída aparece e exibe uma porcentagem dinâmica de conclusão. Durante a migração, a coluna Status da migração é atualizada dinamicamente com os valores mudando de Não iniciado para Com falha ou Concluído. Depois que a migração for concluída, todos os blocos de tópicos selecionados ou aqueles associados aos tópicos selecionados serão publicados automaticamente. Você pode optar por selecionar Revisar log de migração ou Avançar. Selecionar Revisar log de migração faz o download de um arquivo .CSV dos dados da tabela Itens de execução de migração de tópico [topic_migration_execution_item.list]. Para obter mais informações sobre os dados dessa tabela, consulte NLU para o log de migração do LLM. Selecionar Avançar continua o fluxo de trabalho para a etapa Revisar descrições.
    8. Prossiga para a etapa Revisar descrições selecionando Avançar.
      Os novos tópicos do LLM que você migrou são exibidos, junto com as descrições dos tópicos migrados e todos os enunciados de NLU disponíveis que foram associados aos tópicos NLU originais dos tópicos migrados.
    9. Escolha um dos seguintes cenários.
      Nota:
      O nome de exibição, não o nome interno, dos novos tópicos do LLM é exibido. O nome de exibição dos novos tópicos do LLM corresponde ao nome de exibição do tópico NLU existente. Se você selecionar o link do tópico LLM, será redirecionado para esse tópico em Designer do Virtual Agent por meio de uma nova guia ou janela do navegador. Para obter informações adicionais sobre fortes descrições de tópico LLM, consulte Descrição do LLM e diretrizes de instrução para Virtual Agent tópicos.
      OpçãoDescrição
      Editar descrição do tópico
      1. Revise a descrição do novo tópico do LLM.

        Todas as descrições de tópico, migradas da descrição de tópico existente NLU ou criadas por IA generativa, estão disponíveis para revisão. Tópicos sem descrições de tópico devem ser atualizados antes da publicação.

      2. Edite a descrição do tópico, conforme necessário.
      3. Selecione Salvar descrição.
      4. Repita esse processo até que todas as descrições de tópico sejam revisadas e editadas.
      Editar a descrição do tópico e testar enunciados

      Este cenário só é aplicável se houver NLU enunciados conectados aos tópicos NLU originais.

      1. Revise a descrição do novo tópico do LLM.

        Todas as descrições de tópico, migradas da descrição de tópico existente NLU ou criadas por IA generativa, estão disponíveis para revisão. Tópicos sem descrições de tópico devem ser atualizados antes da publicação.

      2. Edite a descrição do tópico, conforme necessário.
      3. Selecione Salvar e testar com enunciados.

        Os enunciados do tópico original NLU são comparados com a nova descrição do tópico LLM. Uma porcentagem geral de correspondências aparece junto com um resultado individual por cada enunciado. Esses status são Correspondente ou Sem correspondência. Use esses status para ajustar a descrição do tópico para que você corresponda melhor aos seus NLU enunciados anteriores e teste novamente. A descrição do tópico LLM não precisa usar o texto do enunciado NLU exato para que ocorra uma correspondência. O contexto do enunciado NLU é referenciado para determinar o status correspondente.

      4. Repita esse processo até que todas as descrições de tópico sejam revisadas e editadas.
      Figura 6. Exemplo de revisão de uma descrição de tópico sem NLU enunciados
      Nenhum enunciado de NLU para testar e somente o recurso de edição de descrição.
      Figura 7. Exemplo de revisão de uma descrição de tópico com NLU enunciados
      Enunciados de NLU que correspondem e não correspondem.
    10. Opcional: Prossiga para a etapa Publicar selecionando Avançar.
    11. Opcional: Marque cada caixa de seleção de Tópico do LLM que você deseja publicar e selecione Publicar tópicos.
      Opção de publicar tópicos que se torna disponível depois que você seleciona tópicos do LLM para publicação.
      Dica:
      Se você selecionar o link do tópico LLM, será redirecionado para esse tópico em Designer do Virtual Agent por meio de uma nova guia ou janela do navegador. Todas as edições feitas em Designer do Virtual Agent são refletidas na etapa Publicar da migração de tópico. Você deve publicar tópicos do LLM por meio desta etapa para que todas as notificações conectadas ou Gatilhos proativos funcionem.
      Você recebe uma mensagem de saída Tópicos selecionados foram publicados com sucesso . Os tópicos que você migrou, mas não selecionou para publicar, continuam aparecendo nesta etapa até que você saia do fluxo de trabalho de migração de tópico.
    12. Opcional: Saia do fluxo de trabalho de migração de tópico selecionando Fechar.
      Você será redirecionado para a etapa Designer do Virtual Agent Tópicos.

    O que Fazer Depois

    Depois de sair do fluxo de trabalho de migração de tópicos, os tópicos que você migrou, mas não publicou, poderão ser gerenciados e publicados na tela Designer do Virtual Agent. Se você optar por migrar outros tópicos no futuro, o fluxo de trabalho de migração de tópicos será reiniciado do início.