---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GeniusResultAnswer -- Umfang

# GeniusResultAnswer -- Umfang {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 7 Minuten Lesedauer

Die GeniusResultAnswer Die API bietet Methoden zum Erstellen eines Antwortobjekts in den Prozessorskripts einer Genius-Ergebniskonfiguration. Mit dieser API erstellte Antworten definieren Suchanforderungen oder Schlüssel-Wert-Paarzuordnungen, die Genius-Ergebnisantwortkarten ausfüllen können.

Sie können das Antwortobjekt mit Abfragedetails ausfüllen, die aus dem Kontext der Genius-Ergebniskonfiguration abgerufen wurden, indem Sie verwenden [GeniusResultContext](https://servicenow-prod.fluidtopics.net/pGWd1ATF_JrXIz7lgo9Phw#GeniusResultContextScopedAPI "Die GeniusResultContext Die API bietet Methoden zum Abrufen von Suchabfragegenformationen aus dem Kontext einer Genius-Ergebniskonfiguration.")API.  
Die GeniusResultAnswer API-Methoden, die Sie zum Erstellen Ihres Antwortobjekts aufrufen müssen, hängen davon ab KI-SucheFormularfeld „Genius-Ergebniskonfiguration", das Sie für Ihr Skript verwenden:

* Wenn Sie in einer Genius-Ergebniskonfiguration skripten AI Search request processorFeld, müssen Sie aufrufen Einstellbar () Methode und eine der SetSearchPhrase() , AddSearchPhrasen() , Oder SetEncodedQuery() Methoden. Alle anderen Methoden mit Ausnahme von sind optional AddDataMap() , Was für diesen Anwendungsfall nicht relevant ist.
* Wenn Sie in einer Genius-Ergebniskonfiguration skripten AI Search response processorFeld, müssen Sie aufrufen AddDataMap() Methode. Für diesen Anwendungsfall sind keine anderen Methoden relevant.

{#GeniusResultAnswerScopedAPI__ul_zbx_52j_snb}Verwenden Sie diese API in serverseitigen Genius-Ergebnis-Skripts mit `sn_ais `Namespace-Bezeichner. Weitere Informationen zur Skripting-Logik für Genius-Ergebnisse finden Sie unter [Erstellen Sie eine neue Genius-Ergebniskonfiguration](https://www.servicenow.com/docs/access?context=create-genius-results-config-ais&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US).

## GeniusResultAnswer -- addDataMap (Objektzuordnung) {#ariaid-title2}

Definiert eine Genius-Ergebnisantwort mit beliebigen Schlüssel-Wert-Paarfeldern in Ihren Genius-Ergebniskonfigurationen AI Search response processorSkript. Sie können alle öffentlichen verwenden Now PlatformAPI zum Generieren dieser Felder.
Hinweis:  
Beim Skripting in einer Genius-Ergebniskonfiguration AI Search response processorFeld, müssen Sie diese Methode aufrufen. Wenn Sie diese Methode nicht aufrufen, gibt das Genius-Ergebnis bei Auslösung keine Antworten zurück.

Sie können mehrere Feldzuordnungen zu einer einzelnen hinzufügen AI Search response processorSkript, indem diese Methode mehrmals aufgerufen wird. Jede Feldzuordnung füllt eine separate Genius-Ergebnisantwortkarte aus.
{#GRAnswer-addDataMap_O__table_bp3_3xm_qnb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Zuordnen | Objekt | Definiert einen beliebigen Satz von Schlüssel-Wert-Paarfeldern zum Hinzufügen zur Suchabfrageantwort von KI-Suche. Alle Feldwerte müssen Zeichenfolgen sein. { "fieldName1": String, "fieldName2": String } |
[Tabelle : 1. Parameter]

{#GRAnswer-addDataMap_O__table_bp3_3xm_qnb} {#GRAnswer-addDataMap_O__GRAnswer-returns-Boolean-tgroup__entry__2}{#GRAnswer-addDataMap_O__GRAnswer-returns-Boolean-row}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob der Aufruf der Methode erfolgreich war. Gültige Werte: * Wahr: Aufruf der Methode erfolgreich. * Falsch: Fehler beim Aufrufen der Methode. {#GRAnswer-addDataMap_O__ul_unq_dzn_vnb} |
[Tabelle : 2. Rückgaben]

{#GRAnswer-addDataMap_O__id_qyq_cg4_vnb}  
Dies AI Search response processorSkript fügt anwenderdefinierte Titel- und URL-Schlüssel-Wert-Paarfelder zum Antwortobjekt hinzu, um sie auf einer Genius-Ergebnisantwortkarte anzuzeigen.

    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) {#ariaid-title3}

Fügt der Suchabfrage, die in Ihren Genius-Ergebniskonfigurationen definiert ist, Begriffe hinzu AI Search request processorSkript.
Hinweis:  
Beim Skripting in einer Genius-Ergebniskonfiguration AI Search request processorFeld, müssen Sie aufrufen Einstellbar () Methode und eine der SetSearchPhrase() , AddSearchPhrasen() , Oder SetEncodedQuery() Methoden. Wenn Sie nicht beide erforderlichen Methoden aufrufen, gibt Ihr Genius-Ergebnis bei Auslösung keine Antworten zurück.
{#GRAnswer-addSearchPhrases_A__table_tn5_jxm_qnb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| SearchPhrasen | Array | Array von beliebigen Zeichenfolgen, die als Suchbegriffe für die in Ihren Genius-Ergebniskonfigurationen definierte Suchabfrage hinzugefügt werden sollen AI Search request processorSkript. KI-SucheBehandelt diese Suchbegriffe so, als wären sie durch den Operator ODER getrennt. Beispiel: [ "Term": String, "Quoted phrase": String ] |
[Tabelle : 3. Parameter]

{#GRAnswer-addSearchPhrases_A__table_tn5_jxm_qnb} {#GRAnswer-addSearchPhrases_A__GRAnswer-returns-Boolean-tgroup__entry__2}{#GRAnswer-addSearchPhrases_A__GRAnswer-returns-Boolean-row}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob der Aufruf der Methode erfolgreich war. Gültige Werte: * Wahr: Aufruf der Methode erfolgreich. * Falsch: Fehler beim Aufrufen der Methode. {#GRAnswer-addSearchPhrases_A__ul_unq_dzn_vnb} |
[Tabelle : 4. Rückgaben]

{#GRAnswer-addSearchPhrases_A__id_qyq_cg4_vnb}  
Dies AI Search request processorSkript erstellt eine Suchabfrage für Datensätze in der Anwendertabelle \[sys_user\], die die Begriffe enthalten <kbd class="ph userinput">Beth </kbd>Oder <kbd class="ph userinput">Anglin </kbd>.

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

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

      return answer;
    }

## GeniusResultAnswer -- setEncodedQuery (Zeichenfolgenabfrage) {#ariaid-title4}

Gibt eine codierte Suchabfrage in Ihren Genius-Ergebniskonfigurationen an AI Search request processorSkript. Ergebnisse aus dieser codierten Suchabfrage werden als Genius-Ergebnisantwortkarten angezeigt.
Hinweis:  
Beim Skripting in einer Genius-Ergebniskonfiguration AI Search request processorFeld, müssen Sie aufrufen Einstellbar () Methode und eine der SetSearchPhrase() , AddSearchPhrasen() , Oder SetEncodedQuery() Methoden. Wenn Sie nicht beide erforderlichen Methoden aufrufen, gibt Ihr Genius-Ergebnis bei Auslösung keine Antworten zurück.
{#GRAnswer-setEncodedQuery_S__table_awn_kxm_qnb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| query | Zeichenfolge | Codierte Suchabfrage, an die gesendet werden soll KI-SucheAus Ihren Genius-Ergebniskonfigurationen AI Search request processorSkript. |
[Tabelle : 5. Parameter]

{#GRAnswer-setEncodedQuery_S__table_awn_kxm_qnb} {#GRAnswer-setEncodedQuery_S__GRAnswer-returns-Boolean-tgroup__entry__2}{#GRAnswer-setEncodedQuery_S__GRAnswer-returns-Boolean-row}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob der Aufruf der Methode erfolgreich war. Gültige Werte: * Wahr: Aufruf der Methode erfolgreich. * Falsch: Fehler beim Aufrufen der Methode. {#GRAnswer-setEncodedQuery_S__ul_unq_dzn_vnb} |
[Tabelle : 6. Rückgaben]

{#GRAnswer-setEncodedQuery_S__id_qyq_cg4_vnb}  
Dies AI Search request processorSkript erstellt eine codierte Suchabfrage für die Anwendertabelle \[sys_user\]. Die endgültige Abfrage verbindet mehrere Unterabfragen, die aus Entitäten generiert wurden, die in der ursprünglichen Suchabfrage des Anwenders erkannt wurden.

    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) {#ariaid-title5}

Begrenzt die maximale Anzahl von Ergebnissen, die für die in Ihrer Genius-Ergebniskonfiguration definierte Suchabfrage zurückgegeben werden AI Search request processorSkript. Standardmäßig gibt die Suchabfrage bis zu drei Ergebnisse zurück.
{#GRAnswer-setSearchLimit_N__table_yq1_lxm_qnb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| SearchLimit | Nummer | Positiver ganzzahliger Wert für die maximale Anzahl von Suchergebnissen, die für die in Ihren Genius-Ergebniskonfigurationen definierte Suchabfrage zurückgegeben werden sollen AI Search request processorSkript. Werte über 3 haben keine Auswirkungen. Standard: 3 |
[Tabelle : 7. Parameter]

{#GRAnswer-setSearchLimit_N__table_yq1_lxm_qnb} {#GRAnswer-setSearchLimit_N__GRAnswer-returns-Boolean-tgroup__entry__2}{#GRAnswer-setSearchLimit_N__GRAnswer-returns-Boolean-row}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob der Aufruf der Methode erfolgreich war. Gültige Werte: * Wahr: Aufruf der Methode erfolgreich. * Falsch: Fehler beim Aufrufen der Methode. {#GRAnswer-setSearchLimit_N__ul_unq_dzn_vnb} |
[Tabelle : 8. Rückgaben]

{#GRAnswer-setSearchLimit_N__id_qyq_cg4_vnb}  
Dies AI Search request processorSkript sucht nach Datensätzen aus der Tabelle „Katalogelement" \[sc_Cat_item\], die den Begriff enthalten <kbd class="ph userinput">Laptop </kbd>Und gibt maximal zwei Ergebnisse zurück.

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

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

      return answer;
    }

## GeniusResultAnswer -- setSearchPhrase(Zeichenfolge searchPhrase) {#ariaid-title6}

Gibt Begriffe für die Suchabfrage an, die in Ihren Genius-Ergebniskonfigurationen definiert sind AI Search request processorSkript.
Hinweis:  
Beim Skripting in einer Genius-Ergebniskonfiguration AI Search request processorFeld, müssen Sie aufrufen Einstellbar () Methode und eine der SetSearchPhrase() , AddSearchPhrasen() , Oder SetEncodedQuery() Methoden. Wenn Sie nicht beide erforderlichen Methoden aufrufen, gibt Ihr Genius-Ergebnis bei Auslösung keine Antworten zurück.
{#GRAnswer-setSearchPhrase_S__table_icm_lxm_qnb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| SearchPhrase | Zeichenfolge | Begriffe, die für die Suchabfrage verwendet werden sollen, die in Ihren Genius-Ergebniskonfigurationen definiert sind AI Search request processorSkript. Wenn Sie die Suchbegriffe aus der Abfrage beibehalten möchten, die die Genius-Ergebniskonfiguration ausgelöst hat, legen Sie diesen Parameter auf den Zeichenfolgenwert fest, der von zurückgegeben wird GeniusResultContext.getOriginalSearchPhrase() Methode. |
[Tabelle : 9. Parameter]

{#GRAnswer-setSearchPhrase_S__table_icm_lxm_qnb} {#GRAnswer-setSearchPhrase_S__GRAnswer-returns-Boolean-tgroup__entry__2}{#GRAnswer-setSearchPhrase_S__GRAnswer-returns-Boolean-row}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob der Aufruf der Methode erfolgreich war. Gültige Werte: * Wahr: Aufruf der Methode erfolgreich. * Falsch: Fehler beim Aufrufen der Methode. {#GRAnswer-setSearchPhrase_S__ul_unq_dzn_vnb} |
[Tabelle : 10. Rückgaben]

{#GRAnswer-setSearchPhrase_S__id_qyq_cg4_vnb}  
Dies AI Search request processorSkript erstellt eine Suchabfrage für Datensätze aus der Anwendertabelle \[sys_user\], die den Begriff enthalten <kbd class="ph userinput">Anglin </kbd>.

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

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

      return answer;
    }

## GeniusResultAnswer -- Settable (Zeichenfolgentabelle) {#ariaid-title7}

Beschränkt die Suchabfrage, die in einer Genius-Ergebniskonfiguration definiert ist AI Search request processorSkript für eine bestimmte Tabelle. Die Abfrage gibt nur Suchergebnisse aus der angegebenen Tabelle als Genius-Ergebnisantwortkarten zurück.
Hinweis:  
Beim Skripting in einer Genius-Ergebniskonfiguration AI Search request processorFeld, müssen Sie diese Methode und eine der aufrufen SetSearchPhrase() , AddSearchPhrasen() , Oder SetEncodedQuery() Methoden. Wenn Sie nicht beide erforderlichen Methoden aufrufen, gibt Ihr Genius-Ergebnis bei Auslösung keine Antworten zurück.
{#GRAnswer-setTable_S__table_jgx_lxm_qnb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| table | Zeichenfolge | Now Platform Tabellenname. Nur indizierte Datensätze in dieser Tabelle werden als Ergebnisse für die Suchabfrage zurückgegeben, die in Ihren Genius-Ergebniskonfigurationen definiert ist AI Search request processorSkript. |
[Tabelle : 11. Parameter]

{#GRAnswer-setTable_S__table_jgx_lxm_qnb} {#GRAnswer-setTable_S__GRAnswer-returns-Boolean-tgroup__entry__2}{#GRAnswer-setTable_S__GRAnswer-returns-Boolean-row}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob der Aufruf der Methode erfolgreich war. Gültige Werte: * Wahr: Aufruf der Methode erfolgreich. * Falsch: Fehler beim Aufrufen der Methode. {#GRAnswer-setTable_S__ul_unq_dzn_vnb} |
[Tabelle : 12. Rückgaben]

{#GRAnswer-setTable_S__id_qyq_cg4_vnb}  
Dies AI Search request processorSkript erstellt eine Suchabfrage für Datensätze aus der Anwendertabelle \[sys_user\], die den Begriff enthalten <kbd class="ph userinput">Anglin </kbd>.

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

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

      return answer;
    }

## GeniusResultAnswer -- Rechtschreibprüfung (boolesche Rechtschreibprüfung) {#ariaid-title8}

Gibt an, ob die automatische Tippfehlerbehandlung (Rechtschreibprüfung) für die in einer Genius-Ergebniskonfiguration definierte Suchabfrage durchgeführt werden soll AI Search request processorSkript.
Wenn Sie diese Methode nicht in Ihren Genius-Ergebniskonfigurationen aufrufen AI Search request processorSkript: Die definierte Suchabfrage erbt die Kennzeichnung für die Tippfehlerbehandlung von der Suchabfrage, die die Genius-Ergebniskonfiguration auslöst.
{#GRAnswer-spellCheck_B__table_j1x_x14_vnb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Rechtschreibprüfung | Boolean | Kennzeichnung, die angibt, ob die automatische Korrektur der Tippfehlerbehandlung für die in Ihren Genius-Ergebniskonfigurationen definierte Suchabfrage durchgeführt werden soll AI Search request processorSkript. Gültige Werte: * Wahr: Automatische Tippfehlerbehandlung für die Suchabfrage durchführen. * Falsch: Umgehen Sie die automatische Tippfehlerbehandlung für die Suchabfrage. {#GRAnswer-spellCheck_B__ul_ugr_xps_qnb} Standard: Wahr |
[Tabelle : 13. Parameter]

{#GRAnswer-spellCheck_B__table_j1x_x14_vnb} {#GRAnswer-spellCheck_B__table_zxh_mxm_qnb__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 14. Rückgaben]

{#GRAnswer-spellCheck_B__table_zxh_mxm_qnb}  
Dies AI Search request processorDas Skript deaktiviert die automatische Tippfehlerbehandlung für seine Suchabfrage für die Anwendertabelle \[sys_user\].

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


