新功能 - 2025

新的一年为我们最受欢迎的 AI 聊天仓库带来了几项备受期待的功能更新！

• 基于托管标识的安全性。此功能利用 Azure 底层的 RBAC，移除了（几乎）所有的密钥和机密。
• appreg_setup.ps1 和 appreg_setup.sh 辅助脚本可帮助您在 Entra ID 中**为您创建应用程序注册**（如果您拥有相应权限）。减少复制粘贴操作，开发者会更开心 🥰
• 增加了对专用终结点和支持 ESLZ 合规部署的支持。

释放 Azure OpenAI 的强大功能

1. 简介
2. 解决方案概述
3. 在本地运行
4. 添加身份提供商
5. 部署到 Azure
6. 使用 GitHub Actions 部署到 Azure
7. 与您的文件聊天
8. 角色设定
9. 扩展功能
10. 环境变量
11. 基于托管标识的部署
12. 迁移注意事项

简介

由 Azure OpenAI 服务提供支持的 Azure 聊天解决方案加速器

由 Azure OpenAI 服务提供支持的 Azure 聊天解决方案加速器 是一款解决方案加速器，使组织能够在自己的 Azure 订阅中部署一个私有聊天租户，同时提供熟悉的用户体验以及基于数据和文件进行聊天的附加功能。

其优势包括：

1. 私有化： 部署在您的 Azure 租户中，允许您将其隔离在自己的 Azure 租户内。
2. 可控性： 网络流量可以完全隔离在您的网络中，并且内置了其他企业级的身份验证安全功能。
3. 价值： 通过使用您自己的内部数据源（即插即用）或与内部服务（例如 ServiceNow 等）集成，为企业带来额外的价值。

部署到 Azure

您可以使用 Azure 开发者 CLI 或下方的“部署到 Azure”按钮来预配该解决方案加速器所需的 Azure 资源。无论您选择哪种方法，仍需设置身份提供商并指定管理员用户。

我们建议您同时阅读专门的部署到 Azure 文档，以了解如何使用 GitHub Actions 部署该应用程序。

部署选项

您可以使用以下任一选项部署该应用程序：

• 1. Azure 开发者 CLI
• 2. Azure 门户部署

1. Azure 开发者 CLI

[!重要提示] 本节将使用 Azure 开发者 CLI 在您的本地环境中创建 Azure 资源并部署该解决方案。请注意，您无需克隆此仓库即可完成这些步骤。

1. 下载 Azure 开发者 CLI
2. 如果您尚未克隆此仓库，请运行 azd init -t microsoft/azurechat。如果您已克隆此仓库，则只需在仓库根目录下运行 azd init。
3. 运行 azd up 以预配并部署应用程序。

azd init -t microsoft/azurechat
azd up

# 如果想查看日志，可以使用调试标志运行
azd up --debug

2. Azure 门户部署

[!警告] 此按钮仅会创建 Azure 资源。您仍需按照部署到 Azure 部分中的说明，使用 GitHub Actions 构建并部署应用程序。

点击“部署到 Azure”按钮以部署该应用程序所需的 Azure 资源。

[!重要提示] 该应用程序受身份提供商保护，请按照添加身份提供商部分中的步骤为您的应用添加身份验证。

下一步：简介

贡献

本项目欢迎贡献和建议。大多数贡献都需要您同意贡献者许可协议 (CLA)，声明您有权并将您的贡献权利授予我们。有关详细信息，请访问 https://cla.opensource.microsoft.com。

当您提交拉取请求时，CLA 机器人会自动确定您是否需要提供 CLA，并相应地标记 PR（例如状态检查、评论）。请按照机器人提供的说明操作即可。对于使用我们 CLA 的所有仓库，您只需执行一次此操作。

本项目采用了微软开源行为准则。更多信息请参阅行为准则常见问题解答或发送电子邮件至 opencode@microsoft.com 提出任何其他问题或意见。

商标

本项目可能包含项目、产品或服务的商标或徽标。未经授权使用 Microsoft 商标或徽标须遵守并遵循Microsoft 商标与品牌指南。在本项目的修改版本中使用 Microsoft 商标或徽标时，不得造成混淆或暗示 Microsoft 的赞助。任何第三方商标或徽标的使用均应遵守相关第三方的政策。

Azure Chat 快速上手指南

Azure Chat 是一个由 Azure OpenAI Service 驱动解决方案加速器，允许组织在自有 Azure 订阅中部署私有的聊天租户。它支持基于内部数据和文件进行对话，并提供企业级的安全隔离与身份验证功能。

环境准备

在开始之前，请确保满足以下前置条件：

• 操作系统：Windows、macOS 或 Linux。
• Azure 账号：拥有有效的 Azure 订阅，且具备创建资源（如 Azure OpenAI、App Service、Storage 等）的权限。
• 命令行工具：
  • 已安装 Azure Developer CLI (azd)。
  • 已安装 Git。
• 身份提供商：需要配置 Entra ID (Azure AD) 作为身份验证提供者。

注意：本项目主要依赖 Azure 全球服务。国内开发者请确保网络环境能够访问 GitHub 及 Azure 全球端点，或使用符合公司合规要求的代理方案。目前官方未提供特定的中国镜像源。

安装步骤

推荐使用 Azure Developer CLI 方式，它可以一键完成资源创建与应用部署。

1. 初始化项目

打开终端，运行以下命令初始化项目（无需手动克隆仓库）：

azd init -t microsoft/azurechat

如果你已经克隆了该仓库，请进入仓库根目录并运行：

azd init

2. provision 资源并部署

运行以下命令以创建 Azure 资源并部署应用程序：

azd up

若需查看详细的部署日志，可添加调试标志：

azd up --debug

重要提示： 上述步骤仅完成了基础设施的搭建。部署完成后，你必须按照 配置身份提供商 的文档设置认证信息并指定管理员用户，否则无法登录应用。

如果需要使用脚本自动创建 Entra ID 中的应用注册（需具备相应权限），可运行项目根目录下的辅助脚本：

• Windows: appreg_setup.ps1
• Linux/Mac: appreg_setup.sh

基本使用

部署并配置好身份验证后，即可开始使用：

1. 访问应用：在终端部署成功的输出中查找应用 URL，或在 Azure 门户中找到已部署的 Web App 地址。
2. 登录：使用配置的 Entra ID 管理员账号或授权用户账号登录。
3. 开始对话：
   • 普通聊天：直接在对话框中输入问题，系统将调用 Azure OpenAI 模型进行回答。
   • 文件对话：点击上传按钮加载内部文档（如 PDF、Word 等），即可针对文件内容进行提问和分析。
   • 角色设定 (Persona)：在设置中定义 AI 的角色行为，使其更符合特定业务场景。
   • 扩展功能：根据需要启用插件或连接内部服务（如 ServiceNow）。

通过以上步骤，你已成功构建了一个安全、私有且具备知识库问答能力的企业级 AI 聊天平台。