Inclusão de script - AILensActionService

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 2 min. de leitura
  • Use AILensActionService Inclusão de script junto com ações de lente a serem aproveitadas Lente de IA da ServiceNow como um serviço para extrair informações das imagens fornecidas e obter respostas para suas perguntas.

    Esta inclusão de script faz parte de Lente de IA da ServiceNow(sn_ai_lens) store e está localizado em sn_app_lens_core escopo.

    Esta inclusão de script fornece métodos que permitem o seguinte:
    • Chama o Lens como um serviço de back-end
    • Analisa e compreende os dados das imagens fornecidas
    • Obtém resposta de Now Assist de acordo com as instruções fornecidas
    • Não requer Lente de IA da ServiceNow aplicativo para desktop

    AILensActionService - AILensActionService()

    Cria uma instância AILensActionService.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como inicializar AILensActionService .

    var lensService = new sn_app_lens_core. AILensActionService()

    AILensActionService - invokeLens(cadeia de caracteres lensActionId, cadeia de caracteres[] attachmentIds, cadeia de caracteres userPrompt, Object[] imageArr, Object inputJSON)

    Invoca Lente de IA da ServiceNow como um serviço.

    Tabela 2. Parâmetros
    Nome Tipo Descrição
    LensActionId Cadeia de caracteres Sys_id do registro Ações de lente criado para seu caso de uso ou você pode selecionar a opção pronta para uso que atende aos seus requisitos.

    Exemplo: 842bfc8e37066210b97528c734924baf

    Este parâmetro é obrigatório.

    AttachmentIds Cadeia de caracteres[] Matriz de sys_ids para anexos de imagem existentes.

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

    Você deve ser aprovado AttachmentIds ou ImageArr parâmetro.

    userPrompt Cadeia de caracteres Uma instrução ou pergunta para Now Assist para responder depois de analisar o conteúdo dos anexos.

    Exemplo: Analise este problema de produção e crie um tíquete de incidente

    ImageArr Objeto[] Matriz de objetos que contém o nome da captura de tela e os dados de imagem codificada em base64.

    Exemplo:

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

    Você deve ser aprovado AttachmentIds ou ImageArr parâmetro.

    inputJSON Objeto Parâmetros de entrada JSON adicionais que você deseja passar no script de pré-processamento da ação de Lente.

    Exemplo:

    {
          "type" : "object",
          "properties" : {
            "short_description" : {
              "type" : "string",
              "label" : "Short description"
            },
            "description" : {
              "type" : "string",
              "label" : "Description"
            },
          },
          "required" : [ "short_description", "comments" ],
       }
    Contexto adicional Objeto Um parâmetro opcional que você pode usar para passar informações extras de chave-valor do cliente para o servidor durante a chamada de ação Lente.
    Exemplo
    {IsFileUploadEnabled: true}
    Tabela 3. Retornos
    Tipo Descrição
    <object> Objeto de sucesso retornado
    {
        "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.\" }"
    }
    erro Objeto de erro retornado
    {
        "status": "error",
        "error": {
            "errorType": "Execution Error",
            "message": "Detailed error message here"
        }
    }

    Este exemplo mostra como chamar o serviço do Lens a partir de um bloco de script.

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