ServiceNow AI Search
Quick Start

Raytion Connector Hub for AI Search

Install the Raytion Connector Hub for AI Search

To enable the integration of external third-party content information, the Raytion Connector Hub for AI Search needs to be installed on your Now platform. Download the app from app store and it allows you to start with the integration of your third-party content immediately after the installation. It will create Source System specific content schema in AI Search and will define the corresponding Indexed Source.

To install the Connector Hub App, follow the instructions below:

  • Navigate to menu My Company Application

My Company Application

  • The button Find in Store will navigate you to the Store App

  • Search for Raytion Connector Hub

My Company Application

  • Request App or Trial

Details about the installation can be retrieved from our Store App Installation Guide.

Install the User Mapping Table

Application Scope: Raytion Connector Hub for AI Search
Elevated Role: -

The user mapping table installed by the Connector Hub requires execution of a fix script once after the initial installation of the app to link it to the corresponding indexed source. To run the script navigate to the fix script overview and search for the script starting with Raytion and ending with m2m Record.

Fix Script

Make sure to have the application scope Raytion Connector Hub for AI Search activated before executing the script.

Fix Script Execution

Create Technical User Account

The connector requires an user account with at least the role ais_external_content to ingest items into AI Search. It is recommended to setup a dedicated technical user account with web service access only.

Technical User Account

Service Portal Search

In order to make the ingested items searchable in your Service Portal Search, a new Search Source needs to be created and linked to the Default Search Profile.

Create and Link Search Source

Application Scope: Raytion Connector Hub for AI Search
Elevated Role: -

  • Navigate to the Search Profile Overview under AI Search Menu.

Search Profiles Overview

  • Open the search profile to create a new search source in, for example the Service Portal Default Search Profile.

Default Search Profile

  • Now link the indexed source created by the Connector Hub. The indexed source is named according to the source system you want to make searchable.

Link Search Source

  • Publish the Default Profile to apply the changes.

Define Facets (Optional)

Once, the Search Source is created in the Default Search Profile, you can create facets in the Default Search Application.

Default Search Application
Facet Defintion

The list of fields defined in the schema can be retrieved from Store App Installation Guide.

Link Search Result Configuration (Optional)

The Connector Hub installs a Search Result Configuration Bundle which can be added to the Default Search Result Configuration to enrich the view in the search result.

  • Open the Search Result Configuration Record of the Service Portal

Service Portal

  • Link the installed EVAM View Config Bundle M2M

Service Portal
Service Portal

Modify AI Search Constraints (Optional)

Rate Limiting

The Rate Limiting restricts the number of requests sent to AI Search to 3600 requests per hour by default. In order to allow more requests to be sent by the connector, navigate to System Webservices → REST → Rate Limit Rules.

Modify the rate limit rules for AIS EC Ingest Document and AIS EC Store Content for content synchronization and AIS EC User Mapping for principal synchronization.

AI Search Rate Limiting
Ingest Document Rate Limiting

Apply the changes also in the connector configuration under Advanced Configuration → ServiceNow AI Search → ServiceNow AI Search Connection Settings → Requests per second.

Extend Content Schema (Optional)

Only metadata defined in the external content schema is accepted and processed by AI Search. As the connector provides further metadata in addition to the properties defined in the schema, you can add a new custom property to the schema in order to index and integrate it into your Search Application.

  • Login as user with the role ais_admin.

  • Navigate to the Tables Menu.

  • Select the respective external content table (can be retrieved from the connector configuration under Basic Configuration → ServiceNow AI Search Settings → Schema).

External Content Table

  • Make sure you have the App Scope Raytion Connector Hub for AI Search selected.

  • Add a new column based on the list of additional metadata provided by the connector.

Add new column
If you use the Raytion Search Result Configuration provided by the Raytion Connector Hub App, do not delete any of the existing property defined in the schema.