Mapeamento de tópicos para um grupo de modelos multilíngue NLU

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 3 min. de leitura
  • Quando você mapeia um tópico para um grupo de modelos multilíngue em Designer do Virtual Agent, os mapeamentos de tópico para idiomas habilitados são configurados automaticamente.

    Os grupos de modelos contêm um modelo de idioma principal, como inglês, e modelos de idioma secundário. Modelos secundários são cópias traduzidas do modelo primário, em que cada modelo secundário usa um idioma diferente. Qualquer idioma compatível pode ser o idioma primário de um modelo primário ou o idioma secundário de um modelo secundário. O idioma é refletido no nome do modelo. Por exemplo, FR para francês, DE para alemão, JA para japonês e ES para espanhol.

    Figura 1. Os grupos de modelos multilíngues contêm um modelo de idioma primário e vários modelos de idioma secundário
    Um grupo de modelos multilíngue contém inglês como modelo de idioma primário. Os modelos de idioma secundário incluem francês, alemão, espanhol ou quaisquer idiomas adicionais que você possa adicionar.

    Você pode exibir ou mudar o modelo e os mapeamentos de intenção na guia Propriedades do tópico. Você pode revisar o mapeamento de idioma secundário na guia Idiomas do tópico.

    Como o conteúdo do modelo secundário é apenas uma cópia traduzida do conteúdo do modelo primário, os mapeamentos de idioma secundário devem sempre apontar para o mesmo grupo de modelos do idioma primário. Por esse motivo, se você mapear um idioma em um tópico para um modelo que faz parte de um grupo de modelos multilíngue, todos os mapeamentos de tópico serão atualizados para usar os modelos de idioma nesse grupo. Designer do Virtual Agent informa sobre a mudança.
    Figura 2. Mensagem de mapeamentos de NLU atualizada
    Um alerta de mudança de mapeamento diz: "Atualizamos os mapeamentos para estes idiomas: Inglês, francês, alemão, espanhol".
    Nota:
    Você pode mapear modelos de idioma único para um tópico, desde que não haja conflito com os modelos de idioma correspondentes no grupo.

    Se você criar um grupo de modelos em Workbench de NLU, poderá especificar o idioma primário. Se você criar um modelo em Designer do Virtual Agent, o idioma principal será determinado pelo idioma da sessão do usuário. Por exemplo, se você criar um novo modelo em uma sessão de usuário em alemão, o idioma principal do grupo de modelos será o alemão.

    Os grupos de modelos facilitam a manutenção de seus tópicos. Para obter mais informações sobre grupos de modelos de NLU, consulte Gestão de modelos multilíngue.

    Nota:
    Se um modelo contiver apenas um idioma, esse idioma será considerado o idioma primário. O tópico é mapeado somente para o modelo e a intenção especificada. Se mais de um idioma tiver sido ativado em NLU Configurações, esses idiomas não serão mapeados para o modelo. Para usar o tópico em outros idiomas, mapeie-os para outros modelos manualmente na guia Idiomas. Para obter mais informações, consulte Mapear um tópico para um modelo secundário NLU.

    Manipulação de intenções desabilitadas em um modelo

    Se uma intenção do idioma primário no grupo de modelos estiver desabilitada, a intenção primária será exibida como desabilitada em Designer do Virtual Agent. Quando o idioma primário é desabilitado, a intenção ainda é mapeada para o tópico, mas todas as intenções secundárias também são mostradas como desabilitadas. Isso ocorre porque os idiomas secundários sempre dependem do idioma primário em um modelo. Se uma intenção de um ou mais idiomas secundários estiver desabilitada, os outros idiomas permanecerão ativos. Designer do Virtual Agent exibe mensagens para indicar que algumas intenções estão desabilitadas no momento.

    Figura 3. Tópico com intenção de francês desabilitada na guia Idiomas
    A área de mapeamento de intenção de NLU na guia Idiomas indica que a intenção de francês mapeada não está disponível porque foi desabilitada no Workbench de NLU.

    Para permitir a descoberta de tópico para o idioma, habilite a intenção em Workbench de NLU. Para obter mais informações, consulte Habilitação ou desabilitação de uma intenção de modelo secundária.

    Evitando conflitos de modelo

    Para evitar conflitos, Designer do Virtual Agent pode não exibir todos os modelos existentes ao criar ou modificar tópicos. Designer do Virtual Agent faz o seguinte:
    • Exibe somente grupos de modelos que contêm modelos de idioma que refletem a sessão atual do usuário.
    • Mostra um aviso se o grupo de modelos selecionado tiver mapeamentos de idioma que mudarão os mapeamentos de idioma existentes, seja em outro grupo de modelos ou em um modelo de idioma único.
    • Mapeia automaticamente as intenções em cada modelo de idioma no grupo para o tópico.
    • Garante que nomes de modelo duplicados ou nomes de intenção não sejam usados.
    • Se um tópico for mapeado para um grupo de modelos multilíngue, oculta os grupos de modelos de um único idioma na guia Mapeamento de idioma NLU.

    Se os idiomas em um tópico forem mapeados para intenções em mais de um grupo de modelos, poderão ocorrer conflitos. Uma intenção só pode ser mapeada para um tópico. Se esta situação ocorrer quando você tentar publicar um tópico, Designer do Virtual Agent exibirá uma mensagem de erro.