教學:在 Azure 容器應用程式 上的 C# 網頁應用程式中新增 Foundry IQ(Azure AI 搜尋服務)

Note

Foundry IQ(Azure AI 搜尋服務)提供直接的索引與查詢 API,並搭配高階知識來源與知識庫 API 用於受控檢索。 使用 Azure 入口網站、REST API 或 Azure SDK 來設定這些功能,或將代理連線到 Microsoft Foundry 入口網站 中的知識庫。

這個教學會建立一個網站,搜尋書籍目錄,並將網站部署到 Azure 容器應用程式。 部署使用 Azure Developer CLI (azd) 及管理式識別碼作為 Foundry IQ 的預設驗證方式。

在本教學課程中,您會:

  • 部署 Foundry IQ,並使用 Azure Developer CLI 自動為索引植入初始資料。
  • 在 C# 應用程式中整合搜尋查詢、建議、面向、分頁和文件查詢功能。
  • 將應用程式部署到 Azure 容器應用程式,並以管理身份作為預設認證方式。

此範例的用途為何?

此範例網站提供 10,000 本書籍目錄的存取權。 您可以在搜尋列中輸入文字來搜尋目錄。 當您輸入文字時,網站會使用搜尋索引的建議功能來自動完成文字。

查詢結束後,網站會顯示書籍清單及其部分資訊。 您可以選擇書籍查看完整資料,這些資料會儲存在搜尋索引中。

範例應用程式的截圖,顯示狗狗搜尋結果,包含作者、語言屬性及分頁控制。

搜尋體驗包括:

  • 搜尋 - 為應用程式提供搜尋功能。
  • 建議功能 - 在使用者於搜尋列輸入時提供建議。
  • 分面與篩選器 - 提供可依作者或語言篩選的分面導覽結構。
  • 分頁結果 - 提供可用於瀏覽結果的分頁控制項。
  • 文件查詢 - 透過 ID 查詢文件,以取得詳細頁面中的所有內容。

範例的組織方式為何?

範例程式碼包含下列元件:

App 目的 GitHub 儲存庫位置
client React 應用程式(簡報層)用來顯示書籍並搜尋。 它會呼叫 API。 /azure-search-static-web-app/client
api C# Azure Functions API(業務層),裝載於 Azure 容器應用程式 的容器中,並使用 .NET SDK 呼叫 Foundry IQ API。 /azure-search-static-web-app/api
bulk-insert .NET 專案,負責建立索引並載入文件。 azd 部署會透過 postprovision 掛鉤自動執行此作業。 /azure-search-static-web-app/bulk-insert
infra 由 azd 用來部署 Foundry IQ、Azure 容器應用程式 和支援資源的 Bicep 基礎架構。 Azure-Samples/azure-search-static-web-app

設定開發環境

請為你的本地開發環境安裝以下軟體。 此azd up指令會配置所有 Azure 資源,包括 Foundry IQ,因此您無需事先建立資源。

這個教學不會在本地執行 Azure Functions API。 如果你想本地執行,請安裝 Azure Functions Core Tools。

用 Git 複製搜尋範例

你可以從本地克隆部署樣本。 這個azd up指令會讀取你本地儲存庫的應用程式和基礎架構檔案,建立容器,配置 Azure 資源,並將客戶端和 API 部署到 Azure 容器應用程式。

  1. 在 Bash 終端機中,將範例應用程式複製到你本地的電腦。

    git clone https://github.com/Azure-Samples/azure-search-static-web-app.git
    
  2. 在同一個 Bash 終端機中,前往此搜尋範例的儲存庫目錄。

    cd azure-search-static-web-app
    
  3. 請使用 Visual Studio Code 指令 code .,開啟儲存庫。 除非另有說明,剩餘任務則由 Visual Studio Code 完成。

    code .
    

下一個步驟