Include de script : AILensActionService

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 2 minutes de lecture

    • Utilisez l’include de script AILensActionService avec les actions Lens pour ServiceNow AI Lens extraire des informations des images fournies et obtenir des réponses à vos questions.

    Cet include de script fait partie de l’application ServiceNow AI Lens de stockage (sn_ai_lens) et se trouve dans le périmètre de sn_app_lens_core .

    Cet include de script fournit des méthodes qui activent les éléments suivants :
    • Appelle Lens en tant que service back-end
    • Analyse et comprend les données à partir des images fournies
    • Obtient une Now Assist réponse selon les instructions fournies
    • Ne nécessite pas d’application ServiceNow AI Lens de bureau

    AILensActionService : AILensActionService()

    Crée une instance AILensActionService.

    Tableau 1. Paramètres
    Nom Type Description
    Aucun

    L’exemple suivant montre comment initialiser AILensActionService.

    var lensService = new sn_app_lens_core. AILensActionService()

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

    Invoque ServiceNow AI Lens en tant que service.

    Tableau 2. Paramètres
    Nom Type Description
    lensActionId Chaîne Sys_id de l’enregistrement Actions de filtre créé pour votre cas d’utilisation. Vous pouvez également sélectionner l’option prête à l’emploi qui correspond à vos besoins.

    Exemple : 842bfc8e37066210b97528c734924baf

    Ce paramètre est obligatoire.
    AttachmentIds Chaîne[] Tableau de sys_ids pour les pièces jointes existantes.

    Exemple : ["0067e66f93f022108319f9ed1dba108b », « 0000e8a42c9a7110f877137af4eab4b5"]

    Vous devez transmettre le paramètre attachmentIds ou imageArr .
    userPrompt Chaîne Instruction ou question à Now Assist laquelle répondre après avoir analysé le contenu des pièces jointes.

    Exemple : analyser ce problème de production et créer un ticket d’incident
    imageArr Objet[] Tableau d’objets contenant le nom de la capture d’écran et les données d’image codées en base64.

    Exemple :

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

    Vous devez transmettre le paramètre attachmentIds ou imageArr .
    inputJSON Objet Paramètres d’entrée JSON supplémentaires que vous souhaitez transmettre dans le script de prétraitement de l’action de filtre.

    Exemple :

    {
      "type" : "object",
      "properties" : {
        "short_description" : {
          "type" : "string",
          "label" : "Short description"
        },
        "description" : {
          "type" : "string",
          "label" : "Description"
        },
      },
      "required" : [ "short_description", "comments" ],
   }
    additionalContext Objet Paramètre facultatif que vous pouvez utiliser pour transmettre toute information clé-valeur supplémentaire du client au serveur pendant l’appel d’action du filtre.
    Exemple
    {IsFileUploadEnabled: true}
    Tableau 3. Renvoie
    Type Description
    <object> Objet de réussite renvoyé
    {
    "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.\" }"
}
    erreur Objet d’erreur renvoyé
    {
    "status": "error",
    "error": {
        "errorType": "Execution Error",
        "message": "Detailed error message here"
    }
}

    Cet exemple montre comment appeler le service Lens à partir d’un bloc 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);
}