• フォーム :レンズアクションは、フォームに自動入力するために ServiceNow AI レンズ がトリガーされたときに使用されます。servicenow-lens-actions.html#create-sn-lens-recipe__transform-responseオプションを使用して、フォームが自動入力される前にレンズ応答に変換ロジックを適用します。

  このオプションは、[トリガー元] リストから [ デスクトップ ] または [ インスタンス ] を選択した場合に使用できます。

• サービス :レンズアクションは、 ServiceNow AI レンズ がサービスとして使用される場合に使用されます。インスタンスからレンズをトリガーしたり、 ワークスペースフォームに自動入力したり、 仮想エージェント またはスクリプトインクルードを使用してトリガーしたりするには、このオプションを選択します。

  このオプションは、[トリガー元] リストから [インスタンス ] を選択した場合に使用できます。

• その他 :レンズアクションは、抽出されたデータのプレビューを表示し、該当する場合は後処理ステップを実行するために ServiceNow AI レンズ がトリガーされたときに使用されます。

  このオプションは、[トリガー元] リストから [ デスクトップ ] を選択した場合に使用できます。

• Excel マッピング:

  このレンズアクションを使用して Excel シートを添付し、その列ヘッダーをテーブルの列に ServiceNow AI レンズ 自動マッピングできるように指定するオプション。自動マッピングが完了したら、マッピングを表示および変更し、Excel シートデータをテーブルに挿入できます。

  このオプションは、[トリガー元] リストから [ デスクトップ ] を選択した場合に使用できます。

• 1：最高優先度
• 999999：最低優先度

デフォルト値は 100 に設定されています。

たとえば、同じテーブルの 2 つのレンズアクションレコードにユーザーがアサインされている場合、番号が最も小さいレンズアクションがレンズの実行中に使用されます。

たとえば、インシデントテーブルなどです。

• サポートされているフィールド :レンズ実行の拡張コンテキストを提供するために選択されたフィールド。
• 詳細 :レンズ実行の拡張コンテキストを提供するためのカスタムスキーマオブジェクトを生成するスクリプト。

このフィールドは、[要求コンテキスト] 選択フィールドで [サポートされているフィールド] が選択されている場合にのみ表示されます。

このフィールドは、[要求コンテキスト] 選択肢フィールドで [詳細] が選択されている場合にのみ表示されます。

サンプル スクリプトの例:

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);

返されたschemaObjオブジェクトの例:

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
}

たとえば、タイトル、著者名、dd-mm-yyyy形式の発行日、要約、およびキーワードを抽出して、この論文を要約します

このフィールドは、[トリガー対象] 選択肢フィールドで [フォーム] が選択されている場合にのみ表示されます。

このフィールドは、[ 応答を変換] オプションが選択されている場合にのみ表示されます。

サンプル スクリプト：

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);

返された transformResponse オブジェクトの例:

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"
}

このフィールドは、[トリガー対象] フィールドで [その他] または [サービス] が選択されている場合にのみ表示されます。

このフィールドは、[ 後処理を有効にする] オプションが選択されている場合にのみ表示されます。

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

}
postProcessResponse(lensActionRecord, lensResponse, lensExecutionRecord);

ServiceNow AI レンズが [プレビュー] ウィンドウに後処理の出力を表示するまで待機するオプション。有効にすると、後処理出力を待機します。それ以外の場合は、後処理出力を待機せず、バックグラウンドで後処理が続行されます。

ServiceNow AI レンズが後処理の出力を表示するまで待機する最大時間。この期間内に出力が表示されない場合、セッションはタイムアウトしますが、完了するまでバックグラウンドで後処理が続行されます。