你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

使用 Azure OpenAI Web 应用

除了 Azure OpenAI Studio、API 和 SDK，可使用可用的独立 Web 应用，通过图形用户界面与 Azure OpenAI 服务模型进行交互。 可使用 Azure OpenAI Studio 或手动部署来部署应用。

重要注意事项

• 发布会在订阅中创建 Azure 应用服务实例。 它可能会产生成本，具体取决于你选择的定价计划。 完成应用后，可以从 Azure 门户中删除它。

• 不支持具有视觉的 GPT-4 Turbo 模型。

• 默认情况下，应用部署时已配置 Microsoft 标识提供者。 标识提供者将对应用的访问限制到 Azure 租户的成员。 若要添加或修改身份验证，请执行以下操作：

  1. 转到 Azure 门户并搜索发布期间指定的应用名称。 选择该 Web 应用，然后在左侧菜单中选择“身份验证”。 然后选择“添加标识提供者”。

     

  2. 选择“Microsoft”作为标识提供者。 此页上的默认设置将应用限制为仅租户，因此无需在此处更改任何其他内容。 选择 添加 。

  现在，系统将要求用户使用其 Microsoft Entra 帐户登录，以访问你的应用。 如果愿意，可以按照类似的过程添加另一个标识提供者。 除验证用户是否为租户成员以外，应用不会以任何方式使用用户的登录信息。

Web 应用自定义

可自定义应用的前端和后端逻辑。 该应用为常见的自定义场景提供了多个环境变量，例如更改应用中的图标。

自定义应用时，建议：

• 如果用户更改了任何设置，则重置聊天会话（清除聊天）。 通知用户其聊天历史记录将丢失。

• 清楚地传达你实现的每个设置如何影响用户体验。

• 轮换 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 存储库上的“监视”或星型按钮，以接收有关源代码更改和更新的通知。

如果尚未自定义 Web 应用，可使用以下步骤来同步它：

1. 在 Azure 门户中转到 Web 应用。

2. 在左侧菜单上的“部署”下，选择“部署中心”。

3. 选择窗格顶部的“同步”，并确认将要重新部署该应用。

   

如果自定义或更改了应用的源代码，则需要手动更新应用的源代码并重新部署它：

• 如果应用托管在 GitHub 上，请将代码更改推送到存储库，然后使用前面的同步步骤。
• 如果要手动（例如通过使用 Azure CLI）重新部署该应用，请遵循你的部署策略的步骤操作。

聊天历史记录

可为 Web 应用的用户启用历史聊天记录。 启用该功能后，用户有权访问之前的各个查询和响应。

若要启用历史聊天记录，请使用 Azure OpenAI Studio 将模型部署或重新部署为 Web 应用，并选择“在 Web 应用中启用历史聊天记录”。

重要

启用历史聊天记录会在资源组中创建 Azure Cosmos DB 实例，且它会对你使用的存储产生额外费用。

启用历史聊天记录后，用户可在应用的右上角显示和隐藏它。 当用户显示历史聊天记录时，他们可重命名或删除对话。 由于用户已登录到应用，因此对话会自动从最新到最早进行排序。 对话根据对话中的第一个查询进行命名。

删除 Cosmos DB 实例

删除 Web 应用不会自动删除 Cosmos DB 实例。 若要删除 Cosmos DB 实例以及所有存储的聊天，需要转到 Azure 门户中的关联资源并将其删除。 如果删除 Cosmos DB 资源，但在 Studio 中仍然启用历史聊天记录选项，用户会收到连接错误通知，但可在不访问聊天历史记录的情况下继续使用 Web 应用。

相关内容

• 提示工程
• 基于自有数据的 Azure OpenAI