스크립트 포함 - AILensActionService

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 6분

    • AILensActionService 스크립트 포함을 렌즈 작업과 함께 사용하여 제공된 이미지에서 정보를 추출하고 질문에 대한 답변을 얻기 위한 서비스로 활용 ServiceNow AI 렌즈 합니다.

    이 스크립트 포함은 (sn_ai_lens) 스토어 애플리케이션의 일부 ServiceNow AI 렌즈 이며 sn_app_lens_core 범위 내에 있습니다.

    이 스크립트 포함은 다음을 가능하게 하는 메서드를 제공합니다.
    • 렌즈를 백엔드 서비스로 호출
    • 제공된 이미지의 데이터를 분석하고 이해합니다.
    • 제공된 지시에 따라 응답을 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 입니다.

    예: 이 프로덕션 문제를 분석하고 인시던트 티켓 생성
    이미지 Arr 목적어[] 스크린샷의 이름과 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" ],
   }
    additionalContext 객체 렌즈 작업 호출 중에 클라이언트에서 서버로 추가 키-값 정보를 전달하는 데 사용할 수 있는 선택적 매개변수입니다.
    예제
    {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"
    }
}

    이 예제에서는 스크립트 블록에서 렌즈 서비스를 호출하는 방법을 보여줍니다.

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