GeniusResultAnswer - Scoped

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

    • The GeniusResultAnswer API provides methods for creating an answer object in a Genius Result configuration's processor scripts. Answers created with this API define search requests or key-value pair maps that can populate Genius Result answer cards.

    You can populate the answer object with query details retrieved from the context of the Genius Result configuration using the GeniusResultContext API.

    The GeniusResultAnswer API methods you need to invoke to create your answer object depend on which AI Search Genius Result Configuration form field you're using for your script:
    • If you're scripting in a Genius Result configuration's AI Search request processor field, you need to invoke the setTable() method and one of the setSearchPhrase(), addSearchPhrases(), or setEncodedQuery() methods. All other methods are optional except for addDataMap(), which is not relevant for this use case.
    • If you're scripting in a Genius Result configuration's AI Search response processor field, you need to invoke the addDataMap() method. No other methods are relevant for this use case.
    Use this API in Genius Result server-side scripts with the sn_ais namespace identifier. For more information on scripting logic for Genius Results, see Create a new Genius Result configuration.

    GeniusResultAnswer – addDataMap(Object map)

    Defines a Genius Result answer with arbitrary key-value pair fields in your Genius Result configuration's AI Search response processor script. You can utilize any public ServiceNow AI Platform API to generate these fields.

    注:
    When scripting in a Genius Result configuration's AI Search response processor field, you need to invoke this method. If you don't invoke this method, the Genius Result returns no answers when triggered.

    You can add multiple field maps to a single AI Search response processor script by invoking this method more than once. Each field map populates a separate Genius Result answer card.

    表 : 1. Parameters
    Name Type Description
    map Object

    Defines an arbitrary set of key-value pair fields for addition to the search query response from AI Search. All field values must be Strings.

    {
  "fieldName1": String,
  "fieldName2": String
}
    表 : 2. Returns
    Type Description
    Boolean

    Flag that indicates whether invocation of the method succeeded.

    Valid values:
    • true: Invocation of the method succeeded.
    • false: Invocation of the method failed.

    This AI Search response processor script adds custom title and URL key-value pair fields to the answer object for display on a Genius Result answer card.

    function process(context) {
  var answer = new sn_ais.GeniusResultAnswer();

  var customFieldMap = {
    "title": "My custom Genius Result answer",
    "url": "https://example.com/myGeniusResultLink"
  }

  answer.addDataMap(customFieldMap);

  return answer;
}

    GeniusResultAnswer – addSearchPhrases(Array searchPhrases)

    Adds terms to the search query defined in your Genius Result configuration's AI Search request processor script.

    注:
    When scripting in a Genius Result configuration's AI Search request processor field, you must invoke the setTable() method and one of the setSearchPhrase(), addSearchPhrases(), or setEncodedQuery() methods. If you don't invoke both of the required methods, your Genius Result returns no answers when triggered.
    表 : 3. Parameters
    Name Type Description
    searchPhrases Array

    Array of arbitrary Strings to add as search terms for the search query defined in your Genius Result configuration's AI Search request processor script. AI Search treats these search terms as if separated by the OR operator.

    Example:
    [
  "Term": String,
  "Quoted phrase": String
]
    表 : 4. Returns
    Type Description
    Boolean

    Flag that indicates whether invocation of the method succeeded.

    Valid values:
    • true: Invocation of the method succeeded.
    • false: Invocation of the method failed.

    This AI Search request processor script constructs a search query for records on the User [sys_user] table that contain the terms Beth or Anglin.

    function process(context) {
  var answer = new sn_ais.GeniusResultAnswer();

  answer.setTable('sys_user');
  answer.addSearchPhrases(['Beth','Anglin']);

  return answer;
}

    GeniusResultAnswer – setEncodedQuery(String query)

    Specifies an encoded search query in your Genius Result configuration's AI Search request processor script. Results from this encoded search query are displayed as Genius Result answer cards.

    注:
    When scripting in a Genius Result configuration's AI Search request processor field, you need to invoke the setTable() method and one of the setSearchPhrase(), addSearchPhrases(), or setEncodedQuery() methods. If you don't invoke both of the required methods, your Genius Result returns no answers when triggered.
    表 : 5. Parameters
    Name Type Description
    query String Encoded search query to send to AI Search from your Genius Result configuration's AI Search request processor script.
    表 : 6. Returns
    Type Description
    Boolean

    Flag that indicates whether invocation of the method succeeded.

    Valid values:
    • true: Invocation of the method succeeded.
    • false: Invocation of the method failed.

    This AI Search request processor script constructs an encoded search query against the User [sys_user] table. The final query joins together multiple subqueries generated from entities detected in the user's original search query.

    function process(context) {
  var answer = new sn_ais.GeniusResultAnswer();

  answer.setTable('sys_user');
  answer.setSearchLimit(2);
  answer.spellCheck(false);
  var queries = [];
  var matchingSegments;
  var predictionResult = context.getPredictionResult();
  if (predictionResult && predictionResult.length == 1) {
    var detail = predictionResult[0];
    if (detail['result'] && detail['result']['entities']) {
      var entities = detail['result']['entities'];
      for (var i = 0; i < entities.length; i++) {
        if (entities[i]['name'].endsWith('personName')) {
          matchingSegments = entities[i]['matchingSegments'];
          for (var j = 0; j < matchingSegments.length; j++)
            answer.addSearchPhrases([matchingSegments[j]['value']]);
        } else if (entities[i]['name'].endsWith('cityLocation')) {
          matchingSegments = entities[i]['matchingSegments'];
          if (matchingSegments && matchingSegments.length > 0)
            queries.push('location.nameLIKE' + matchingSegments[0]['value']);
        } else if (entities[i]['name'].endsWith('departmentName')) {
          matchingSegments = entities[i]['matchingSegments'];
          if (matchingSegments && matchingSegments.length > 0)
            queries.push('department.nameLIKE' + matchingSegments[0]['value']);
        } else if (entities[i]['name'].endsWith('jobTitle')) {
          matchingSegments = entities[i]['matchingSegments'];
          if (matchingSegments && matchingSegments.length > 0)
            queries.push('titleLIKE' + matchingSegments[0]['value']);
        }
      }
    }
  }

  if (queries.length > 0)
    answer.setEncodedQuery(queries.join('^'));

  return answer;
}

    GeniusResultAnswer – setSearchLimit(Number searchLimit)

    Limits the maximum number of results returned for the search query defined in your Genius Result configuration's AI Search request processor script. By default, the search query returns up to three results.

    表 : 7. Parameters
    Name Type Description
    searchLimit Number

    Positive integer value for the maximum number of search results to return for the search query defined in your Genius Result configuration's AI Search request processor script. Values above 3 have no effect.

    Default: 3
    表 : 8. Returns
    Type Description
    Boolean

    Flag that indicates whether invocation of the method succeeded.

    Valid values:
    • true: Invocation of the method succeeded.
    • false: Invocation of the method failed.

    This AI Search request processor script searches for records from the Catalog Item [sc_cat_item] table that contain the term laptop and returns a maximum of two results.

    function process(context) {
  var answer = new sn_ais.GeniusResultAnswer();

  answer.setTable('sc_cat_item');
  answer.setSearchPhrase('laptop');
  answer.setSearchLimit(2);

  return answer;
}

    GeniusResultAnswer – setSearchPhrase(String searchPhrase)

    Specifies terms for the search query defined in your Genius Result configuration's AI Search request processor script.

    注:
    When scripting in a Genius Result configuration's AI Search request processor field, you need to invoke the setTable() method and one of the setSearchPhrase(), addSearchPhrases(), or setEncodedQuery() methods. If you don't invoke both of the required methods, your Genius Result returns no answers when triggered.
    表 : 9. Parameters
    Name Type Description
    searchPhrase String

    Terms to use for the search query defined in your Genius Result configuration's AI Search request processor script.

    If you want to retain the search terms from the query that triggered the Genius Result configuration, set this parameter to the String value returned by the GeniusResultContext.getOriginalSearchPhrase() method.
    表 : 10. Returns
    Type Description
    Boolean

    Flag that indicates whether invocation of the method succeeded.

    Valid values:
    • true: Invocation of the method succeeded.
    • false: Invocation of the method failed.

    This AI Search request processor script constructs a search query for records from the User [sys_user] table that contain the term Anglin.

    function process(context) {
  var answer = new sn_ais.GeniusResultAnswer();

  answer.setTable('sys_user');
  answer.setSearchPhrase('Anglin');

  return answer;
}

    GeniusResultAnswer – setTable(String table)

    Limits the search query defined in a Genius Result configuration's AI Search request processor script to a specific table. The query only returns search results from the specified table as Genius Result answer cards.

    注:
    When scripting in a Genius Result configuration's AI Search request processor field, you need to invoke this method and one of the setSearchPhrase(), addSearchPhrases(), or setEncodedQuery() methods. If you don't invoke both of the required methods, your Genius Result returns no answers when triggered.
    表 : 11. Parameters
    Name Type Description
    table String ServiceNow AI Platform table name. Only indexed records on this table are returned as results for the search query defined in your Genius Result configuration's AI Search request processor script.
    表 : 12. Returns
    Type Description
    Boolean

    Flag that indicates whether invocation of the method succeeded.

    Valid values:
    • true: Invocation of the method succeeded.
    • false: Invocation of the method failed.

    This AI Search request processor script constructs a search query for records from the User [sys_user] table that contain the term Anglin.

    function process(context) {
  var answer = new sn_ais.GeniusResultAnswer();

  answer.setTable('sys_user');
  answer.setSearchPhrase('Anglin');

  return answer;
}

    GeniusResultAnswer – spellCheck(Boolean spellCheck)

    Specifies whether to perform typo handling auto-correction (spell checking) for the search query defined in a Genius Result configuration's AI Search request processor script.

    If you don't invoke this method in your Genius Result configuration's AI Search request processor script, the defined search query inherits the typo handling flag from the search query that triggers the Genius Result configuration.

    表 : 13. Parameters
    Name Type Description
    spellCheck Boolean

    Flag that indicates whether to perform typo handling auto-correction for the search query defined in your Genius Result configuration's AI Search request processor script.

    Valid values:
    • true: Perform typo handling auto-correction for the search query.
    • false: Bypass typo handling auto-correction for the search query.

    Default: true
    表 : 14. Returns
    Type Description
    None

    This AI Search request processor script disables typo handling auto-correction for its search query against the User [sys_user] table.

    function process(context) {
  var answer = new sn_ais.GeniusResultAnswer();

  answer.setTable('sys_user');
  answer.setSearchLimit(2);
  answer.spellCheck(false);
  var queries = [];
  var matchingSegments;
  var predictionResult = context.getPredictionResult();
  if (predictionResult && predictionResult.length == 1) {
    var detail = predictionResult[0];
    if (detail['result'] && detail['result']['entities']) {
      var entities = detail['result']['entities'];
      for (var i = 0; i < entities.length; i++) {
        if (entities[i]['name'].endsWith('personName')) {
          matchingSegments = entities[i]['matchingSegments'];
          for (var j = 0; j < matchingSegments.length; j++)
            answer.addSearchPhrases([matchingSegments[j]['value']]);
        } else if (entities[i]['name'].endsWith('cityLocation')) {
          matchingSegments = entities[i]['matchingSegments'];
          if (matchingSegments && matchingSegments.length > 0)
            queries.push('location.nameLIKE' + matchingSegments[0]['value']);
        } else if (entities[i]['name'].endsWith('departmentName')) {
          matchingSegments = entities[i]['matchingSegments'];
          if (matchingSegments && matchingSegments.length > 0)
            queries.push('department.nameLIKE' + matchingSegments[0]['value']);
        } else if (entities[i]['name'].endsWith('jobTitle')) {
          matchingSegments = entities[i]['matchingSegments'];
          if (matchingSegments && matchingSegments.length > 0)
            queries.push('titleLIKE' + matchingSegments[0]['value']);
        }
      }
    }
  }

  if (queries.length > 0)
    answer.setEncodedQuery(queries.join('^'));

  return answer;
}