Index Workspace Data with Mongo Connector

With Rocket.Chat AI and the Mongo Connector deployed, the next step is to connect your Rocket.Chat workspace. In this guide, you'll authenticate to the Mongo Connector, add your Rocket.Chat workspace, and configure which rooms should be indexed into Rocket.Chat AI pipeline.

Before you begin, familiarize yourself with these key terms:

• Backfill: A one-time synchronization of a room's existing message history into Rocket.Chat AI pipeline. It runs the first time a room is queued for indexing.

• Live sync: Continuously synchronizes new messages after the initial backfill completes, keeping the index up to date.

Step 1: Authenticate the connector UI

1. Open your browser and navigate to your Mongo Connector URL.

2. Locate the Session Access section.

3. Paste the Connector API Key you copied during deployment into the Existing API Key field.

Now the connector is authenticated, you can procced to connect your workspace.

Step 2: Add and configure a workspace

To begin synchronizing data, add your Rocket.Chat workspace to the Mongo Connector.

1. Under Add Workspace, configure the following settings:

   Field	Description
   Workspace Name	Enter a recognizable name for your workspace.
   Slug	Enter a unique, URL-friendly identifier (e.g., company-main
   Mongo
   Mongo URI	Enter the connection string for your Rocket.Chat MongoDB instance. The database must be reachable from the Mongo Connector deployment.
   Database	Enter the name of the MongoDB database that stores your Rocket.Chat collections.
   Rocket.Chat AI Pipeline
   Pipeline Base URL	Enter the Rocket.Chat AI pipeline API URL.
   API Key	Enter the Master API Key generated during the Rocket.Chat AI pipeline deployment.
   API Secret	Enter the Master Secret generated during the Rocket.Chat AI pipeline deployment.

2. Click Create New Pipeline. The form expands to display additional pipeline configuration fields.

   1. Enter a Pipeline name.

   2. Click Create Pipeline.

      The newly created pipeline is automatically selected, and the default text splitter is configured.

3. Click Save workspace.

Step 3: Index rooms

After saving the workspace, the next step is to choose which rooms should be synchronized with Rocket.Chat AI pipeline.

1. Navigate to the Room Catalog section. It displays all the rooms in your workspace.

2. Select the rooms you want to index.

3. Click Queue Selected Now.

For your initial deployment, start by indexing a single, small room. This lets you verify that your network connectivity, credentials, and permissions are configured correctly before indexing your entire workspace.

When the room's backfill status shows Ccmplete, Rocket.Chat AI pipeline has finished indexing the room.

Next steps

Your Rocket.Chat workspace is now connected to the Rocket.Chat AI pipeline server, and your indexed data is ready for AI-powered applications.

Continue to the Intelligent Search and Rocket.Chat AI app guides to learn how to search conversations semantically, generate summaries, and interact with your indexed workspace data.