\(Legacy\) Create an NLU model from a CSV file

task brazil Updated Sep 10, 2026 2 min read create-nlu-model-csv.md
Raw file servicenow.com

Upload a CSV or XLSX (Excel Workbook) file containing utterances and their intents to create a Natural Language Understanding (NLU) model. Use this method to quickly create models from your data or other exported models.

Before you begin

  • Make sure that the NLU Workbench plugin, NLU Workbench - Core plugin, and Predictive Intelligence plugin are all installed and activated on your instance.
  • You can create NLU models for Virtual Agent and AI Search.
  • Role required: admin or nlu_admin

About this task

In this example procedure, you're building an NLU model to help Virtual Agent understand user requests regarding calendars.

In a CSV file, you've listed the intents and utterances in two columns.

Intent Utterance
schedule when is my next meeting
schedule what time is my next meeting
schedule schedule a meeting for 11am
schedule cancel my 4:30 meeting
holiday when is the next holiday
holiday do we get Black Friday off
timeoff request friday off
timeoff how many PTO days do i have

Note the following for creating NLU models by CSV import:

  • A model needs at least 1 intent with a minimum of 5 training utterances in each intent. For optimum performance, aim to have 15 training utterances per intent.
  • Utterances should not contain a comma.
  • Importing with a CSV file does not preserve entities. Make sure to annotate utterances as needed after importing.

Procedure

  1. Set your scope to the application scope you want for your new model.

  2. Navigate to All > NLU Workbench > Models.

    The Virtual Agent tab opens by default.

  3. Select the tab for the type of model you want to create, such as AI Search.

  4. Select the Create new model button.

  5. In the How do you want to create your model? window, select Import data from a CSV.

  6. In the Add some details window, add the Name and Short description for the model.

    [Omitted image "create-nlu-model-csv1.png"] Alt text: Define details screen for importing data from CSV.

    In this example scenario, you enter Calendar Model for the name and Model for answering and performing calendar requests for the short description.

  7. Select the language and purpose from the drop-down lists.

    In this example scenario, you select English and Virtual Agent.

  8. Select Next.

  9. On the Import CSV screen, select Select file.

    [Omitted image "create-nlu-model-csv2.png"] Alt text: Import CSV screen for importing data from CSV.

  10. Choose the CSV or XLSX (Excel Workbook) file from the pop-up.

  11. Select Next.

    Your model starts building. After completion, select View model to open the model details page.

What to do next

Add intents and training utterances to continue building the model. Add entities and vocabulary to help the model understand inputs from your users. For more information, see (Legacy) Build and train your model.

Add test utterances and intents to build the model's default test set. For more information, see (Legacy) Test set creation and management.

Search documentation
Search document titles and file paths on the brazil branch