Adicionar um modelo de NLU a um conjunto de atualizações

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 5 min. de leitura
  • Use os conjuntos de atualizações para mover seus modelos Compreensão da linguagem natural (NLU) de uma instância para outra. Os conjuntos de atualizações incluem todos os registros necessários para o seu modelo funcionar na instância de destino.

    Antes de Iniciar

    • Certifique-se de que o plug-in Workbench de NLU, o plug-in Workbench de NLU - Core e o plug-in Inteligência preditiva estejam todos instalados e ativados em sua instância.
    • As instruções a seguir se aplicam aos modelos NLU para Virtual Agent e Pesquisa com IA.
    • Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Use os conjuntos de atualizações para transferir um modelo de uma instância de origem para uma instância de destino. A instância de destino já deve ter o mesmo escopo que o escopo do modelo na instância de origem.

    Adicionar um modelo a um conjunto de atualizações inclui os seguintes recursos:
    • Conteúdo do modelo (intenções, enunciados, entidades, anotações, vocabulário e o conjunto de testes padrão)
    • Origens do vocabulário associado
    • Solução de ML ativa mais recente correspondente
    • Artefatos do modelo de ML
    • Solução e definição de ML (últimas três execuções, desde que uma delas tenha sido bem-sucedida)

    Para obter mais informações sobre conjuntos de atualizações, consulte Conjuntos de atualizações do sistema.

    Se você quiser adicionar o modelo a um conjunto de atualizações diferente, deverá tornar esse conjunto de atualizações o atual. Consulte Create and select an update set as the current set.

    Para obter a portabilidade ideal, adicione o modelo NLU a um novo conjunto de atualizações dedicado em vez de a um conjunto de atualizações padrão do sistema. Para fazer isso, um novo conjunto de atualizações deve ser criado manualmente no escopo do modelo. Um erro será exibido se o conjunto de atualizações atual for o padrão do escopo. Este erro contém um link para criar manualmente um novo conjunto de atualizações.

    Se o modelo contiver registros de vários escopos, como tabelas de vocabulário, seu conjunto de atualizações deverá ter uma estrutura primária-secundária (lote). Siga o procedimento da etapa 5 para criar um conjunto de atualizações primário-secundário.

    Quando modelos (Globais ou com escopo) são movidos usando conjuntos de atualizações, seu estado de treinamento e publicação permanece o mesmo após a transferência. Portanto, um modelo treinado e publicado antes de ser adicionado a um conjunto de atualizações não requer retreinamento ou republicação na instância de destino.

    Para obter informações sobre conjuntos de atualizações primário-secundário, consulte Update set batching. O vídeo a seguir fornece uma demonstração desse processo.

    Procedimento

    1. Selecione Todos e insira sys_nlu_model.list no navegador.

      Navegador do sistema com sys_nlu_model.list inserido.

    2. Selecione o Nome do modelo do modelo.

      Lista do sistema de modelos de NLU.

      O nome de exibição é o nome que você deu ao modelo ao criá-lo. O nome do modelo é fornecido ao modelo pelo sistema.

    3. Opcional: Se Global for sua aplicação atual, siga o prompt na parte superior para editar o registro.

      Mensagem sobre o escopo da aplicação atual. Clique "aqui" para editar o registro e adicioná-lo a um conjunto de atualizações.

    4. Na seção Links relacionados, clique em Adicionar modelo ao conjunto de atualizações atual.

      Página do modelo com o botão Adicionar modelo ao conjunto de atualizações atual realçado.

      Se os registros do modelo estiverem todos em um escopo, o sistema adicionará o modelo ao conjunto de atualizações atual. Depois de concluído, o registro pode ser encontrado na tabela sys_update_set.

      No entanto, o sistema exibirá um erro se o escopo designado for o escopo Padrão. Continue com as etapas a seguir.

    5. Se o sistema exibir o erro Você está tentando adicionar um registro ao conjunto de atualizações padrão do sistema, prossiga com as etapas restantes deste procedimento.
      Erro ao adicionar o modelo ao conjunto de atualizações. A opção para criar um Novo Conjunto de Atualizações Local está realçada.

      Na faixa de erro, selecione o link Novo conjunto de atualizações local para criar um novo conjunto de atualizações que não seja Padrão. No caso de um conjunto de atualizações primário-secundário, o primário é criado primeiro no escopo do modelo. (Todos os conjuntos de atualizações secundários são criados em uma etapa posterior).

      O novo conjunto de atualizações local abre um novo registro na tabela sys_update_set.
    6. Para o novo registro de conjunto de atualizações, forneça um nome, revise outros valores, incluindo Escopo da aplicação e selecione Enviar e Tornar Atual.
      O formulário para um novo Conjunto de Atualizações, com o botão Enviar e Tornar Atual realçado.
      Um novo conjunto de atualizações é criado e a tela é reaberta para o registro do modelo na tabela sys_nlu_model.
    7. No registro do modelo em sys_nlu_model, selecione Adicionar modelo ao conjunto de atualizações atual em Links relacionados.
      Quando os registros do modelo estão em vários escopos, esta etapa cria conjuntos de atualizações secundários que têm escopo Global.
      Nota:
      Se os registros do modelo estiverem todos em um escopo, o sistema adicionará o modelo ao conjunto de atualizações atual. Depois de concluído, o registro pode ser encontrado na tabela sys_update_set.
    8. Se o modelo estiver em um escopo não global: na tabela Conjuntos de atualizações sys_update_set, localize o conjunto de atualizações primário e seus conjuntos de atualizações secundários (atualize a página se necessário).
      • O conjunto de atualizações primário tem o valor (vazio) na coluna Primário.
      • Os conjuntos de atualizações secundários têm o nome do primário na coluna Primário e Global na coluna Aplicativo.
      • Os conjuntos de atualizações primário e secundário contêm o mesmo valor na coluna Base do lote.
      Na tabela Conjuntos de atualizações, um conjunto de atualizações primário-secundário com a linha primária realçada.
    9. Abra o registro primário em sys_update_set e defina o campo Estado como Concluído.
      Uma caixa de diálogo de confirmação é exibida. Selecione Sim para confirmar. Isso define o primário e todos os conjuntos de atualizações secundários como Concluídos.
    10. Para migrar o arquivo de conjunto de atualizações, selecione Exportar lote de conjunto de atualizações para XML no registro primário em sys_update_set.
      Os conjuntos de atualizações primário e secundário são empacotados juntos e exportados.

    O que Fazer Depois

    Na instância de destino, navegue até Conjuntos de atualizações recuperados e selecione Importar conjuntos de atualizações do XML. Quando desempacotado, o primário e todos os secundários serão listados na tabela Conjuntos de atualizações recuperados. Abra o primário e selecione Visualizar lote de conjunto de atualizações.

    Se um registro referenciado na instância de origem não estiver presente na instância de destino, você poderá encontrar erros ao aplicar o conjunto de atualizações. Por exemplo, o campo de origem em sys_nlu_intent pode se referir a uma intenção de um modelo diferente que não existe na instância de destino. Você pode clicar em Aceitar atualização remota nos registros com falha para confirmar o conjunto de atualizações mesmo assim.