Skip to main content
Gainsight Inc.

Configure Knowledge Center (KC) Bot in Adoption Explorer

The article will be available on January 31,2026 when the new feature is available in your production org

This article helps admins enable Knowledge Center (KC) Bot data ingestion into Gainsight CS.

Overview

The Knowledge Center Bot (KC Bot) in Gainsight PX serves as a comprehensive onboarding assistant designed to facilitate learning within your product and enhance user experience. It is a vital component in driving user engagement by providing a user-friendly, accessible, and dynamic platform for learning, exploration, and interaction within your product.

Example Business Use Case: Consider a scenario where a user encounters a challenge while using your product. The KC Bot can be used as a versatile resource hub to provide instant access to users seeking resources and support. Whether they need step-by-step guidance, information about recent updates, access to the knowledge base, or a quick way to share feedback, the KC Bot provides a unified platform to cater to these diverse needs.

Using the Gainsight PX integration with Gainsight CS, admins can leverage the Knowledge Center Bot data exports directly within Adoption Explorer to drive deeper product insights.

For more information on the Knowledge Center Bot, refer to the Create and Manage KC Bots (Beta) article.

Enable KC Bot Data in Adoption Explorer

With Adoption Explorer, you can connect Gainsight PX with Gainsight CS and fetch feature usage and engagement data to power reports and dashboards.

Bringing KC Bot data into Adoption Explorer includes the following steps:

  1. Establish a connection between Gainsight PX and Gainsight CS
  2. Configure an Adoption Explorer project
  3. Ingest Custom Files from PX

Establish a Connection Between Gainsight PX and Gainsight CS

Before you bring KC Bot data into an Adoption Explorer project, you must establish a connection between Gainsight PX and Gainsight CS, using the PX Connector. For more information on how to establish a connection, refer to the Product Experience (PX) Integration article.

Configure an Adoption Explorer Project

Once the connection is established, you can configure an Adoption Explorer project to ingest the KC Bot data.

To configure KC Bot:

  1. Navigate to Administration > Adoption Explorer.
  2. Click Create Project. The Select Type of Project Setup dialog appears.
  3. Select Gainsight PX and click Continue. The Project Setup page appears.

    Adoption Explorer modal showing project setup options for Gainsight PX and Standard, with Continue button highlighted
     
  4. In the Project Setup page, enter the following details:
    1. From the Gainsight PX Connection drop-down, select the appropriate PX connection pertaining to the KC Bot.
    2. In the Associate usage data identifier to the Gainsight record ID section, map the source fields to Gainsight CS objects.
    3. Click Create Project. A new project in Adoption Explorer is created, and you are redirected to the Object Configuration page.

      Project setup screen showing Gainsight PX connection selection and usage data configuration options.

Ingest Custom Data Files from PX

In the Object Configuration page, you can configure the data sources to start ingesting data into the Gainsight objects. For KC Bot, when the PX Connection is established, the following files become available:

  • One Metadata File:
    • File Prefix: GainsightPX_Knowledge_Center_
    • Mapped To: The Person Information Object
    • Purpose: Provides contextual details such as bot configuration and bot IDs.
  • Four Time Series Files:
    • File Prefixes:
      • GainsightPX_Knowledge_Center_Content_Analytics_
      • GainsightPX_Knowledge_Center_Interaction_
      • GainsightPX_Knowledge_Center_Search_Analytics_
      • GainsightPX_Knowledge_Center_Task_List_Analytics_
    • Mapped To: The Person Daily Time Series Object
    • Purpose: Includes User and Account identifiers to analyze daily engagement patterns.

To ingest custom data files, admins need to perform the following actions:

  • Create Data Source: Select an appropriate connection type, and select the custom files from which the data is to be ingested.
  • Identifiers: Map Identifiers from source to objects in Adoption Explorer.
  • Select Fields: Select the fields from the source to be ingested in Adoption Explorer.

Create Data Source

You must first map the above files to the respective objects for data ingestion. To map fields:

  1. In the Object Configuration page, select the Person Information object.
  2. Click Add Source. The Establish Configuration page appears.

    Adoption Explorer object configuration showing Person Information selected with option to add a data source
     
  3. In Enter Source Name, enter the source name for identification.
  4. From the Connection Type drop-down list, select the Amazon S3 connection type.
  5. Select Managed by Gainsight PX.
  6. From the PX Custom Files drop-down list, select the file with the prefix GainsightPX_Knowledge_Center_


    Establish Connection step showing Amazon S3 selected and data managed by Gainsight PX.
     
  7. Scroll down and select the frequency to import data as Daily or Weekly.
  8. Click Import Metadata. The Select Identifiers page appears.

    Import metadata screen with weekly frequency selected and Import Metadata button visible.

Configure Identifiers

In the Identifiers page, you need to map identifiers in the Adoption Explorer objects with identifiers in the source.

  1. From the Person ID dropdown, select the unique user identifier.
  2. From the External ID dropdown, select the external ID. This helps Adoption Explorer to identify the field used as Customer Identifier in the current source.
  3. (Optional) From the Person Name dropdown, select the identifier name.

    Select Identifiers step showing person ID, external ID, and person name fields for data mapping.
     
  4. Click Next. The Select Fields page appears.

Select Fields

In the Fields page, select the relevant fields from KC Bot to be ingested into Adoption Explorer and click Next. The Complete Field Settings page appears.

Select Fields step showing Gainsight PX Knowledge Center fields with identifiers highlighted during data source setup.

Click Save to complete the configuration of the source data.

For the four Time Series files, repeat the process from the Create Data Source section, using the Person Daily Time Series object in the Object Configuration page.