使用 Azure OpenAI Web 應用程式

發行項
07/05/2024

除了 Azure OpenAI Studio、API 和 SDK 之外，您也可以使用可用的獨立 Web 應用程式，透過圖形使用者介面與 Azure OpenAI 模型互動，您可以使用 Azure OpenAI Studio 或手動部署進行部署。

Web 應用程式介面的螢幕擷取畫面。

重要考量

發佈會在您的訂用帳戶中建立 Azure App Service。視您選取的價格方案而定，可能會產生成本。當您完成應用程式時，您可以從 Azure 入口網站中刪除它。
不支援 gpt-4 vision-preview 模型。
根據預設，應用程式會以已設定的 Microsoft 識別提供者進行部署，將應用程式的存取限制為 Azure 租使用者的成員。若要新增或修改驗證：
1. 移至 Azure 入口網站，並搜尋您在發佈期間指定的應用程式名稱。選取 Web 應用程式，然後移至左側導覽功能表上的 [驗證] 索引標籤。然後選取 [新增識別提供者]。
2. 選取 Microsoft 作為識別提供者。此頁面上的預設設定只會將應用程式限制為租用戶，因此您不需要在這裡變更任何其他項目。然後選取 [新增]
現在，系統會要求使用者使用其 Microsoft Entra ID 帳戶登入，才能存取您的應用程式。如果您想要的話，可以遵循類似的程序來新增另一個識別提供者。除了驗證使用者是租用戶的成員，應用程式不會以任何其他方式使用使用者的登入資訊。

Web 應用程式自訂

您也可以自訂應用程式的前端和後端邏輯。應用程式會針對常見的自訂案例提供數個環境變數，例如變更應用程式中的圖示。請參閱 Web 應用程式的原始程式碼，以及 GitHub 上的詳細資訊。

自訂應用程式時，建議您：

如果使用者變更任何設定，請重設聊天工作階段 (清除聊天)。通知使用者他們的聊天記錄將會遺失。
清楚地傳達您實作的每個設定將如何影響使用者體驗。
當您輪替 Azure OpenAI 或 Azure AI 搜尋資源的 API 金鑰時，請務必更新每個已部署應用程式的應用程式設定，以使用新的密鑰。

Web 應用程式的範例原始程式碼可在 GitHub 取得。原始程式碼會以「目前」的形式提供，且僅以範例的形式提供。客戶負責其 Web 應用程式的所有自訂和實作。

更新 Web 應用程式

注意

在 2024 年 2 月 1 日之後，Web 應用程式需要將應用程式啟動命令設定為 python3 -m gunicorn app:app。更新在 2024 年 2 月 1 日之前發布的應用程式時，您必須從 App Service 組態 頁面手動新增啟動命令。

建議您經常從 Web 應用程式的原始程式碼 main 分支提取變更，以確保您有最新的錯誤修正、API 版本和改進功能。此外，每次使用的 API 版本淘汰時，都必須同步處理 Web 應用程式

請考慮按一下 Web 應用程式的 GitHub 存放庫上的 [關注] 或 [星號] 按鈕，以收到原始程式碼變更和更新的通知。

如果您尚未自訂應用程式：

您可以遵循下列同步處理步驟

如果您已自訂或變更應用程式的原始程式碼：

您必須手動更新應用程式的原始程式碼並重新部署它。
- 如果您的應用程式裝載在 GitHub 上，請將程式碼變更推送至存放庫，並使用下面的同步處理步驟。
- 如果您要手動重新部署應用程式 (例如 Azure CLI)，請遵循部署策略的步驟。

同步處理 Web 應用程式

如果您已自訂您的應用程式，請更新應用程式的原始程式碼。
在 Azure 入口網站中，瀏覽至您的 Web 應用程式。
在導覽功能表中選取 [部署] 下的 [部署中心]。
選取畫面頂端的 [同步]，並確認應用程式將會重新部署。

聊天記錄

您可以為 Web 應用程式的使用者啟用聊天記錄。當您啟用此功能時，您的使用者將可以存取其個別先前的查詢和回應。

若要啟用聊天記錄，請使用 Azure OpenAI Studio，將模型部署或重新部署為 Web 應用程式。

重要

啟用聊天記錄將會在您的資源群組中建立 Cosmos DB 執行個體，並產生所使用記憶體的額外費用。

啟用聊天記錄之後，您的使用者將能夠在應用程式右上角顯示和隱藏它。顯示記錄時，他們可以重新命名或刪除交談。當他們登入應用程式時，交談會自動從最新到最舊的順序排序，並根據交談中的第一個查詢來命名。

刪除 Cosmos DB 執行個體

刪除 Web 應用程式並不會自動刪除 Cosmos DB 執行個體。若要刪除 Cosmos DB 執行個體以及所有已儲存的聊天，您必須瀏覽至 Azure 入口網站中的關聯資源並加以刪除。如果您刪除 Cosmos DB 資源，但保持 Studio 上啟用的聊天記錄選項為啟用，您的使用者會收到連線錯誤通知，但可以繼續使用 Web 應用程式而不存取聊天記錄。

共用方式為