Topic mapping to a multilingual NLU model group

  • Release version: Australia
  • Updated March 12, 2026
  • 3 minutes to read
    • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of Topic Mapping to a Multilingual NLU Model Group

    Mapping a topic to a multilingual model group in Virtual Agent Designer automatically sets up topic mappings for enabled languages. Model groups consist of a primary language model and various secondary language models, where secondary models are translated versions of the primary model. Supported languages can serve as either primary or secondary models, with names reflecting their language codes (e.g., FR for French).

    Show full answer Show less

    Key Features

    • The topic Properties tab allows you to view or modify model and intent mappings.
    • The topic Languages tab lets you review secondary language mappings.
    • Secondary mappings must always point to the same model group as the primary mapping, ensuring consistency across languages.
    • You can create model groups in NLU Workbench, specifying a primary language based on user session language.
    • Single-language models can be mapped to a topic if there are no conflicts with the multilingual model group.

    Key Outcomes

    By using multilingual model groups, you streamline topic maintenance and facilitate topic discovery in multiple languages. If an intent for the primary language is disabled, all secondary intents are also disabled. However, if intents for secondary languages are disabled, others remain active. To avoid conflicts, Virtual Agent Designer only displays relevant model groups based on the user's current session and alerts users to any potential mapping changes when modifying topics.

    When you map a topic to a multilingual model group in Virtual Agent Designer, the topic mappings for enabled languages are set up automatically.

    Model groups contain a primary language model, such as English, and secondary language models. Secondary models are translated copies of the primary model, where each secondary model uses a different language. Any supported language can be the primary language for a primary model or the secondary language for a secondary model. The language is reflected in the model name. For example, FR for French, DE for German, JA for Japanese, and ES for Spanish.

    Figure 1. Multilingual model groups contain one primary language model and multiple secondary language models
    A multilingual model group contains English as its primary language model. Secondary language models include French, German, Spanish, or any additional languages you might add.

    You can view or change the model and intent mappings on the topic Properties tab. You can review secondary language mapping on the topic Languages tab.

    Because secondary model content is only a translated copy of its primary model content, the secondary language mappings must always point to the same model group as the primary language. For this reason, if you map a language in a topic to a model that is part of a multilingual model group, then all of the topic mappings are updated to use the language models in that group. Virtual Agent Designer informs you of the change.
    Figure 2. Updated NLU mappings message
    A mapping change alert says, "We updated mappings for these languages: English, French, German, Spanish."
    Note:
    You can map single-language models to a topic as long as there is no conflict with the corresponding language models in the group.

    If you create a model group in NLU Workbench, you can specify the primary language. If you create a model from within Virtual Agent Designer, the primary language is determined by the user session language. For example, if you create a new model in a German user session, the primary language of the model group will be German.

    Model groups make it easier to maintain your topics. For more information about NLU model groups, see Multilingual model management.

    Note:
    If a model contains only a single language, that language is considered to be the primary language. The topic is mapped to the model and specified intent only. If more than one language has been activated in NLU Settings, those languages are not mapped to the model. To use the topic in other languages, map them to other models manually on the Languages tab. For more information, see Map a topic to a secondary NLU model.

    Handling disabled intents within a model

    If an intent for the primary language within the model group is disabled, the primary intent displays as disabled in Virtual Agent Designer. When the primary language is disabled, the intent is still mapped to the topic, but all secondary intents are also shown as disabled. This is because the secondary languages are always dependent on the primary language within a model. If an intent for one or more secondary languages is disabled, the other languages remain active. Virtual Agent Designer displays messaging to indicate that some intents are currently disabled.

    Figure 3. Topic with a disabled French intent on the Languages tab
    The NLU Intent mapping area on the Languages tab indicates that the mapped French intent is not available because it was disabled in NLU Workbench.

    To allow topic discovery for the language, enable the intent in NLU Workbench. For more information, see Enable or disable a secondary model intent.

    Avoiding model conflicts

    In order to avoid conflicts, Virtual Agent Designer may not display all of the existing models when you create or modify topics. Virtual Agent Designer does the following:
    • Only displays model groups that contain language models that reflect the user's current session.
    • Shows a warning if the selected model group has language mappings that will change existing language mappings, whether in another model group or in a single-language model.
    • Automatically maps intents in each language model in the group to the topic.
    • Ensures that duplicate model names or intent names are not used.
    • If a topic is mapped to a multilingual model group, hides single-language model groups on the NLU Language Mapping tab.

    If languages in a topic are mapped to intents in more than one model group, conflicts may occur. An intent can only be mapped to one topic. If this situation occurs when you attempt to publish a topic, Virtual Agent Designer displays an error message.