Note
Foundry IQ(Azure AI 搜尋服務)提供直接的索引與查詢 API,並搭配高階知識來源與知識庫 API 用於受控檢索。 使用 Azure 入口網站、REST API 或 Azure SDK 來設定這些功能,或將代理連線到 Microsoft Foundry 入口網站 中的知識庫。
使用 Azure Developer CLI (azd) 部署搜尋啟用的網站到 Azure 容器應用程式 此部署包含 React 用戶端、.NET API、Foundry IQ、管理式身份,以及支援的 Azure 資源。
部署使用管理身份作為 Foundry IQ 的預設驗證方式。 你可以選擇在部署前將 USE_KEYLESS_AUTH 設定為 false,以選擇使用基於金鑰的驗證。
登入 Azure
在 Visual Studio Code 中,請在儲存庫根目錄開啟終端機,例如
azure-search-static-web-app。請使用
azd登入Azure。azd auth login如果瀏覽器提示你這麼做,請使用你在本教學課程中使用的 Azure 帳號完成登入程序。
創造一個 azd 環境
創造一個
azd環境。 請用一個簡短的名稱來YOUR-ENVIRONMENT-NAME識別這個教學部署。azd env new YOUR-ENVIRONMENT-NAME
(可選)配置基於金鑰的認證
預設的認證方式是管理身份,因此大多數環境可以跳過此部分。 只有當你的環境需要 API 金鑰時,才請完成此部分。
將 USE_KEYLESS_AUTH 設定為 false。
azd env set USE_KEYLESS_AUTH false
如果你沒有設定 USE_KEYLESS_AUTH,部署會使用受控識別。 Bicep 基礎架構賦予容器應用程式身份對 Foundry IQ 資料平面的存取權。
使用 azd up 部署
從存放庫根路徑中執行
azd up。azd up當被要求時,選擇資源的 Azure 訂閱和地點。
等待
azd配置基礎設施、建置容器、推送映像檔,並將服務部署到 Azure 容器應用程式。部署後檢視輸出。 輸出內容包含用於 Azure 容器應用程式 部署的用戶端與伺服器完整網域名稱(FQDN)。
AZURE_CLIENT_URL: <client-container-app-fqdn> AZURE_SERVER_URL: <server-container-app-fqdn> SEARCH_SERVICE_NAME: <search-service-name>用這個
AZURE_CLIENT_URL值來開啟網站。 用戶端應用程式透過部署期間設定的端點呼叫伺服器應用程式。部署同時建立了 Foundry IQ 服務,並透過
good-books範例儲存庫中的掛鉤自動postprovision載入索引。
請在你的容器應用程式網站使用搜尋
在瀏覽器中開啟
azd up輸出中的用戶端 FQDN。在網站搜尋欄中,輸入搜尋查詢,例如
code。 自動補全功能建議書名相符。選取建議或繼續輸入您自己的查詢。 完成搜尋後選擇 「Enter 」。
檢視結果,然後選取一本書以查看更多詳細資料。
Troubleshooting
如果網頁應用程式無法部署或無法運作,請使用以下清單來找出並修正問題:
完成了
azd up嗎?檢視
azd up第一個失敗的配置、建置或部署步驟的輸出。 如果部署在佈建期間停止,請檢查你的訂閱權限和所選區域。 如果部署在容器建置或部署步驟期間停止,請在修正回報的問題後重新執行azd up。你能開啟客戶端端點嗎?
打開來自
azd up輸出的AZURE_CLIENT_URL值。 如果頁面無法載入,請前往 Azure 入口網站,開啟客戶端容器應用程式,檢查其版本狀態和日誌。用戶端可以呼叫伺服器端點嗎?
打開瀏覽器的開發人員工具,檢查客戶端應用程式發出的網路請求。 若呼叫 API 失敗,請確認伺服器容器應用程式正在執行,且客戶端應用程式在部署期間已收到伺服器 FQDN。
伺服器可以查詢 Foundry IQ 嗎?
如果搜尋傳回錯誤,請檢視伺服器容器應用程式的日誌。 對於受控識別,請確認該受控識別具有 Foundry IQ 資料平面存取權限。 針對基於金鑰的驗證,請確認您在部署前將
USE_KEYLESS_AUTH設為false,且產生的容器環境包含 Foundry IQ 服務設定。
清理資源
用azd down --purge來刪除本教學建立的 Azure 資源。 該 --purge 旗標會永久移除支援軟刪除的資源,而非讓它們在保留期間處於可恢復狀態。 如果你之後重新部署這個教學,清除可以避免命名衝突。
從儲存庫根節點執行清理指令。
azd down --purge檢視列出的
azd資源。出現提示時,確認刪除。
如果您在部署之外azd建立了 Foundry IQ 服務,請前往 Azure 入口網站中的 Foundry IQ 服務,並在頁面頂端選擇「刪除」。