Create a Document Intelligence use case
Summarize
Summary of Create a Document Intelligence use case
This guide explains how to create and configure a Document Intelligence use case in ServiceNow's Customer Service Management (CSM). A use case defines what information to extract from email and case attachments, maps extracted data to case tables, and controls how agents interact with the data in the Document Intelligence workspace. It is essential for automating data extraction and improving case handling efficiency.
Show less
Prerequisites
- Activate Task Intelligence for Customer Service (com.snc.csmmltask)
- Activate Document Intelligence Admin (com.snc.docinteladmin)
Creating and Configuring a Use Case
Use cases are created in the DocIntel Admin experience under Task Intelligence for Customer Service. When creating a use case, you:
- Specify the name of the use case.
- Select the target table (such as the Case table) to populate with extracted data.
- Set the extraction mode, which controls how extracted values appear to agents as recommendations or autofill.
Defining Fields to Extract
After creating a use case, define one or more fields to extract. These fields must exist in the target case table and can be text or Boolean types. Field definitions include:
- Field name and type
- Whether the field is required
- Mapping to the target table field for storing extracted data
Creating Document Tasks for Model Training
Document tasks contain attachments used to train the Document Intelligence model. You can add files to each task and label the extracted data for accuracy in the Document Intelligence workspace. Agents verify and correct field values during this training phase to improve model precision.
Setting Up Integrations
Integrations define conditions under which Document Intelligence runs for a use case, determining when extraction should be triggered based on case attributes. Multiple integrations can be created, but only the latest active one is used at runtime. Note that the "Create Flow" option should remain unchecked when creating integrations.
Configuring General Document Intelligence Settings
General settings affect all use cases and control aspects such as:
- Whether exact matches are shown to agents
- Displaying confidence scores for recommendations
- Panel layouts and sizes in the Document Intelligence workspace
- Default document fit for image display
Extraction Mode Options
Two extraction modes determine how extracted values are presented to agents:
- Recommendation mode: Extracted values appear as suggestions that agents can accept or edit.
- Autofill mode: Values with confidence above a set threshold are automatically populated, reducing agent effort.
Threshold values for autofill and warnings can be configured per use case.
Agent Verification and Straight Through Processing
By default, agents review and verify extracted field values. Enabling Straight Through Processing automates population of fields if confidence scores exceed a threshold, only requiring agent review for low-confidence extractions. This setting helps streamline agent workflows by minimizing manual verification.
Practical Benefits for ServiceNow Customers
- Automates extraction of key information from case attachments, improving data accuracy and processing speed.
- Enables tailored extraction logic and integration conditions to fit specific business needs.
- Provides flexible agent interaction modes, balancing automation with manual oversight.
- Supports continuous model training to enhance extraction precision over time.
Create a use case that identifies the information to extract from email and case attachments and determines how users with CSM agent roles interact with the extracted values in the Document Intelligence workspace.
- Before you begin
- Role required: sn_csm_ml_task.ti_analyst, sn_csm_ml_task.ti_admin
- About this task
- A use case contains the list of fields to extract from attachments and a mapping of
those fields to fields in the Case table or a case type table. It also contains an
extraction mode that controls how the values for the extracted fields are added to the
case.Use cases include the following information.
Table 1. Use case form fields and descriptions Use case information Description Fields Configure the list of fields to predict for a use case. A field is a single piece of information to extract from a document. For example, the date on a document. Document tasks Create a document task and include attachments that are used to train the Document Intelligence model to identify the correct information. Integrations Select conditions for a use case that tell the Document Intelligence feature when to run. - Prerequisite
- Activate Task Intelligence for Customer Service (com.snc.csm_ml_task).
- Activate Document Intelligence Admin (com.snc.docintel_admin).
Access the DocIntel Admin experience
- Navigate to to open the Task Intelligence Admin Console.
- In the Explore related applications section of the console, select Open DocIntel in the Document Intelligence card to open the DocIntel Admin experience.
Create a use case
- Application = Task Intelligence for Customer service -or-
- MLUC ID = MLUC CSM-00003
- Select Use Cases in the DocIntel Admin header.
- Select New use case in the Use Cases list.
- In the Define a new use case pop-up window, enter the following information.
Table 2. Define a new use case pop-up window Field Definition Name The name of the use case. Location for the extracted data The table that contains the records to be automatically populated with data extracted from attachments. Set this field to the case or case type that is relevant to your use case.
Extraction mode set by default The extraction mode determines how the results are displayed to agents in the Document Intelligence workspace. The DocIntel Admin starts by showing the results for each use case as recommendations.
- Select Save to add the use case to the Use Cases list.
Define the fields to extract
- Select a use case in the Use Cases list.
- Select the Fields tab.
This tab lists the fields that have been selected for extraction for the use case.
- Select Define your fields.
If you have already defined one or more fields and you want to add another field, select New field.
- Fill in the fields in the Define a new field pop-up window.
Table 3. Define a new field pop-up window Field Definition Use case [Read only] The use case associated with this field record. Field Name The display name of the field to extract as it appears in the Document Intelligence workspace. Field Type The type of field (for example, a text field or a check box option). Field type is read-only if you add this field to a field group. The field type is whatever is designated for the group.
Some field types convert the extracted value into a standard format. See Data normalization.
Is field required [Text and number fields only] Required fields can’t be left empty or unreviewed. Add field Select the field group that you want to add the field to. Target Table [Read only] The table that stores the document processing results for this use case. Target Field Field on the target table you want to align this field with. Used for interation. Note:You must select a use case with a target table.Define multiple fields If you’re adding more than one field to the use case, enable this check box to keep the pop-up window displayed on the screen. - Select Add field.
The system adds the field definition to the Fields list.
Create a document task
- Select a use case in the Use Cases list.
- Select the Document tasks tab.
This tab lists the tasks that have been created for the use case.
- Select Create a document task.
If you have already created one or more tasks and you want to add another task, select New document task.
- In the Create the document task pop-up window, enter a Document task name.
- Select +Add File to add one or more attachments.
- Select the file and then select Open.
- In the Upload a file pop-up window, select Upload.
- In the Create the document task pop-up window, select Add Extraction.The system adds the task to the Document Tasks list and Document Intelligence begins the data extraction process, which can take a short time to complete.
- When the extraction process is complete, the Is Processed field is set to true.
- When the values have been extracted from the document, the Status field is set to Done.
- Open the task and select Open in Document Intelligence to view the task in the Document Intelligence Workspace.
- Train the extracted fields to identify the correct values.
- If a field value is correct: put your cursor in the field and press Return to confirm the value.
- If a field value is missing: select the value from the list and press Return to confirm the value.
- If a field value is incorrect: delete the incorrect value and type the first few characters of the correct value. When the correct value appears in the list, select it and then press Return.
- If a field value is incorrect and the correct value does not appear on the image, select Missing in the document from the list.
- Select Submit.
Create an integration
Select conditions for a use case that tell the Document Intelligence feature when to run.
- Select a use case in the Use Cases list.
- Select the Integrations tab.
This tab lists the integrations that have been created for the use case.
- Select Set up your first integration.
If you have already created one or more integrations, select Add integration.
- In the Create Integration pop-up window, enter a name for the integration.
- Use the condition builder to select conditions that tell the Document Intelligence
feature when to predict values.
At run time, the system identifies the right task definition based on these filters. The first active task definition that matches the filters for the case or case type is selected.
- Select Save.
Set general Document Intelligence features
- Select Settings in the DocIntel Admin header.
- Enable or disable the Exact match option. When enabled, Document Intelligence displays only the candidate values that exactly match what the agent types.
- Enable or disable the Candidate score to display confidence scores for each recommendation.
- Select a layout for the Side panels.
- Set the Default width of the extraction panel.
- Set the Default width of the thumbnail panel.
- Select the Default document fit for the image panel.
Configure the data extraction mode
- Recommendation mode provides recommendations for the extracted fields in the Document Intelligence workspace. Agents can choose the recommended value for a field or manually enter a value.
- Autofill mode adds values to the fields in the Document Intelligence workspace if the extraction confidence is higher than the Autofill Threshold value.
- Select Settings in the DocIntel Admin header.
- In the left column of the Settings page, expand the Use Cases list and select a use case.
- Select Extraction Mode.
- To use the Recommendation mode, enable Mode 1:
Recommendation.
- To use the Autofill mode, enable Mode 2: Autofill.
- Enter a percentage value in the Set the Autofill Threshold field.
- Enter a percentage value in the Set the Warning Threshold field.
Configure the agent verification setting
- In the left column of the Settings page, expand the Use Cases list and select a use case.
- Select Agent Verification.
- If desired, enable Straight Through Processing.
- Enter a percentage value in the Set Straight Through Processing Threshold field.