Tengence Search User Guide: Add Search to a Business System in Four Steps

Summary: This guide shows how to connect Tengence Search to a business system: create an app, configure the index, build the index, then integrate through the API or a page component.

1. Tengence Search Overview

Tengence Search is Tengence's one-stop intelligent search product. It helps teams add high-quality search to a business system quickly. The main flow is:

2. Open Tengence Search

1. Sign in to the Tengence console, find Tengence Search in the left navigation bar, and click to enter.

   
   Figure 2-1 The Tengence Search entry in the left navigation bar

2. You land on the Tengence Search overview page. It holds the Create app entry; click it to start the creation flow.

   
   Figure 2-2 Tengence Search overview page

3. Create an App

Step 1: Choose an industry and a plan

1. Select the industry your business belongs to. The system applies industry-level optimization for the chosen industry. If your industry is not listed, choose General Industry.

2. Choose a plan tier. Different plans carry different resource quotas and features, so pick one that fits your business volume.

3. Click Create to finish creating the app.

   
   Figure 3-1 Choose an industry and a plan

Step 2: Open the app detail page

1. After creation, click Back to app list to return to the app list.

   
   Figure 3-2 Back to app list

2. The app you just created appears in the list. The list is sorted by creation time in descending order, and new apps are named automatically by the system.

   
   Figure 3-3 App list page

3. Click the app name to open its detail page.

Step 3: Understand "Basic information" on the detail page

The app detail page contains the Basic information, Index configuration, and Preview areas. The main functions under Basic information are:

Figure 3-4 Basic information on the app detail page

⚠️ Note: The API Key is the credential used to call the app's APIs. Keep it safe and never expose it.

4. Index Configuration

The index is the foundation of search. Index configuration maps dataset fields to index fields, and the system builds the search index from that mapping.

Step 1: Open the index configuration page

On the app detail page, click Index configuration to open the configuration page.

• If no dataset exists yet, click Create dataset to start the dataset creation flow.

• If a dataset already exists, click Link existing dataset and choose it as the index data source.

  
  Figure 4-1 Index configuration entry

Step 2: Choose a dataset

Select the dataset that will serve as the index data source.

Figure 4-2 Choose a dataset

Step 3: Configure index fields

The system ships index templates for common business scenarios, and you can adjust them further. Each setting works as follows:

1. Semantic label: assign a semantic label to a field so the system understands your business data better.

2. Index field: the template presets index field names; you only map the matching dataset fields. An index must have exactly one ID field to identify each record, and at least one field whose Field type is Tokenization, otherwise search will not work.

3. Dataset field: choose the dataset field behind each index field. The system builds the index from that field's content.

4. Field type: choose how the field is processed into the index; this determines how the data is handled.

5. Field weight: set a weight for Tokenization fields; at search time the system ranks results by these weights.

6. Add index field: to add business fields beyond the template list, click Add index field.

7. Click Save to store the index configuration.

   
   Figure 4-3 Index field configuration

💡 Tip: In the header of the index field list, hover over the "?" icon next to a field name to read the detailed description of that column.

Step 4: Start building the index

After the index is saved, click Start in the dialog to begin building. You can also click Not now, keep editing the configuration, and start the build later.

Figure 4-4 Start building the index

Step 5: Check build progress

1. Return to the app detail page; the Running status area shows the app status and lets you stop the build.

2. The Document count area shows how many documents have been built into the index.

3. Click the refresh button to watch the document count change in real time.

   
   Figure 4-5 Check index build progress

5. Integrate the App

Once the index is built, you can connect search to your business system. Tengence Search offers several integration paths.

Preview

Click Preview to open a right-side panel showing how the search page component renders, so you can confirm the search experience before integrating.

Figure 5-1 Preview

API integration

Click API integration to open a right-side panel with the API details: request URL, parameters, and sample responses.

Figure 5-2 API integration guide

Page component integration

Click Page component to open a right-side panel with the component integration guide. Embed the component code to add search to a page quickly.

Figure 5-3 Page component integration guide

API debugging

Click API debugging to open a right-side panel with detailed debugging information, used to verify that your search configuration took effect.

Figure 5-4 API debugging

Appendix: Glossary