從 Custom Search Site Restricted JSON API 遷移

如果您使用程式化搜尋引擎的 Custom Search Site Restricted JSON API,就能透過 Vertex AI Search,在幾分鐘內建立及部署品質媲美 Google 的網站限定搜尋功能。如要部署應用程式,您可以複製 Google Cloud 控制台中的程式碼,直接貼到網頁中,使用搜尋小工具,完全不需編寫程式碼。或者,您也可以實作 API 部署作業,控管搜尋功能在網站上的顯示方式。如要進一步瞭解如何使用 API,請參閱「使用網站資料取得應用程式的搜尋結果」的 REST 分頁,以及 REST 參考資料中的 servingConfigs.search 方法。

除了 Vertex AI Search 隨搜尋結果傳回的標準簡短摘要外,您還可以在搜尋中加入進階功能。包括生成搜尋結果摘要可追問的搜尋 (可根據脈絡搜尋並追問問題),以及擷取式答案 (從搜尋結果中擷取文字並提供答案)。如要使用這些網頁搜尋進階功能,必須驗證網域,且會產生額外的索引費用。

你也可以篩選排序搜尋結果,並套用宣傳控制項,將連結顯示為宣傳結果。

詳情請參閱 AI 應用程式定價頁面。

設定 Vertex AI Search

如要設定 Vertex AI Search,請按照下列步驟操作:

  1. 在 Google Cloud 控制台的專案選取器頁面中,選取您用於 Custom Search Site Restricted JSON API 的專案。

  2. 開啟 AI Applications

建立搜尋應用程式

如要建立搜尋應用程式,請按照下列步驟操作:

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

    AI 應用程式

  2. 點選「Create app」(建立應用程式)

  3. 在「建立應用程式」頁面,點選「運用 AI 模式打造站內搜尋服務」下方的「建立」

  4. 確認已啟用「Enterprise 版功能」。這是網站搜尋的必要資訊。詳情請參閱「Enterprise 版本功能」。

  5. 關閉「進階 LLM 功能」。關閉這項功能後,您就能使用類似於程式化搜尋引擎 Custom Search Site Restricted JSON API 的功能。如果不需要搜尋摘要或後續搜尋功能,請關閉這項設定。詳情請參閱「進階 LLM 功能」。

  6. 在「應用程式名稱」欄位中輸入應用程式名稱。

  7. 在「External name of your company or organization」(貴公司或貴機構的外部名稱) 欄位中,輸入貴公司或機構的常用名稱。

  8. 選取「global (Global)」(全球 (全球)) 做為應用程式的位置,然後點選「Continue」(繼續)

  9. 在「Data stores」(資料儲存庫) 頁面,點選「Create data store」(建立資料儲存庫)

  10. 在「選取資料來源」窗格中,選取「網站內容」

  11. 關閉「進階網站索引」索引功能。關閉這項功能後,您就能使用與程式化搜尋引擎的 Custom Search Site Restricted JSON API 類似的功能。如果不需要搜尋摘要或後續搜尋功能,或是您不擁有指定的網域,請關閉這項設定。詳情請參閱「進階網站索引」。

  12. 在「Specify URL patterns to index」(指定要建立索引的網址模式) 窗格的「Sites to include」(要包含的網站) 欄位中,輸入要搜尋的網站網址模式,然後按一下「Continue」(繼續)

  13. 在「設定資料儲存庫」窗格中,輸入資料儲存庫的顯示名稱,然後按一下「建立」

  14. 在「Data Stores」(資料儲存庫) 頁面中,選取新的資料儲存庫,然後點選「Create」(建立)

部署搜尋應用程式

決定要使用 OAuth 2.0 還是 API 金鑰,驗證 Vertex AI Search 搜尋應用程式。如要瞭解各方法的優缺點,請參閱「關於驗證」。

部署搜尋應用程式 (OAuth 2.0)

如要使用 OAuth 2.0 驗證部署搜尋應用程式,請按照下列步驟操作:

  1. 如要設定 OAuth 2.0,請參閱「在 Google Cloud 上」一節的「驗證 AI 應用程式」。請務必將「Discovery Engine User」或「Discovery Engine Viewer」角色新增至服務帳戶。

  2. 請透過下列任一方式部署搜尋應用程式:

部署搜尋應用程式 (API 金鑰)

如要使用 API 金鑰驗證身分並部署搜尋應用程式,請按照下列步驟操作:

  1. 建立 API 金鑰:

    1. 前往 Google Cloud 控制台的「憑證」頁面。

      憑證

    2. 如果尚未進入專案,請在 Google Cloud 控制台頁面頂端的專案清單中選取專案。

    3. 按一下「建立憑證」,然後選取「API 金鑰」請勿新增任何參照網址限制。部分使用者隱私權設定不會傳遞參照網址。

      • 記下產生的 API 金鑰,呼叫 searchLite 方法時會用到。
    4. 為提高安全性,請在 API 金鑰中新增 HTTP 限制,限制 https://discoveryengine.googleapis.com/* 的 AI 應用程式服務存取權。

  2. 使用 API 部署搜尋應用程式。 請參閱「使用網站資料取得應用程式的搜尋結果 (API 金鑰)」和 REST 參考資料中的 servingConfigs.searchLite 方法。如要排序網頁搜尋查詢結果,請參閱「排序網頁搜尋結果」。

關於驗證

程式化搜尋引擎的 Custom Search Site Restricted JSON API 會使用 API 金鑰進行驗證。不過,除了少數例外情況,Vertex AI Search 必須使用 OAuth 2.0。如要繼續使用 API 金鑰進行驗證,您必須透過 API 呼叫使用 searchLite 方法。

如果您選擇透過 OAuth 2.0 驗證,則需要使用 search 方法和 answer 方法查詢網站,此外,您也可以透過免程式碼搜尋小工具部署搜尋應用程式。

下表列出使用 searchLite 方法搭配 API 金鑰驗證,與使用 searchanswer 方法搭配 OAuth 2.0 驗證的差異。

功能/方法 searchLite 方法 search 方法
驗證 API 金鑰 OAuth 2.0
提供搜尋小工具
搜尋摘要
搜尋公開網站

後續步驟