你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
使用 Azure OpenAI Web 应用
除了 Azure OpenAI Studio、API 和 SDK，还可以使用可用的独立 Web 应用通过图形用户界面与模型交互，可使用 Azure OpenAI Studio 或通过手动部署来部署该界面。
重要注意事项
发布会在订阅中创建 Azure 应用服务。 它可能会产生成本，具体取决于你选择的定价计划。 完成应用后，可以从 Azure 门户中删除它。
不支持 gpt-4 视觉预览模型。
默认情况下，应用将使用已配置的 Microsoft 标识提供者进行部署，从而仅限 Azure 租户的成员访问应用。 若要添加或修改身份验证，请执行以下操作：
转到 Azure 门户并搜索发布期间指定的应用名称。 选择 Web 应用，然后转到左侧导航菜单上的“身份验证”选项卡。 然后选择“添加标识提供者”。
选择“Microsoft”作为标识提供者。 此页上的默认设置将应用限制为仅租户，因此无需在此处更改任何其他内容。 然后选择“添加”
现在，系统将要求用户使用其 Microsoft Entra ID 帐户登录，以便能够访问你的应用。 如果愿意，可以按照类似的过程添加另一个标识提供者。 除验证用户是否为租户成员以外，应用不会以任何其他方式使用用户的登录信息。
Web 应用自定义
可以自定义应用的前端和后端逻辑。 该应用为常见的自定义场景提供了多个环境变量，例如更改应用中的图标。 请参阅 Web 应用的源代码，以及有关 GitHub 的详细信息。
自定义应用时，建议：
如果用户更改了任何设置，则重置聊天会话（清除聊天）。 通知用户其聊天历史记录将丢失。
清楚地传达你实现的每个设置如何影响用户体验。
轮换 Azure OpenAI 或 Azure AI 搜索资源的 API 密钥时，请务必更新每个已部署应用的应用设置以使用新密钥。
GitHub 上提供了 Web 应用的示例源代码。 源代码“按原样”提供，并且仅作为示例。 客户对其 Web 应用的所有自定义和实现负责。
更新 Web 应用
注意
2024 年 2 月 1 日之后，Web 应用要求将应用启动命令设置为 python3 -m gunicorn app:app。 更新在 2024 年 2 月 1 日之前发布的应用时，需要从“应用服务配置”页手动添加启动命令。
建议经常从 Web 应用源代码的 main 分支中拉取更改，以确保获得最新的 bug 修复、API 版本和改进。 此外，每当所使用的 API 版本停用时，都必须同步 Web 应用。
请考虑单击 Web 应用的 GitHub 存储库上的“监视”或星型按钮，以接收有关源代码更改和更新的通知。
如果尚未自定义该应用，则：
- 可以遵循下面的同步步骤操作
如果已自定义或更改该应用的源代码，则：
- 需要手动更新应用的源代码并重新部署它。
- 如果应用托管在 GitHub 上，请将代码更改推送到存储库，并使用下面的同步步骤。
- 如果要手动（例如使用 Azure CLI）重新部署该应用，请遵循你的部署策略的步骤操作。
同步 Web 应用
如果已自定义应用，请更新该应用的源代码。
在 Azure 门户中导航到你的 Web 应用。
在左侧导航菜单中的“部署”下选择“部署中心”。
选择屏幕顶部的“同步”，并确认将要重新部署该应用。
聊天历史记录
可以为 Web 应用的用户启用聊天历史记录。 启用该功能后，用户将有权访问之前的各个查询和响应。
若要启用聊天历史记录，请使用 Azure OpenAI Studio 将模型部署或重新部署为 Web 应用。
启用聊天历史记录后，用户将能够在应用的右上角显示和隐藏它。 显示历史记录时，他们可以重命名或删除对话。 登录应用后，对话将从最新到最早自动排序，并根据对话中的第一个查询进行命名。
删除 Cosmos DB 实例
删除 Web 应用不会自动删除 Cosmos DB 实例。 若要删除 Cosmos DB 实例以及所有存储的聊天，需要导航到 Azure 门户中的关联资源并将其删除。 如果删除 Cosmos DB 资源，但在 Studio 中仍然启用聊天历史记录选项，用户将收到连接错误通知，但可以在不访问聊天历史记录的情况下继续使用 Web 应用。