---
sourceDocument: Australia Employee Service Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/employee-service-management

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia Employee Service Management

ft:clusterId :

    - emplsm

bundleId :

    - emplsm

workflow :

    - Employee


---

# Configure a custom AI insights skill

# Configure a custom AI insights skill for a task type {#ariaid-title1}

Release version: Australia  
Updated July 27, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 minutes to read  
Configure a task to use a custom Now Assist skill for AI insights in the Task details widget. Optionally add a custom script to pre-process input or post-process the skill response.

## Before you begin

Verify that the Generative AI plugin (sn_generative_ai) and the configured skill are active.

Select and activate a Now Assist skill that works best for the task type.

Role required: sn_hr_sp.esc_admin or admin

## About this task

AI insights help employees understand task details and make informed decisions. Configure a skill for each task type that requires AI-generated insights in the
Task details widget. Learn about task scope and action widget configuration from [Configure task scope and action widget](https://servicenow-prod.fluidtopics.net/aQZ9Fk9xxpUHlmIMHmB3Mw "Configure the applicable task scope and the actions with a custom AIX action widget. Use this when you need task-specific actions that differ from the standard action group."){#empworks-configure-ai-insights-skill__empworks-configure-ai-insights-skill-context-1}

You can configure custom skills to provide task-specific insights. Examples include:

* Policy compliance checks for Concur approval tasks
* Field-level insights for CLM contract tasks
* Time-off balance details for leave requests

{#empworks-configure-ai-insights-skill__ul_f4n_w2t_5jc}  
Note:  
The widget displays AI insights only when you configure a skill for the task type.  
Note:  
Custom AI insights skill configuration is available in North America only.

## Procedure

1. Go to AllEmployee CenterAdministrationTo-dos Configurations, select an existing to-dos configuration (for example, sn_hr_sp_todos_config) for the task category, such as Approvals), and navigate to the Task Configuration related list.
2. In the Task Configurations related list, open the task configuration for the required record type, such as Request.  
   Task configuration page and its related list open.Figure 1. Task configuration with AI insights skill
3. Go to the AI insights tab and select the AI insights skill field to a Now Assist skill from the available list.  
   Figure 2. Task configuration with AI insights skill field You can select one of the two
   * Existing AI Insight Skills: Select from the existing pre-configured AI Insight skills provided by ServiceNow.
   * Custom AI Insight Skills: Enable custom skill processing by checking the custom skill option and providing your JSON format configuration.

   Note:  
   By default, the AI insights skill field is empty. Administrators can select the available skills such as built-in Checklist Generation skill instead of building a custom one. For example, select the built-in Approval summary checklist generation skill to show the approval checklist behavior. The checklist appears only while the approval is still actionable. For Employee Slate in North America, this skill defaults to On-demand to support customers who are upgrading.
4. **Optional:** Select the Use custom script check box to customize how the skill processes data,  
   Write a script in the Skill execution script field that performs the following actions:
   * Pre-processes the input data
   * Calls the AI insights skill
   * Post-processes the skill output
   * Returns a response that matches the skill output contract

   Figure 3. Custom skill configuration

   Use a custom script to fetch external data before the skill runs. For example, fetch leave balances from Workday before a leave-approval task runs. You can also retrieve prior expense reports from Concur before
   an expense-approval task runs. Your script can use the following variables to build internal record or knowledge article URLs:

   hostname
   :   The virtual host of the instance, for example now.

   experience
   : The current experience suffix, for example employee or aiux-portal.  
   The Skill execution script field opens.
5. Confirm that the task configuration is Active.
6. Save the task configuration.  
   You can now see the associated skill from the Task Configuration tab. The configured skill or your custom script generates AI insights for every record of that task type in the experience set by Applies to.

## Result

Employees who open the task type see a summary and any reference links in the AI response card. The configured skill generates AI insights for every record of that task
type.{#empworks-configure-ai-insights-skill__empworks-configure-ai-insights-skill-result-1}
The skill run fails if the selected skill does not accept sys_id and table parameters or if its output does not match the expected
format. When a skill run fails, you see an error message instead of insights. To remove the AI insights section for that task type, clear the AI insights skill field and reload the page.{#empworks-configure-ai-insights-skill__empworks-configure-ai-insights-skill-postreq-1}

The skill execution script fails if it does not return a response that matches the skill output contract. When the script fails, you see a generic error message instead of insights.

Understand the basics of AI insights skill, see [AI insights skill reference](https://servicenow-prod.fluidtopics.net/SgTFNpxfqtJrURIdOxJ1nw "Build a custom Now Assist skill that generates AI insights for the task details widget. Use this reference for the input, output, and error contract your skill must follow.").
**Related tasks**   

* [Configure task scope and action widget](https://servicenow-prod.fluidtopics.net/aQZ9Fk9xxpUHlmIMHmB3Mw "Configure the applicable task scope and the actions with a custom AIX action widget. Use this when you need task-specific actions that differ from the standard action group.")  
**Related reference**   

* [AI insights skill reference](https://servicenow-prod.fluidtopics.net/SgTFNpxfqtJrURIdOxJ1nw "Build a custom Now Assist skill that generates AI insights for the task details widget. Use this reference for the input, output, and error contract your skill must follow.")

*[\>]: and then