通智搜尋使用說明：四個步驟為業務系統接入搜尋能力

摘要：本說明介紹如何使用通智搜尋為業務系統接入搜尋能力：包括建立應用、配置索引、建置索引，以及透過 API 或頁面元件完成接入。

一、通智搜尋概述

通智搜尋是通智雲提供的一站式智能搜尋產品，協助企業快速為業務系統接入高品質的搜尋能力。主要流程如下：

二、進入通智搜尋

1. 登入通智雲控制台，在左側導覽列中找到「通智搜尋」，點擊進入。

   
   圖2-1 左側導覽列中的「通智搜尋」入口

2. 進入通智搜尋概覽頁。在概覽頁可以看到「新建應用」的入口，點擊進入建立應用流程。

   
   圖2-2 通智搜尋概覽頁

三、建立應用

第一步：選擇行業和套餐

1. 選擇當前業務所屬行業。系統會針對所選行業進行行業級優化，若清單中沒有對應行業，可選擇「通用行業」。

2. 選擇套餐版本。不同套餐對應不同的資源配額和功能，可根據業務量體選擇合適的套餐。

3. 點擊「建立」按鈕，完成應用建立。

   
   圖3-1 選擇行業和套餐

第二步：開啟應用詳情頁

1. 建立完成後，點擊「返回應用清單」，回到應用清單頁。

   
   圖3-2 返回應用清單

2. 在應用清單頁可以看到剛建立的應用。清單預設按建立時間倒序排列，新建立的應用由系統自動命名。

   
   圖3-3 應用清單頁

3. 點擊應用名稱，進入應用詳情頁。

第三步：了解詳情頁「基礎資訊」

應用詳情頁主要包含「基礎資訊」「索引配置」「效果預覽」等功能區。其中，「基礎資訊」的主要功能如下：

圖3-4 應用詳情頁之「基礎資訊」

⚠️ 注意：API Key 是呼叫應用介面的憑證，請妥善保管，不要洩漏。

四、索引配置

索引是搜尋的基礎。透過索引配置，將資料集的欄位對應為索引欄位，系統據此建置搜尋索引。

第一步：進入索引配置頁面

在應用詳情頁點擊「索引配置」，進入索引配置頁面。

• 如果還沒有建立過資料集，可以點擊「建立新資料集」，進入建立資料集流程。

• 如果已經建立過資料集，可以點擊「關聯已有資料集」，選擇已有的資料集作為索引的資料來源。

  
  圖4-1 索引配置入口

第二步：選擇資料集

選擇作為索引資料來源的資料集。

圖4-2 選擇資料集

第三步：配置索引欄位

系統為常見的業務場景提供索引模板，可以在模板基礎上進一步調整。各配置項說明如下：

1. 語義標籤：為欄位設定語義標籤，協助系統更充分地理解業務資料。

2. 索引欄位：索引模板已預設索引欄位名稱，只需對應相應的資料集欄位即可。索引必須有且只有一個 ID 欄位，用於唯一識別一筆資料；同時至少需要一個「欄位類型」為「分詞處理」的欄位，以確保搜尋功能正常運作。

3. 資料集欄位：選擇索引欄位對應的資料集欄位名稱，系統將使用該欄位的內容來建置索引。

4. 欄位類型：為索引欄位選擇合適的處理類型，決定資料將如何被處理到索引中。

5. 欄位權重：為「分詞處理」類型的欄位設定權重，搜尋時系統會按權重進行加權排序。

6. 新增索引欄位：在模板欄位清單的基礎上，如需增加業務欄位，可點擊「新增索引欄位」繼續新增。

7. 點擊「儲存」，儲存索引配置。

   
   圖4-3 索引欄位配置

💡 提示：在索引配置欄位清單的表頭，將滑鼠移至欄位名稱旁的「?」圖示上方，可查看該列的詳細說明。

第四步：啟動建置索引

索引儲存成功後，在彈出的對話方塊中點擊「啟動」，即可開始建置索引。也可以點擊「暫不啟動」，繼續修改索引配置後再啟動。

圖4-4 啟動建置索引

第五步：查看建置進度

1. 回到應用詳情頁，在「執行狀態」區域可以查看應用狀態，也可以停止建置索引。

2. 在「文件數」區域可以查看已建置到索引中的文件數量。

3. 點擊重新整理按鈕，可動態查看索引中的文件數變化。

   
   圖4-5 查看建置索引進度

五、接入應用

索引建置完成後，即可將搜尋能力接入業務系統。通智搜尋提供多種接入方式，可根據業務需求選擇。

效果預覽

點擊「效果預覽」，在右側彈出的頁面中可以預覽搜尋頁面元件的展示效果，方便在接入前確認搜尋體驗。

圖5-1 效果預覽

API 接入

點擊「API 接入」，在右側彈出的頁面中可以查看 API 接入的詳細說明，包括請求位址、參數說明和回傳範例。

圖5-2 API 接入指引

頁面元件接入

點擊「頁面元件接入」，在右側彈出的頁面中可以查看搜尋頁面元件的接入說明，透過嵌入元件程式碼即可快速為頁面加入搜尋功能。

圖5-3 頁面元件接入指引

介面除錯

點擊「介面除錯」，在右側彈出的頁面中可以查看介面的詳細除錯資訊，用於驗證搜尋配置是否正確生效。

圖5-4 介面除錯

附錄：名詞說明