This article is a supplement to the ServiceNow documentation. For full documentation please refer ServiceNow official website
Checkout our NEW Video Channel you can like and subscribe too!

What is Agent Workspace?

A graphical user interface where agents can

• Find an issue,

• Research the issue to find a solution,

• Resolve the issue and

• Communicate the resolution to the requester.

Agent workspace supports two form views:

  1. Workspace(common to CSM and ITSM)

  2. CSM workspace(only to CSM)


  1. Agent workspace(com.agent_workspace)

  2. CSM Workspace(com.snc.agent_workspace.csm)


  1. Workspace administrator( workspace_admin): This roles helps to configure agent workspace.

Workspace administrator role contains below roles:

  1. Workspace list administrator(workspace_list_admin): This role provides the ability to create list categories and filtered lists in Agent Workspace. This role contains workspace_user

  2. Workspace agent(agent_workspace_user): This role provides the ability to access to agent workspace. ITIL(ITSM) and sn_esm_agent(CSM) roles contain this role.

  3. Workspace user( workspace_user): This role provides the ability to access to workspace_core. This role is for internal use only.

Agent Workspace components


Importent components:

agentworkspace2003202146.JPG agentworkspace2003202147.JPG agentworkspace2003202148.JPG agentworkspace2003202149.JPG

Below Items we have to setup to configure agent workspace:

• Forms
• Ui actions
• Client scripts
• UI policies
• Form Header
• Ribbon
• Workspace settings
• Additions items need to configure
     1.Agent Assist
     2.Global search

Agent workspace-Guided Setup:

This is step by step guide to create all the necessary configuration items to get workspace up and running.

Agent workspace Setup:

  • Configure a list View
  • Configure a Record Menu Item
  • Configuration Ribbon Settings
  • Configure Form Header

Step 1: Add the Roles:

-Add workspace_admin and Workspace_list_admin roles.

-Logout and login again as system administrator.

Step 2: Navigate to your User Menu in the upper right corner and selected Elevate Roles agentworkspace200320211.JPG

Step 3: Check the workspace_list_admin role and click OK

Step 4: Navigate to Workspace Experience>workspace>Agent workspace agentworkspace200320212.JPG

Step 5: In your workspace , click on profile image >Settings>Configure Workspace agentworkspace200320213.JPG

Step 6: Separate browser tab will open with Agent Workspace configuration record. agentworkspace200320214.JPG

Step 7: Open the Form Context menu and click on configure> Related Lists.

Step 8: Add the Workspace List Category > Workspace list to the Slushbucket and click on save button. agentworkspace200320217.JPG

Step 9: Select the Agent Workspace scope from the Application Picker.

Step 10: Scroll down to the Workspace List Categories related list. agentworkspace200320218.JPG

Step 11: Click on New agentworkspace200320219.JPG

Step 12: Fill the details as below and click on Submit button. agentworkspace2003202110.JPG

Step 11: We can see our category agentworkspace2003202111.JPG

Step 12: Scroll down to the Workspace List related list. agentworkspace2003202112.JPG

Step 13: Click on New agentworkspace2003202113.JPG

Step 14: Complete the form as follows and click on Submit button agentworkspace2003202114.JPG

Step 15: We can see our List category and list in the agent workspace agentworkspace2003202115.JPG

Configure Record Menu

Using the Record Menu agent can create a new record in Agent workspace interface. The current configuration only allows them to create an interaction. agentworkspace2003202116.JPG

Step 1: Scroll down to the New Record Menu Items related list agentworkspace2003202117.JPG

Step 2: Click on New agentworkspace2003202118.JPG

Step 3: Complete the form as follows and click on Submit button agentworkspace2003202119.JPG

Step 4: Now in the agent workspace interface we can see Case option to create new record in case table agentworkspace2003202120.JPG

Configure Ribbon Settings:

Ribbons contain information about the record, such as timeline, the user or customer summary, and SLAs.

Ribbon helps agents to get record details.

Ribbons describe contextual information about the record displayed in the form.

Each ribbon can have multiple components and each component can occupy a configured amount of screen space.

Only one ribbon can be associated with a table.

Whenever an agent selects a record from a table associated with a ribbon, the ribbon appears.

If the agent then selects a record from a table to associate with a ribbon, then ribbon disappears.

Types of Ribbon Component:

  1. Active SLA: The Active SLA ribbon displays an indicator of active SLAs, including time remaining, SLA state, and SLA breaches.

  2. CMDB Health: CMDB Health ribbon displays critical incidents, change requests, and health scores (incomplete attributes, non-compliant relationships, stale relationships) of a configuration item.

  3. CMDB Relationship: CMDB Relationships ribbon displays level 1 relationships of a configuration item.

  4. CMDB Timeline: The CMDB Timeline displays record changes, change requests, and incidents on the timeline for a configuration item. By default, the timeline shows the past 14 days.

  5. Customer360: Using this component we can display customer information.

  6. Timeline: The Timeline ribbon displays a summary of record activities, including state changes and interactions between the agent and the customer. It also shows how much time the agent and customer, or requester spent on the record. The timeline ribbon component uses the resolution shaper configuration for the selected entity table.

Ribbon Configuration:

Step 1: Navigate to Workspace Experience >Forms>Ribbon Settings agentworkspace2003202121.JPG

Step 2: Click on New Button agentworkspace2003202122.JPG

Step 3: Complete the form as follows and click on Submit button agentworkspace2003202123.JPG agentworkspace2003202124.JPG agentworkspace2003202125.JPG

Header Configuration

Configure the form header and sub headers in Agent Workspace so that agents can quickly see information about each record.

Form headers are made up of one primary header and several secondary headers, or subheaders.

Step 1: Navigate to Agent Workspace > Forms > Form Headers. agentworkspace2003202126.JPG

Step 2: Click New. agentworkspace2003202127.JPG

Step 3: Select a table from the list. Note: Configuration tables are not included as an option for form headers in Agent Workspace.

Step 4: From the Primary field list, select the field that you want as the form header. Choose a field that is descriptive and unique. For example, you could choose short_description.

Step 5: Right-click the form header and select Save.

Step 6: To add secondary fields to the form subheader, select the fields that add important details to the form, such as priority, state, and category.

Note: You can select as many secondary fields for the header as you want; however, only the first five non-empty fields show in the header.

Step 7: Click Submit.

Note: Forms can inherit the header configuration from the parent tables. For example, if the Incident [incident] table does not have a table configuration, any incident records inherit the configuration from the Task [task] table.

agentworkspace2003202128.JPG agentworkspace2003202129.JPG

Now we can see the Header and sub header and secondary field as below agentworkspace2003202150.JPG

Response template

Customer service agents can copy content from response templates and add it to cases and case tasks.

Step 1: In CSM Agent Workspace, open a customer service case or case task.

Step 2: Click on more action … on the Contextual Side panel agentworkspace2003202131.JPG Step 3: Click on Response templates agentworkspace2003202132.JPG

Step 4: In the Response Templates side panel, search for a template. agentworkspace2003202133.JPG

Step 5: Select a response template agentworkspace2003202134.JPG

Step 6: Click on Copy to clipboard. agentworkspace2003202135.JPG

Step 7: Paste the template text into the Work notes field or the Additional comments field.

Create or modify a response template

Step 1: Navigate to System Definition > Response template configuration.

Step 2: Click New or open a record.

Step 3: Fill in the fields on the form.



Reduce an agent’s time responding to requesters by automatically filling in record fields Agent use a template to auto fill in record fields. You associate templates with tables. Whenever an agent works on a record from that table, the agent can click a template to fill fields in the form.

For example, you might create a High Priority template for the problem table. Whenever agents work on a problem, if they click the template, it sets the Urgency field in the problem record to High.

Create or modify a template

Step 1: Navigate to System Definition > Templates.

Step 2: Click New.

Step 3: On the form, fill in the fields agentworkspace2003202136.JPG


Use Template

Step 1: In CSM Agent Workspace, open a customer service case or case task.

Step 2: Click on more action on the Contextual Side panel agentworkspace2003202131.JPG

Step 3: Click on Templates agentworkspace2003202138.JPG

Step 4: In the Templates side panel, search for a template and Select a template agentworkspace2003202139.JPG

Step 5: Click on template to copy the field


Landing Page

The landing page is the first thing agents will see in Agent Workspace. It displays a set of preconfigured reports and PA widgets that are specific to the agent’s work responsibilities.

Steps 1: Navigate to Agent Workspace > Landing Pages.


Steps: agentworkspace2003202142.JPG

Follow the link to create Landing page Landing Page

Search sources

Search sources in Agent Workspace define where search data is retrieved from. Step 1: Navigate to Agent Workspace > Search Sources. agentworkspace2003202143.JPG

Step 2: Click New or open an existing search source to edit. Step 3: Complete the following fields as needed. agentworkspace2003202144.JPG

Step 4: Click Save or Update.