NLU para o log de migração do LLM

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 6 min. de leitura
  • A tabela Itens de execução de migração de tópico [topic_migration_execution_item.list] inclui dados ao migrar tópicos Compreensão da linguagem natural (NLU) para tópicos de modelo de linguagem grande (LLM), como status de migração, problemas de migração e informações de tópicos migrados ou publicados.

    Você pode acessar esses dados de migração de tópico pesquisando topic_migration_execution_item.list no painel de navegação ou baixando a versão do arquivo .CSV da tabela. Depois de migrar os tópicos, o arquivo .CSV para download poderá ser acessado por meio da opção Revisar log de migração na etapa Migrar tópicos do fluxo de trabalho de migração de tópicos.

    Figura 1. Exemplo da opção Revisar log de migração
    Revisar log de migração é uma opção disponível após a conclusão da migração do tópico que aparece em relação à barra de status de progressão da migração.

    Os padrões da tabela Itens de execução de migração de tópico [topic_migration_execution_item.list] incluem as seguintes colunas:

    • Descrição
    • Problemas
    • Tópico de LLM
    • Execução de migração
      Nota:
      A coluna Execução de migração inclui o ID exclusivo gerado para cada lote de migração. Por exemplo, quando 10 tópicos são migrados ao mesmo tempo, a tabela contém 10 linhas de tópico com cada linha contendo o mesmo valor de execução de migração.
    • Status das migrações
    • NLU Tópico
    • Status
    • Tipo
    Figura 2. Exemplo dos dados da tabela Itens de execução de migração de tópico
    Exemplo de log de itens de execução de migração de tópico com as seguintes colunas padrão: Descrição, Problemas, Tópico de LLM, Execução de migração, Status de migração, NLU Tópico, Status e Tipo.

    Podem ocorrer problemas genéricos durante o processo de migração do tópico. A tabela a seguir inclui problemas específicos e comuns que você pode encontrar na coluna Problemas e se o problema bloqueia a publicação do tópico.

    Tabela 1. Detalhes da coluna Problemas
    Valor da coluna de problemas Tipos de problemas O tópico pode ser publicado?
    Não foi possível gerar algumas propriedades de tópico. Para publicar, revise e edite manualmente os seguintes nós: [lista de nomes de nós] Problemas no nível do nó: são mensagens de erro de validação que podem incluir campos ausentes, como nome, descrição e assim por diante.

    O problema deve ser corrigido antes que o tópico possa ser publicado.

    Não foi possível gerar algumas propriedades do tópico porque o tópico usou um script. Para publicar, revise e edite manualmente os seguintes nós: [lista de nomes de nós] Problemas no nível do script: esses problemas ocorrem sempre que um nó de entrada NLU tem um script ou cápsula de dados no campo Prompt. Sim.

    Tópicos com este problema podem ser publicados porque Coletar [Nome do nó] é preenchido no campo Descrição detalhada, mas o valor do campo Descrição detalhada deve ser revisado e aprimorado.

    Não foi possível gerar algumas propriedades de tópico. Edite-os antes de publicar o tópico. Problemas no nível do tópico: esses problemas são erros de validação no nível do tópico, como descrição ausente, palavras-chave ou qualquer outro campo obrigatório.

    O problema deve ser corrigido antes que o tópico possa ser publicado.

    Não foi possível gerar a descrição do tópico. Edite o campo de descrição na página Publicar ou na página de propriedades do tópico no Designer do Virtual Agent antes de publicar. Problemas de descrição gerada pelo LLM: esses problemas ocorrem sempre que o LLM não consegue gerar uma descrição de tópico válida. Sim.

    Tópicos com este problema podem ser publicados porque [Nome do tópico] preenche o campo Descrição do tópico, mas o valor do campo Descrição do tópico deve ser revisado e aprimorado.

    Não foi possível gerar a descrição do tópico porque a intenção mapeada não foi encontrada. Edite o campo de descrição na página Publicar ou na página de propriedades do tópico no Designer do Virtual Agent antes de publicar. Problemas de descrição gerados por LLM relacionados a NLU Complicações de intenção: esses problemas ocorrem sempre que um modelo NLU e uma intenção são mapeados para um tópico, mas estão ausentes nas tabelas sys_nlu_model ou sys_nlu_intent ou se esses valores estão mapeados incorretamente para o tópico. Sim.

    Tópicos com este problema podem ser publicados porque [Nome do tópico] preenche o campo Descrição do tópico, mas o valor do campo Descrição do tópico deve ser revisado e aprimorado.

    Não foi possível gerar a descrição do tópico porque a intenção e as palavras-chave estão ausentes. Edite o campo de descrição na página Publicar ou na página de propriedades do tópico no Designer do Virtual Agent antes de publicar. Problemas de descrição gerados pelo LLM relacionados a NLU problemas de intenção: esses problemas ocorrem sempre que a intenção e as palavras-chave de um modelo NLU não são mapeadas para o tópico. Sim.

    Tópicos com este problema podem ser publicados porque [Nome do tópico] preenche o campo Descrição do tópico, mas o valor do campo Descrição do tópico deve ser revisado e aprimorado.

    A ferramenta de migração não pôde converter um ou mais nós de bloco de tópico dinâmico deste tópico. Os blocos de tópicos usados dentro dos blocos de tópicos dinâmicos devem ser migrados manualmente. Os seguintes nós usam estes blocos de tópicos dinâmicos: [lista de nomes de nós] Problemas de bloco de tópico dinâmico: esses problemas ocorrem sempre que há um nó que tem um bloco de tópico dinâmico que não foi migrado. Sim.

    Tópicos com este problema podem ser publicados porque os nomes de bloco de tópico usam um script para blocos de tópico dinâmicos e continuam a funcionar conforme o esperado, usando o bloco de tópico NLU. Se você encontrar esse problema, selecione esses blocos de tópicos para migração na etapa Selecionar tópicos e atualize os nomes dos blocos de tópicos no script.

    A ferramenta de migração não pôde converter um ou mais scripts de tópico de alternância deste tópico. Os tópicos usados dentro do script de tópico de alternância precisam ser migrados manualmente. Os seguintes nós usam estes scripts de tópico de alternância: [lista de nomes de nós] Problemas de script de tópico de alternância: esses problemas ocorrem sempre que um nó tem uma função de tópico de alternância que não foi migrada. Sim.

    Tópicos com este problema podem ser publicados porque o script do tópico continua a usar o tópico NLU até a migração. Se você encontrar esse problema, selecione esses tópicos para migração na etapa Selecionar tópicos.

    Não foi possível migrar este tópico. Entre em contato com o suporte ServiceNow para obter assistência. Problemas de falha no processo: esses problemas ocorrem sempre que há um erro durante um processo de migração específico.

    O problema deve ser corrigido por um funcionário ServiceNow antes que o tópico seja publicado.

    Este tópico não pôde ser migrado porque a transformação de NLU nós em nós LLM falhou. Entre em contato com o suporte ServiceNow para obter assistência. Problemas de falha no processo: esses problemas ocorrem sempre que há um erro durante a transformação de nós NLU em nós LLM.

    O problema deve ser corrigido por um funcionário ServiceNow antes que o tópico seja publicado.

    Este tópico não pôde ser migrado porque a carga de publicação não foi gerada. Entre em contato com o suporte ServiceNow para obter assistência. Problemas de falha no processo: esses problemas ocorrem sempre que há um erro durante um processo de migração específico.

    O problema deve ser corrigido por um funcionário ServiceNow antes que o tópico seja publicado.

    Este tópico não pode ser publicado até que uma descrição de tópico seja adicionada. Problemas de falha no processo: esses problemas ocorrem sempre que há um erro durante um processo de migração específico.

    O problema deve ser corrigido antes que o tópico possa ser publicado. Edite o campo de descrição na etapa Publicar ou na página de propriedades do tópico em Designer do Virtual Agent antes de publicar.