• Form - Lens action is used when ServiceNow AI Lens is triggered to auto-fill a form. Apply a transformation logic to the Lens response before the form is auto-filled by using the servicenow-lens-actions.html#create-sn-lens-recipe__transform-response option.

  This option is available when you select Desktop or Instance from the Trigger From list.

• Service - Lens action is used when ServiceNow AI Lens is used as a service. Select this option to trigger Lens from an instance to auto-populate a Workspace form, or to trigger it using Virtual Agent or Script Include.

  This option is available when you select Instance from the Trigger From list.

• Others - Lens action is used when ServiceNow AI Lens is triggered to display a preview of extracted data and perform post processing steps, if applicable.

  This option is available when you select Desktop from the Trigger From list.

• Excel Mapping -

  Option to specify that you can use this Lens action to attach an Excel sheet and let ServiceNow AI Lens auto-map its column headers with the columns of a table. After the auto-mapping is done, you can view and change the mapping, and insert the Excel sheet data to the table.

  This option is available when you select Desktop from the Trigger From list.

• 1: Highest priority
• 999999: Least priority

The default value is set to 100.

For example, if any user is assigned to two Lens action records for the same table, the Lens action with the least number is used during Lens execution.

For example, Incident table.

• Supported Fields - Selected fields for providing enhanced context for Lens execution.
• Advanced - Script to generate a custom schema object for providing enhanced context for Lens execution.

This field appears only when Supported Fields is selected from the Request Context choice field.

This field appears only when Advanced is selected from the Request Context choice field.

Example sample script:

function preProcessRequest(lensActionRecord, inputJSON) {
    // Initialize the schema object
    var schemaObj = {};
    /*
    This is a utility method to generate schema object, 
    users can pass tableName and formFields as an array of fields for the given table to generate custom schema that is passed to the LLM.
    
    //Return schemaObj adhering to the structure defined in example
    // tableName = 'incident'
    tableName = inputJSON.tableName; 

    //formFields - array of fields for the given table.
    //formFields = ['short_description', 'comments', 'impact'];
    
    fieldsToProcess = inputJSON.formFields;
    schemaObj = new global.AILensSchemaUtil().generateSchema(tableName, fieldsToProcess);

    */
    return schemaObj;
}
var schemaObj = preProcessRequest(lensActionRecord, inputJSON);

Example of the returned schemaObj object:

schemaObj =  {
  "schemaPayload": {
    "type": "json_schema",
    "json_schema": {
      "name": "schema_extraction",
      "schema": {
        "type": "object",
        "properties": {
          "short_description": {
            "type": "string",
            "label": "Short description"
          },
          "comments": {
            "type": "string",
            "label": "Additional comments"
          },
          "impact": {
            "type": "choice",
            "label": "Impact",
            "choiceValues": ["1", "2", "3"],
            "choiceLabels": {
              "1 - High": "1",
              "2 - Medium": "2",
              "3 - Low": "3"
            }
          }
        },
        "required": [
          "short_description",
          "comments",
          "impact"
        ],
        "additionalProperties": false
      }
    }
  },
  "fieldLabels": ["short_description", "comments", "impact"]  //Optional key
}

For example, Summarize this paper by extracting the title, author name, publication date in the dd-mm-yyyy format, abstract, and keywords

This field appears only when Form is selected from the Trigger For choice field.

This field appears only when the Transform Response option is selected.

Sample script:

function transformResponseScript(lensActionRecord, lensResponse) {
   // Initialize the schema object
    var transformResponse = {};
    
    //Add your code here
    
    //Return schemaObj adhering to the structure defined in example
    return transformResponse;
}
var transformResponse = transformResponseScript(lensActionRecord, lensResponse);

Example of the returned transformResponse object:

transformResponse = {
  "short_description": "Service Degradation Error in Order Processing System",
  "description": "The Order Processing API v2.1 encountered a service degradation issue in the Production environment",
  "urgency": "1"
}

This field appears only when Others or Service is selected from the Trigger For field.

This field appears only when the Enable Post Processing option is selected.

function postProcessResponse(lensActionRecord, lensResponse, lensExecutionRecord) {
    
    //Add your code here

}
postProcessResponse(lensActionRecord, lensResponse, lensExecutionRecord);

Option to wait for ServiceNow AI Lens to display the output of post-processing on the Preview window. If enabled, it waits for the post processing output. Else, it doesn't wait for post processing output but post processing continues in the background.

The maximum time ServiceNow AI Lens waits to display the output of post-processing. If the output doesn't appear within this duration, the session times out while the post-processing continues in the background until completion.