スクリプトインクルード:AILensActionService

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：6分

    • AILensActionService スクリプトインクルードをレンズアクションと一緒に使用して、提供された画像から情報を抽出し、質問への回答を得るために ServiceNow AI レンズ as a service を活用します。

    このスクリプトインクルードは、 ServiceNow AI レンズ (sn_ai_lens) ストアアプリケーションの一部であり、 sn_app_lens_core スコープ内にあります。

    このスクリプトインクルードは、以下を可能にするメソッドを提供します。
    • Lens をバックエンドサービスとして呼び出します
    • 提供された画像からのデータを分析して把握します
    • 指定された指示に従って Now Assist から応答を取得します
    • ServiceNow AI レンズデスクトップアプリを必要としない

    AILensActionService:AILensActionService()

    AILensActionService インスタンスを作成します。

    表 : 1. パラメーター
    名前 タイプ 説明
    なし

    次の例は、 AILensActionService を初期化する方法を示しています。

    var lensService = new sn_app_lens_core. AILensActionService()

    AILensActionService:invokeLens(String lensActionId, String[] attachmentIds, String userPrompt, Object[] imageArr, Object inputJSON)

    ServiceNow AI レンズをサービスとして呼び出します。

    表 : 2. パラメーター
    名前 タイプ 説明
    lensActionId 文字列 ユースケース用に作成されたレンズアクションレコードのSys_id、または要件に適したすぐに利用可能なオプションを選択できます。

    例:842bfc8e37066210b97528c734924baf

    このパラメーターは必須です。
    attachmentId 文字列[] 既存の画像添付ファイルのsys_idsのアレイ。

    例: ["0067e66f93f022108319f9ed1dba108b", "0000e8a42c9a7110f877137af4eab4b5"]

    attachmentIds または imageArr パラメーターを渡す必要があります。
    userPrompt 文字列 添付ファイルの内容を分析した後に回答する Now Assist 指示または質問。

    例: この本番の問題を分析し、インシデントチケットを作成する
    imageArr オブジェクト [] スクリーンショットの名前と base64 エンコード画像データを含むオブジェクトのアレイ。

    例：

    [
    {
        name: "screenshot1.png",
        data: "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg=="
    },
    {
        name: "screenshot2.png",
        data: "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9Qz0AEYAJMgkU1f5kAAAAASUVORK5CYII="
    }
];

    attachmentIds または imageArr パラメーターを渡す必要があります。
    inputJSON オブジェクト レンズアクションの前処理スクリプトで渡す追加の JSON 入力パラメーター。

    例：

    {
      "type" : "object",
      "properties" : {
        "short_description" : {
          "type" : "string",
          "label" : "Short description"
        },
        "description" : {
          "type" : "string",
          "label" : "Description"
        },
      },
      "required" : [ "short_description", "comments" ],
   }
    追加コンテキスト オブジェクト レンズアクションの呼び出し中にクライアントからサーバーに追加のキー値情報を渡すために使用できるオプションのパラメーター。
    例
    {IsFileUploadEnabled: true}
    表 : 3. 返される内容
    タイプ 説明
    <object> 返された成功オブジェクト
    {
    "status": "success",
    "lensResponse": "{\"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.\" }"
}
    エラー 返されたエラーオブジェクト
    {
    "status": "error",
    "error": {
        "errorType": "Execution Error",
        "message": "Detailed error message here"
    }
}

    この例では、スクリプトブロックから Lens サービスを呼び出す方法を示します。

    var lensActionId = "cd6570cdf36a2210b9751f09f6968c42";
var attachmentIds = ["3fe930093b626210aba1fadc73e45a38", "0000e8a42c9a7110f877137af4eab4b5"];
var userPrompt = "Analyze this production issue and create an incident ticket";
var imageArr = [
    {
        name: "screenshot1.png",
        data: "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg=="
    },
    {
        name: "screenshot2.png",
        data: "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9Qz0AEYAJMgkU1f5kAAAAASUVORK5CYII="
    }
];
var inputJSON = {
      "type" : "object",
      "properties" : {
        "short_description" : {
          "type" : "string",
          "label" : "Short description"
        },
        "description" : {
          "type" : "string",
          "label" : "Description"
        },
      },
      "required" : [ "short_description", "comments" ],
   }
var additionalContext = {
      IsFileUploadEnabled: true};

 // Call the method
var result = new sn_app_lens_core. AILensActionService().invokeLens(lensActionId, attachmentIds, userPrompt, imageArr, inputJSON, skipACL, additionalContext);
 
// Handle the response
if (result.status === 'success') {
    var response = JSON.parse(result.lensResponse);
    gs.info("AI Lens Analysis Complete:");
    gs.info("Title:", response.short_description);
    gs.info("Description:", response.description);
} else {
    gs.error("Error occurred:", result.error.message);
}