Azure OpenAI 简易聊天应用快速部署指南

本指南将带您详细了解从获取代码到运行微软提供的Azure OpenAI简易聊天应用的过程。此应用利用了Azure OpenAI服务，并支持在自己的数据上运行（包括多种数据源）。下面将逐步解析其目录结构、启动文件以及配置方法。

1. 项目目录结构及介绍

项目的主要目录和文件结构如下：

.
├── backend                          # 后端代码存放区
│   ├── ...
├── frontend                         # 前端应用程序代码
│   ├── src
│   │   └── pages
│   │       └── chat                # 聊天功能相关前端代码
│   ├── ...
├── infrastucture                    # 部署和基础设施相关配置
├── notebooks                        # 可能用于训练或测试的Jupyter Notebook文件
├── scripts                          # 辅助脚本
├── static                           # 静态资源文件，由前端构建生成
├── tests                            # 测试文件
├── tools                            # 开发工具和辅助工具
├── .env.sample                      # 环境变量示例文件
├── env                              # （开发中使用的实际环境变量）
├── gitattributes
├── gitignore
├── CODE_OF_CONDUCT.md
├── LICENSE
├── README.md                        # 主要的项目说明文件
├── README_azd.md                    # 针对Azure Developer CLI的部署说明
├── SECURITY.md
├── SUPPORT.md
├── TEST_CASE_FLOWS.md
└── WebApp
    ├── Dockerfile                   # Docker部署所需文件
    └── dockerignore                 # Docker构建时忽略的文件列表

• backend: 包含后端逻辑，如API处理和与Azure OpenAI服务的交互。
• frontend: 前端UI代码，用户界面所在。
• .env.sample: 提供了配置环境变量的模板，用于本地开发。
• Dockerfile 和 dockerignore: 支持通过Docker进行部署和容器化管理。

2. 项目启动文件介绍

• start.cmd/start.sh: 这些是启动脚本，负责构建前端、安装后端依赖并启动整个应用。Windows系统下使用start.cmd，而Linux或macOS则使用start.sh。

• 对于开发者，还可以选择使用VSCode中的调试配置(vscode/launch.json)来仅启动后端，在调试模式下工作。

3. 项目配置文件介绍

环境配置（.env 文件）

配置文件的核心在于.env文件（基于.env.sample创建），它存储所有必要的密钥、URL和其他敏感信息，确保了安全性。这包括但不限于Azure OpenAI的访问密钥、模型名称、以及可能的数据源设置等。

• 本地开发: 创建一个.env文件在本地复制.env.sample的内容，并填入您的真实凭据和设置。
• 生产部署: 在Azure App Service中，这些设置通过JSON文件(env.json)上传，确保与环境变量兼容。

其他重要配置

• appsettings: 在Azure部署后，通过Azure portal或Azure CLI设置的特定于应用的配置项，例如启动命令、身份验证设置等。
• azure.yaml: 如果涉及Azure DevOps管道，这里可能包含CI/CD相关的配置。

通过遵循上述步骤和理解各部分的功能，您可以有效地部署和管理这个集成Azure OpenAI的聊天应用。记得在处理认证和数据访问时遵循最佳实践，以保护您的应用和服务不受未授权访问。