取得個人化的瀏覽結果

瀏覽功能會使用導覽方法，顯示符合使用者所選類別或篩選條件的搜尋結果。瀏覽功能會傳回可個人化的結果。本頁面說明如何取得一般搜尋資料存放區的瀏覽結果。

關於瀏覽功能

在 AI Applications 搜尋應用程式中，瀏覽是指搜尋時沒有查詢或查詢空白。如果一般搜尋資料儲存庫包含結構化資料、含有中繼資料的非結構化資料或網站資料，您可以傳送空白搜尋查詢，接收瀏覽結果。

傳送瀏覽要求時，系統會根據事件信號，傳回資料儲存庫中符合篩選條件的文件。如要提供更優質的瀏覽體驗，請採取下列做法：

• 在搜尋要求中使用篩選器，縮小搜尋結果範圍。如果您使用進階網站索引，請參閱「使用結構化資料進行進階網站索引」，瞭解如何在結構定義中新增中繼資料，並使用這些資料來擴充篩選器和提升欄位。
• 新增提升規格，藉由提升或隱藏特定結果，影響傳回結果的順序。
• 瞭解並記錄使用者事件。Google 會根據使用者事件，盡量提高點擊率，進而調整搜尋結果排名。

瀏覽與搜尋的差異

下表列出搜尋和瀏覽的差異。

功能	搜尋	瀏覽
目的	尋找特定資訊	探索及發掘內容
範例	在 Google 搜尋上搜尋「溫哥華最佳韓國餐廳」	根據餐廳可能所屬的類別瀏覽，例如「餐廳 > 韓式 > 溫哥華 > 4 星以上」
User Intent	通常以目標為導向	探索性
起點	查詢或關鍵字 通常位於搜尋列	通常使用選單、階梯式連結、連結或其他導覽方式 (例如篩選條件) 的特定網站或平台
方法	輸入關鍵字或詞組，並套用搜尋和放送設定	使用空白查詢進行搜尋、套用搜尋和供應設定
結果	相關結果清單	資料存放區中符合篩選條件的所有文件

取得以網站資料為基礎的應用程式瀏覽結果

如要使用 API 取得含有網站資料的應用程式瀏覽結果，請按照下列步驟操作：

1. 找出應用程式 ID。如果已有應用程式 ID，請跳到下一個步驟。

   1. 前往 Google Cloud 控制台的「AI Applications」頁面。

      前往「應用程式」

   2. 在「應用程式」頁面中，找出應用程式名稱，然後從「ID」欄取得應用程式的 ID。

2. 使用空白查詢或不含查詢的 engines.servingConfigs.search 方法，如下所示：

   REST

   重要詞彙：在 Vertex AI Search 中，API 相關的「應用程式」一詞可與「引擎」互換使用。

   curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search:search" \
   -d '{
   "servingConfig": "projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search",
   "orderBy": "ORDER_BY",
   "params": {
        "searchType": "0"
    },
   "filter": "FILTER",
   "boostSpec": "BOOST_SPEC",
   }'
   

   更改下列內容：

   • PROJECT_ID：您的 Google Cloud 專案 ID。
   • APP_ID：要查詢的 Vertex AI Search 應用程式 ID。
   • ORDER_BY：選用。結果的排列順序。要排序的屬性必須有數值解讀，例如 date。詳情請參閱「排序網頁搜尋結果」。
   • FILTER：選用，但建議使用。文字欄位，可使用篩選運算式篩選搜尋結果。預設值為空字串。如要進一步瞭解如何使用 filter 欄位，請參閱「篩選結構化或非結構化資料的通用搜尋」和「篩選網站搜尋」。
   • BOOST_SPEC：選用。用來提高或隱藏文件的規格。值：
     • BOOST：[-1,1] 範圍內的浮點數。如果值為負數，結果會遭到降級 (顯示在結果的較下方)。如果值為正數，結果就會獲得升級 (在結果中排名較高)。
     • CONDITION： 文字篩選運算式，用於選取要套用加成的文件。篩選器必須評估布林值。 如要瞭解如何提升結構化搜尋的搜尋結果，請參閱「提升搜尋結果」。

   您應該會收到類似以下截斷式回應的 JSON 回應。 回應包含依搜尋要求中設定的欄位排序的項目化搜尋結果。

   回應

   {
   "results": [
     {
       "id": "DOCUMENT_ID",
       "document": {
         "name": "projects/PROJECT_ID/locations/global/collections/default_collection/dataStores/DATA_STORE_ID/branches/0/documents/DOCUMENT_ID",
         "id": "DOCUMENT_ID",
         "structData": {},
         "derivedStructData": {
           "displayLink": "LINK_TO_BE_DISPLAYED",
           "link": "DOCUMENT_URL",
           …
         }
       }
     },
     {
       "id": "DOCUMENT_ID",
       "document": {
         "name": "projects/PROJECT_ID/locations/global/collections/default_collection/dataStores/DATA_STORE_ID/branches/0/documents/DOCUMENT_ID",
         "id": "DOCUMENT_ID",
         "structData": {},
         "derivedStructData": {
           "displayLink": "LINK_TO_BE_DISPLAYED",
           "link": "DOCUMENT_URL",
           …
         }
       }
     }
     …
   ]
   }