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,因此您無需事先建立資源。
- .NET 9 或更新版本
- Git
- Visual Studio Code
- Visual Studio Code 的 C# 開發工具擴充功能
-
Azure Developer CLI (
azd) - Docker Desktop 或其他相容 Docker 容器執行環境
這個教學不會在本地執行 Azure Functions API。 如果你想本地執行,請安裝 Azure Functions Core Tools。
用 Git 複製搜尋範例
你可以從本地克隆部署樣本。 這個azd up指令會讀取你本地儲存庫的應用程式和基礎架構檔案,建立容器,配置 Azure 資源,並將客戶端和 API 部署到 Azure 容器應用程式。
在 Bash 終端機中,將範例應用程式複製到你本地的電腦。
git clone https://github.com/Azure-Samples/azure-search-static-web-app.git在同一個 Bash 終端機中,前往此搜尋範例的儲存庫目錄。
cd azure-search-static-web-app請使用 Visual Studio Code 指令
code .,開啟儲存庫。 除非另有說明,剩餘任務則由 Visual Studio Code 完成。code .