從 Custom Search Site Restricted JSON API 遷移

如果您使用 Programmable Search Engine 的 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. 在「Create App」頁面，點選「Site search with AI mode」下方的「Create」。

  4. 確認「Enterprise edition features」(Enterprise 版功能)已啟用。這是網站搜尋功能的必要條件。詳情請參閱「Enterprise 版本功能」。

  5. 關閉「Advanced LLM features」(進階 LLM 功能)。關閉這項功能後，您就能使用類似程式化搜尋引擎的 Custom Search Site Restricted JSON API 功能。如果您不需要搜尋摘要或搜尋追蹤，請關閉這項功能。詳情請參閱「進階 LLM 功能」。

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

  7. 在「貴公司或貴機構的外部名稱」欄位中，輸入貴公司或貴機構的常用名稱。

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

  9. 在「Data stores」(資料儲存庫) 頁面中，按一下「Create data store」(建立資料儲存庫)。

  10. 在「Select a data source」(選取資料來源) 窗格中，選取「Website Content」(網站內容)。

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

  12. 在「Specify URL patterns to index」窗格的「Sites to include」欄位中，輸入要搜尋的網站網址模式，然後按一下「Continue」。

  13. 在「Configure your data store」(設定資料儲存庫) 窗格中，輸入資料儲存庫的顯示名稱，然後按一下「Create」(建立)。

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

部署搜尋應用程式

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

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

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

  1. 如要設定 OAuth 2.0，請參閱「驗證 AI 應用程式」中的「在 Google Cloud 上」。請務必將 Discovery Engine 使用者或 Discovery Engine 檢視者角色新增至服務帳戶。

  2. 您可以透過下列任一方式部署搜尋應用程式：

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

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

  1. 建立 API 金鑰：

    1. 在 Google Cloud 控制台中，前往「Credentials」頁面。

      憑證

    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 金鑰驗證，以及使用 search 和 answer 方法搭配 OAuth 2.0 驗證的差異。

功能/方法 searchLite 方法 search 方法
驗證 API 金鑰 OAuth 2.0
可使用搜尋小工具 ✘ ✔
搜尋摘要 ✔ ✔
搜尋公開網站 ✔ ✔

後續步驟