---
title: "AI Model Building - A Simple Solution"
slug: "ai-model-building-a-simple-solution"
updated: 2025-07-14T13:28:56Z
published: 2025-07-14T13:28:56Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.revealdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AI Model Building - A Simple Solution

## Introduction

An AI model is a software program that has been trained on a set of data to perform specific tasks such as recognizing certain patterns. Artificial intelligence models use decision-making algorithms to learn from the training and data and apply that learning to achieve specific pre-defined objectives.

Reveal AI supports model building in various ways. To help speed up the model building process, users can use a keyword list, or export a CSV file from previous cases to build the initial model. This document provides step-by-step instructions on how to create models using these two methods.

## Process Flow

![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/217%20-%2001%20-%20AI%20Model%20Process%20Flow.png)

## Workflow Steps

Reveal supports importing models directly from a CSV file. The CSV file can be the one exported from a Brainspace portable model, or you can create one manually. If you are creating one manually, make sure the CSV file contains the following two columns:

- term
- weight

> [!NOTE]
> Note
> 
> The column names and terms need to be in lower case.

### 1. Collect Terms and Weights

There are two ways to collect the materials that can be used to build an AI model.

1. Use a self-generated keywords list. This could be a keyword list used by review team to search for relevant documents.

> [!NOTE]
> Note
> 
> Wildcard and proximity searching terms are not supported, so convert them to straight keywords before using them in the CSV file.
2. Export the features from an existing classifier in Reveal:
  1. Go to the **Features** tab in Classifier Details, click ***Download*** to download the CSV file:

![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/217%20-%2002%20-%20Download%20Classifier%20Features.png)

> [!NOTE]
> Note
> 
> The downloaded CSV will contain extra columns and will need to be updated before we can use it directly. See steps below for more details.

| **Raw Feature** | **Feature** | **Type** | **Model Weight** |
| --- | --- | --- | --- |
| toni graham | toni graham | keyword | 0.05834 |
| mark broadfoot | mark broadfoot | keyword | 0.03369 |
| broadfoot | broadfoot | keyword | 0.03256 |
| mins | mins | keyword | 0.03174 |
| resume | resume | keyword | 0.0301 |
| sgrady | sgrady | document author | 0.02756 |
| cliff baxter | cliff baxter | keyword | 0.02646 |
| don | don | keyword | 0.0262 |
| phillip k.allen | phillip k.allen | keyword | 0.02536 |
| phillip k. | phillip k. | keyword | 0.02524 |

### 2. Update and fine-tuning

Once the CSV file is created, we can then add the term and weights as desired. There are two types of terms, (1) key word terms and (2) metadata features.

- Keyword: supports multiple words, for example “*natural gas*” can be one term.
- Metadata: lists the metadata field name and value in the following format: *[“field”:”value”]*

For example, the following metadata term is for metadata field “From”:

*["SENDER","kaminski <kaminski>"]*

To view a list of possible metadata fields, reference the *Review Database Field Name*columns in the RQL [Quick Reference Table](/reveal/docs/reveal-query-language-basics#quick-reference-table).

We recommend the weights assigned to each term be in the range of -0.99 to 0.99, with at least one positive and one negative entry.

Here is an example:

*term,weight*

*takata,0.5*

*airbag,0.9*

*recall,0.4*

*airbags,0.3*

*automaker,0.3*

*faulty,0.3*

*inflators,0.2*

*["SENDER","kaminski <kaminski>"]:0.8*

*window,-0.1*

*working,-0.1*

*yesterday,-0.4*

### 3. Import into Model Library

The CSV file can be imported into the model library using the **IMPORT MODEL** button below:

![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/217%20-%2003%20-%20Import%20Model%20button.png)

Browse to the CSV file and import it to the model library.

Once it is imported, click the Settings button and update name/description:

![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/217%20-%2005%20-%20Model%20Settings.png)

The saved model can then be applied to a classifier in the same way other library models are.

### 4. Test and Validating

Follow the steps below to Test and Validate the new model:

1. Create a new classifier in a new case.
2. Go to the **Edit Classifier**
3. Add the imported model to the classifier under **AI Library Models**.

![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/217%20-%2006%20-%20Add%20Model%20in%20Classifier%20Settings.png)
4. Either **Run Full Process** using the button at the bottom of the AI Library Models section after selecting, or go to Classifier Details and click **Run Full Process**.

![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/217%20-%2007%20-%20Run%20Full%20Process.png)
5. Confirm scores are populated after classifier finishes.

## Related

- [AI Model Building Workflow](/ai-model-building-workflow.md)
- [Migration Export – Local Discovery](/migration-export-local-discovery.md)
- [Review Tracking](/review-tracking.md)
- [Find Stories Using Entities](/find-stories-using-entities.md)
- [Apply AI Model from Library](/apply-ai-model-from-library.md)