Definir Lente da ServiceNow Comportamento com ações de lente

Como administrador do Lens, você pode criar ações do Lens em Lente da ServiceNow Para personalizar o comportamento da lente fornecendo instruções padrão, configurando o contexto e muito mais.

Use Ações de lente para definir instruções padrão, opções de gatilho, contexto personalizado e instruções de pós-processamento para a resposta da lente. Com as Ações de lente, você pode atingir os seguintes objetivos:

• Gatilho Lente da ServiceNow em uma área de trabalho, ServiceNow instância, ou Virtual Agent(de um dispositivo móvel ou portal)
• Preenche automaticamente um formulário no ServiceNow instância
• Exiba as informações coletadas em uma visualização editável
• Acionar fluxos, subfluxos ou ações após a execução do Lens
• Invocar agentes de IA
• Executar Lente da ServiceNow como um serviço de back-end

Sempre que Lente da ServiceNowÉ iniciado a partir de uma instância, verifica se alguma ação de lente ativa está disponível para a tabela. Se disponível, ele usa a lógica definida na ação de lente durante a execução. A ação de lente só pode ser usada pelos usuários ou grupos atribuídos ao registro Ações de lente.

Consulte os exemplos a seguir para entender os diferentes casos de uso da configuração das ações de lente.

• Exemplo: Digitalize documentos para preencher automaticamente o formulário Solicitação de seguro
• Exemplo: Extrair dados estruturados de acordos de fornecedor
• Exemplo: Preencher registros de usuário automaticamente em uma tabela de usuário

Personalizar Lente da ServiceNow Criando uma ação de Lente

Crie uma ação de Lente para definir contexto personalizado, opções de gatilho e instruções padrão para Lente da ServiceNow execução.

Antes de Iniciar

Função necessária: Lens_admin

Por Que e Quando Desempenhar Esta Tarefa

Saiba mais sobre as várias opções de gatilho para Lente da ServiceNow.

Tabela 1. Opções de gatilho de lente

Objetivo	Gatilho de	Gatilho para
Preencher automaticamente um formulário com um contexto personalizado e instruções padrão quando acionado a partir da instância. Quando Lente da ServiceNowÉ acionado a partir da instância no contexto da ação Lente, as instruções padrão são sempre aplicadas e os campos de formulário específicos são extraídos.	Instância	Formulário
Preencher automaticamente um formulário com um contexto personalizado e instruções padrão quando acionado a partir do Lente da ServiceNow aplicativo para desktop. Você pode acionar Lente da ServiceNow No aplicativo para desktop diretamente no contexto da ação do Lens em vez de iniciar o Lens na instância. As instruções padrão são sempre aplicadas e campos de formulário específicos são extraídos.	Desktop	Formulário
Com a ajuda de um script de cliente ou script de servidor, execute Lente da ServiceNow como um serviço de back-end.	Instância	Serviço
Exiba as informações coletadas na janela de visualização de Lente da ServiceNow fornecendo contexto personalizado e executando etapas de pós-processamento.	Desktop	Outros

Quando Lente da ServiceNowÉ acionado a partir da instância ou da área de trabalho para preencher automaticamente um formulário, ele usa uma ação de lente ativa associada à tabela de destino.

Por exemplo, se um usuário selecionar Criar com o Lens Na lista da tabela de incidentes, Lente da ServiceNow Verifica se há um registro de ação de lente ativo para a tabela Incidente em que Gatilho de Definido como Instância e. Gatilho para Definido como formulário. Se existir um registro de ação correspondente, o Lens será executado no contexto dessa ação.

A ação de lente só pode ser usada pelos usuários ou grupos atribuídos ao registro Ações de lente.

Procedimento

1. Navegar até Tudo > Lente da ServiceNow > Ações da Lente.
2. Insira um nome e uma descrição para a ação de Lente.
3. Em Gatilho de , selecione uma das seguintes opções.

   Opção	Descrição
   Desktop	Define que esta ação deve ser usada quando Lente da ServiceNowé acionado a partir de Lente da ServiceNow aplicativo para desktop.
   Instância	Define que esta ação deve ser usada quando Lente da ServiceNowé acionado a partir de um ServiceNow instância.

4. Selecione Salvar no cabeçalho do formulário.
5. No formulário Ações de lente, preencha os campos.

   Tabela 2. Formulário Ações de lente

   Campo	Descrição
   Gatilho para	Formulário Ação de lente é usada quando Lente da ServiceNowé acionado para preencher automaticamente um formulário. Você também pode aplicar qualquer lógica de transformação à resposta do Lens antes que o formulário seja preenchido automaticamente. Serviço Ação de lente é usada quando Lente da ServiceNowé usado como um serviço. Selecione esta opção para acionar o Lens de uma instância para preencher automaticamente um Formulário Espaço , ou para acioná-lo usando Virtual Agent Ou Inclusão de script. Outros Ação de lente é usada quando Lente da ServiceNowé acionado para exibir uma visualização dos dados extraídos e executar etapas de pós-processamento, se aplicável.
   Ordem	Prioridade de execução da ação de Lente para uma determinada tabela: 1 Prioridade mais alta 999999 Menor prioridade O valor padrão é definido como 100. Por exemplo, se algum usuário for atribuído a dois registros de ação de lente para a mesma tabela, a ação de lente com o menor número será usada durante a execução da lente.
   Tabela	Tabela à qual esta ação de Lente se aplica. A tabela Selecionada fornece contexto durante a execução do Lens quando campos específicos são selecionados ou o script é fornecido. Por exemplo, tabela Incidente.
   Solicitar contexto	Opção para fornecer contexto aprimorado durante a execução do Lens selecionando campos específicos ou fornecendo esquema personalizado por script. Campos compatíveis - Campos selecionados para fornecer contexto aprimorado para a execução do Lens. Avançado - Script para gerar um objeto de esquema personalizado para fornecer contexto aprimorado para a execução do Lens.
   Campos	Campos de tabela que você pode selecionar para fornecer contexto aprimorado para a execução do Lens. Selecione os campos para ajudar o Lens a determinar quais informações extrair das imagens. Somente os campos compatíveis com o Lens estão disponíveis para seleção. Para obter mais informações, consulte Tipos de campo compatíveis. Este campo aparece somente quando Campos compatíveis selecionado em Contexto da solicitação campo de opção.
   Pré-processando script	Script para gerar um objeto de esquema personalizado para fornecer contexto aprimorado para a execução do Lens. O esquema personalizado ajuda o Lens a determinar quais informações extrair das imagens. Este campo aparece somente quando Avançado selecionado em Contexto da solicitação campo de opção. Exemplo de script: 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); Parâmetros aceitos pelo PreProcessRequest método: LensActionRecord (Entrada) - GlideRecord da ação de lente que é executada. InputJSON (Entrada) - Objeto JSON opcional que os usuários podem passar por APIs de serviço. Obj Esquema (Saída) - Objeto JSON retornado do esquema personalizado. Exemplo do objeto schemaObj retornado: 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 }
   Direções padrão adicionais	Instruções padrão fornecidas para Now Assist além das instruções fornecidas pelo usuário. Por exemplo, Resuma este artigo extraindo o título, o nome do autor, a data de publicação no formato dd-mm-aaaa, o resumo e as palavras-chave
   Transformar resposta	Opção para especificar o script de transformação para transformar a resposta do Lens antes de preencher automaticamente o formulário. Este campo aparece somente quando Formulário selecionado em Gatilho para campo de opção.
   Script de transformação	Script que transforma a resposta do Lens antes de preencher o formulário. Este campo aparece somente quando Resposta de transformação a opção está selecionada. Script de exemplo: 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); Parâmetros aceitos pelo TransformResponseScript método: LensActionRecord (Entrada) - GlideRecord da ação de lente que é executada. LensResponse (Entrada) - Objeto JSON da resposta do Lens fornecido após a execução do Lens. TransformResponse (Saída) - Objeto JSON retornado do esquema transformado. Exemplo do objeto transformResponse retornado: 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" }
   Habilitar pós-processamento	Opção para especificar instruções de processamento avançado após a conclusão da execução da lente. Este campo aparece somente quando Outros ou Serviço selecionado em Gatilho para campo.
   Script de pós-processamento	Script executado de forma assíncrona após a execução do Lens para processar ainda mais a resposta do Lens, como acionar um fluxo, subfluxo, ações ou agente de IA. Este campo aparece somente quando Habilitar pós-processamento a opção está selecionada. function postProcessResponse(lensActionRecord, lensResponse) { //Add your code here } postProcessResponse(lensActionRecord, lensResponse); Parâmetros aceitos pelo PostProcessResponse método: LensActionRecord (Entrada) - GlideRecord da ação de lente que é executada. LensResponse (Entrada) - Objeto JSON da resposta do Lens fornecido após a execução do Lens.
   Anexar imagens capturadas ao registro	Opção para anexar as imagens capturadas ao registro que é preenchido automaticamente usando Lente da ServiceNow. Esta opção está habilitada por padrão.

6. Atribua usuários ou grupos que podem usar esta ação de Lente.
   1. Na lista relacionada Usuários e grupos atribuídos, selecione Novo .
   2. Adicione usuários ou grupos que podem usar esta ação de Lente.
      Você pode criar somente um mapeamento de usuários e grupos atribuídos para qualquer ação do Lens.

      Opção	Etapas
      Usuários	Selecione o ícone de cadeado ao lado de Usuários campo. PESQUISE e selecione os registros do usuário de destino no campo de referência. Selecione o ícone de cadeado novamente para bloquear o campo. Selecione Enviar. Nota: Somente os usuários que têm a função lens_user estão disponíveis para seleção no campo de referência.
      Grupos	Selecione o ícone de cadeado ao lado de Grupos campo. PESQUISE e selecione os registros do grupo de destino no campo de referência. Selecione o ícone de cadeado novamente para bloquear o campo. Selecione Enviar. Nota: Selecione os grupos que têm usuários com a função lens_user.

   3. Selecione Enviar.
7. Selecione Atualizar.
8. Selecione Ativar Para ativar a ação de Lente.

Exemplo: Digitalize documentos para preencher automaticamente o formulário Solicitação de seguro

Permita que os clientes digitalizem documentos relacionados a acidentes de carro em sua área de trabalho para preencher automaticamente o formulário Solicitação de seguro no ServiceNow instância.

Antes de Iniciar

Função necessária: Lens_admin

Por Que e Quando Desempenhar Esta Tarefa

Você pode definir na ação de Lente que Lente da ServiceNow Deve ser acionado na área de trabalho para preencher automaticamente o formulário Solicitação de seguro. A ação de lente inclui os campos que devem ser atualizados com os dados extraídos.

Procedimento

1. Navegar até Tudo > Lente da ServiceNow > Ações da Lente.
2. Em Nome campo, insira Preencher solicitação de seguro automaticamente na área de trabalho .
3. Em Descrição campo, insira Ação de lente para que o Boxeo Insurance preencha automaticamente o formulário de solicitação de seguro quando o Lens for acionado a partir da área de trabalho .
4. Em Gatilho de Opção, selecione Desktop.
5. No cabeçalho do formulário, selecione Salvar .
6. Em Gatilho para Opção, selecione Formulário.
7. Em Tabela Selecione a tabela Solicitação de seguro.
8. Em Contexto da solicitação Campo, selecione Campos compatíveis para fornecer contexto.
9. Em Campos Mover campos para a lista Selecionado.
   policy_number, location_of_incident, policy_holder_name, vehicle_number, policy_state, policy_checks_failed, policy_checks_passed, incident_date_time, damage_description, claim_type, claim_evaluation_percentage
10. Em Direções adicionais padrão , insira as seguintes direções para Now Assist.

    1. Incident Date : If available, extract the date from pictures uploaded.
    2. Personal Information:
    	○ Names: Generate name from images or documents attached. If not present do not hallucinate.
    3. Location:
    	○ If a vehicle number is visible, extract the corresponding city or state from images. If not found in images based on the vehicle number extract U.S city/state and use it as the location.
    	○ If no vehicle number is visible, leave the field blank.
    4. Vehicle Number:
    	○ If present, use the visible vehicle number.
    	○ If not present, extract vehicle number from images like driving license. If not present, leave the field empty.
    5. Policy Checks:
    	○ Refer to the policy checks document for validation.  
    	○ List only passed checks in policyChecksPassed as an HTML table with columns: Check Name, Status, Remarks.
    	○ List only failed checks in policyChecksFailed as an HTML table with columns: Check Name, Status, Remarks. If a document/image is not found for a check then add it to the policyChecksFailed.
    	○ No validation should be skipped. Consider all rules under each policy section and add them into policyChecksPassed or policyChecksFailed based on they status whether they are passed or failed.
    6. Claim Evaluation:
    	○ Calculate the claimEvaluationPercentage using the formula:
    (Number of Passed Checks / Total Number of Checks) * 100
    7. Policy State:
    	○ "Valid" – if Claim Evaluation is 100,
    	○ "Needs More Information" – if Claim Evaluation is greater than 50 and less than 100,
    	○ "Failed" – if Claim Evaluation is less than or equal to 50.
    8. Ensure the final output with all the above fields accurately filled.

11. Adicione usuários ou grupos que podem usar esta ação de Lente.
    1. Na lista relacionada Usuários e grupos atribuídos, selecione Novo .
    2. Selecione os usuários necessários ou o grupo de usuários que têm a função lens_user.
       Somente os usuários atribuídos ou o grupo de usuários podem aproveitar a ação de lente durante a execução da lente.
    3. Selecione Enviar.
12. Selecione Atualizar.
13. Selecione Ativar Para ativar a ação de Lente.

Exemplo: Extrair dados estruturados de acordos de fornecedor

Permita que os analistas de conformidade digitalizem e revisem vários acordos de fornecedor. Em vez de inserir detalhes manualmente, eles podem ser iniciados Lente da ServiceNow diretamente da área de trabalho, verifique os acordos e ajuste os valores extraídos na janela de visualização antes de salvar.

Antes de Iniciar

Função necessária: Lens_admin

Por Que e Quando Desempenhar Esta Tarefa

Você pode definir na ação de Lente que Lente da ServiceNow deve ser acionado na área de trabalho para digitalizar documentos salvos no sistema do usuário. Com a opção de pós-processamento, você pode editar as informações extraídas na janela de visualização antes de salvar e acionar o pós-processamento para criar registros de lista relacionada.

Procedimento

1. Navegar até Tudo > Lente da ServiceNow > Ações da Lente.
2. Em Nome campo, insira Extraia dados de acordos de fornecedor .
3. Em Descrição campo, insira Digitalize e revise vários acordos de fornecedor .
4. Em Gatilho de Opção, selecione Desktop.
5. No cabeçalho do formulário, selecione Salvar .
6. Em Gatilho para , selecione Outros.
7. Em Contexto da solicitação , selecione Avançado.
8. Em Script de pré-processamento insira o script para gerar o objeto de esquema personalizado para fornecer contexto aprimorado.
   Este é o exemplo de objeto de esquema personalizado retornado:

   schemaObj =  {
     "schemaPayload": {
       "type": "json_schema",
       "json_schema": {
         "name": "schema_extraction",
         "schema": {
           "type": "object",
           "properties": {
             "vendorName": {
               "type": "string",
               "label": "Vendor Name"            
             },
             "contractTitle": {
               "type": "string",
               "label": "Contract Title"
             },
             "contractReferenceNumber": {
               "type": "string",
               "label": "Contract Reference Number"
             },
             "contractStartDate": {
               "type": "string",            
               "label": "Contract Start Date"
             },
             "contractEndDate": {
               "type": "string",
               "label": "Contract End Date"
             },
             "renewalTerminationClauses": {
               "type": "string",
               "label": "Renewal / Termination Clauses"
             }
           },
           "required": [
             "vendorName",
             "contractTitle",
             "contractReferenceNumber",
             "contractStartDate",
             "contractEndDate"
           ],
           "additionalProperties": false
         }
       }
     },
     "fieldLabels": ["vendorName", "contractTitle", "contractReferenceNumber", "contractStartDate", "contractEndDate"]  //Optional key
   }

9. Em Direções adicionais padrão , insira direções para Now Assist, como Se você não encontrar as informações relevantes, deixe os campos em branco. Não alucinar. Insira a data em DD-MM-AAAA.
10. Selecione Habilitar pós-processamento opção.
11. Em Script de pós-processamento Insira o script para fornecer a lógica de pós-processamento para a resposta do Lens após a conclusão da execução do Lens.
    Você pode fornecer uma lógica de pós-processamento para passar os dados extraídos para um subfluxo para criar registros de lista relacionada.
12. Adicione usuários ou grupos que podem usar esta ação de Lente.
    1. Na lista relacionada Usuários e grupos atribuídos, selecione Novo .
    2. Selecione os usuários necessários ou o grupo de usuários que têm a função lens_user.
       Somente os usuários atribuídos ou o grupo de usuários podem aproveitar a ação de lente durante a execução da lente.
    3. Selecione Enviar.
13. Selecione Atualizar.
14. Selecione Ativar Para ativar a ação de Lente.

Exemplo: Preencher registros de usuário automaticamente em uma tabela de usuário

Permita que os agentes de serviço criem registros de usuário extraindo informações específicas de documentos de identidade usando Lente da ServiceNow, diretamente do ServiceNow instância.

Antes de Iniciar

Função necessária: Lens_admin

Por Que e Quando Desempenhar Esta Tarefa

Um agente de serviço deve integrar vários usuários verificando seus cartões de identificação oficiais (por exemplo, ID emitido pelo governo). Em vez de inserir manualmente os detalhes de cada usuário, os agentes podem acionar Lente da ServiceNow Da instância para automatizar a extração de dados e preencher automaticamente campos específicos definidos no registro de ação de lente.

Você pode definir na ação de Lente que Lente da ServiceNow deve ser acionado a partir da instância para criar registros de usuário e fornecer direções padrão.

Procedimento

1. Navegar até Tudo > Lente da ServiceNow > Ações da Lente.
2. Em Nome campo, insira Preencher automaticamente os registros do usuário .
3. Em Descrição campo, insira Ação de lente para criar automaticamente os registros do usuário na instância da ServiceNow .
4. Em Gatilho de Opção, selecione Instância.
5. No cabeçalho do formulário, selecione Salvar .
6. Em Gatilho para Opção, selecione Formulário.
7. Em Tabela , selecione a tabela Usuário [sys_user].
8. Em Contexto da solicitação Selecione Campos compatíveis para fornecer contexto aprimorado.
9. Em Campos Mover campos para a lista Selecionado.
   UserId, first_name, last_name, title e date_of_birth
10. Em Direções adicionais padrão campo, insira O ID do usuário deve estar sempre em minúsculas e usar o formato firstname.lastname. Insira a Data de nascimento no formato dd-mm-aaaa.
11. Adicione usuários ou grupos que podem usar esta ação de Lente.
    1. Na lista relacionada Usuários e grupos atribuídos, selecione Novo .
    2. Selecione os usuários necessários ou o grupo de usuários que têm a função lens_user.
       Somente os usuários atribuídos ou o grupo de usuários podem aproveitar a ação de lente durante a execução da lente.
    3. Selecione Enviar.
12. Selecione Atualizar.
13. Selecione Ativar Para ativar a ação de Lente.