Adding data sources in BMC HelixGPT

To get started with BMC HelixGPT for the chatbot, knowledge article search, and summarization use cases, as an administrator, you must first define the data sources in the HelixGPT Agent Studio. You must define the required parameters for the new data sources to connect the data source with the database into which data will be ingested.

Data sources for BMC HelixGPT

The following data sources are available out-of-the-box in BMC HelixGPT. You can only edit the connection details for these data sources. You cannot delete these connections.:

• BMC Helix Business Workflows
• BMC Helix Knowledge Management by ComAround
• BMC Helix ITSM: Knowledge Management

The following data sources are not available out-of-the-box.  You must first enable them to create new data connections:

• Confluence
• Microsoft SharePoint Online
• Helix Customer Service Management
• Web
• Salesforce Knowledge
• Elastic
• Splunk
• Jira
• ServiceNow
• xMatters
• PagerDuty

You can add multiple connections for Confluence, Microsoft SharePoint Online, Salesforce Knowledge, and Web data sources.

Before you begin

Make sure you have the BMC HelixGPT Administrator role to add data or edit sources and data connections. Learn more about roles in Roles-and-permissions.

Process for setting up BMC HelixGPT

The following image shows the process of setting up BMC HelixGPT and the current step that you are on:

Complete the following steps to configure data sources in BMC HelixGPT:

• Review the existing out-of-the-box connections
• Enable data sources from record definitions
• Add data sources to BMC HelixGPT
• Create multiple connections for data sources

To review and edit an out-of-the-box data connection

Out-of-the-box data connections are available for BMC Helix Business Workflows, BMC Helix Knowledge Management by ComAround,BMC Helix ITSM: Knowledge Management, and BMC Helix ITSM.You cannot delete these connections and can only edit the details. 

1. In HelixGPT Agent Studio, click Settings .
2. Select HelixGPT > Connections > Information sources.
3. To open a connection, click the connection name.
4. In the Edit Connection pane, modify the following details:
   • Connection name
   • User name
5. Click Save.

To enable data sources

1. As a HelixGPT Agent Studio Admin user, log in to BMC Helix Innovation Studio.
2. On the Workspace tab, click HelixGPT Agent Studio. 
3. On the Records tab, select the check box for the DataSource record definition and click Edit data, as shown in the following image:
   
4. On the Data editor (DataSource) page, select the checkbox of the Microsoft SharePoint Online data source, and click Edit as shown in the following image:
   
5. In the Edit record pane, change the status to Enabled and click Save.
6. Repeat steps 4 and 5 to enable Confluence, Helix Customer Service Management, Salesforce Knowledge, and Web data sources.

(Optional) To register an application in Microsoft Entra ID

Click here to view the steps to register an application in Microsoft Entra ID

1. Log in to the Microsoft Entra admin center.
2. Open  Entra ID > App registrations.
3. Select New registration. 
   The following IDs are created:
   1. Client ID
   2. Tenant ID
4. To create a client secret, click Certificates & secrets.
5. Click New client secret and enter a name.
   A client secret is generated.
6. Click API permissions.
   1. Click Add permissions.
   2. Select Microsoft Graph > Delegated permissions.
   3. Select the following options:
      • openid
      • profile
      • Sites.Read.All
      • User.Read
   4. Select the following application permissions:
      • Files.Read.All
      • Sites.Read.All
      • User.Read.All
7. Click the Grant admin consent for BMC option.

(Optional) To register an application for Microsoft SharePoint Online connection

Click here to register an application for Microsoft SharePoint Online connection

Before you integrate Microsoft SharePoint Online as a data source in BMC HelixGPT, it is necessary to register an application in Azure Active Directory.

This registration enables secure authentication and authorization for data access between BMC HelixGPT and Microsoft SharePoint Online. The application registration process involves the following steps:

1. Register an application.
2. Add permissions.
3. Capture essential details such as the Client ID, Tenant ID, and Client Secret.
   These credentials are required to establish the connection within BMC HelixGPT Agent Studio.

For detailed, step-by-step instructions on registering an application specifically for Microsoft SharePoint Online, see Knowledge Article number 000443376 (Support logon ID required).

To add data sources to BMC HelixGPT

After enabling the data sources, you can add a new data connection in HelixGPT Agent Studio.

1. In HelixGPT Agent Studio, click Settings .
2. Select HelixGPT > Connections > Information sources.
3. To add a new connection, click + Add connection.
4. From the Connection type list, select a connection type.
5. Click Add.

6. In the Add connection pane, specify connection details for the data source you plan to use.

   For more information about connection details, see Data sources for BMC HelixGPT.

7. Click Save.

To edit a data connection

1. In HelixGPT Agent Studio , click Settings .
2. Select HelixGPT > Connections > Information sources.
3. Select the connection name that you want to edit.
4. In the Edit Connection pane, modify the following details:
   • Connection name
   • Confluence- URL, Page ID, Access Token
   • SharePoint- Client ID, Client Secret, Site, Tenant ID, Tenant
   • Helix Customer Service Management- User name
   • Web- URL
   • Salesforce Knowledge- URL, Security Token, User name, Password
5. Click Save.

Results

After the connection is successfully saved, a connection ID is generated. To note the Connection ID for the new data sources that you created, in the data connections table, from the Visible columns list, select ID.

The following image shows the Connection ID in the data sources table:

Use the connection ID while creating the data connection jobs to ingest data into the BMC HelixGPT database. You must create a new job for every Confluence, Microsoft SharePoint Online, Web, or Salesforce Knowledge data connection that you add.

Where to go from here

Ingesting-data-into-BMC-HelixGPT

Related topics

BMC HelixGPT architecture

Setting up and going live