微软AI初学者项目中的Azure环境变量配置指南

在微软开源的AI初学者项目中，配置Azure相关环境变量是项目运行的关键步骤。本文将详细介绍如何获取和设置这些关键配置项，帮助开发者顺利完成项目部署。

核心环境变量概述

该项目需要配置的环境变量主要分为以下几类：

1. GitHub相关凭证
2. Azure项目基本信息
3. OpenAI服务配置
4. AI搜索服务配置
5. 模型部署信息

详细配置说明

1. GitHub凭证配置

GITHUB_TOKEN是访问GitHub仓库所需的个人访问令牌。开发者需要在GitHub账户设置中创建具有适当权限的访问令牌，然后将其填入.env文件中。

2. Azure项目基础信息

在Azure AI Foundry的"概览"页面可以找到以下关键信息：

• AZURE_SUBSCRIPTION_ID：位于项目详情部分
• AZURE_AI_PROJECT_NAME：显示在页面顶部
• AZURE_OPENAI_SERVICE：在"包含的功能"选项卡中查找
• PROJECT_CONNECTION_STRING：在项目详情的连接部分获取

3. OpenAI服务配置

管理中心的配置项：

• AZURE_OPENAI_RESOURCE_GROUP：在项目属性中查找
• GLOBAL_LLM_SERVICE：检查"已连接资源"中的Azure AI服务连接名称

Azure门户中的配置：

• AZURE_OPENAI_ENDPOINT：在AI服务的"资源管理→密钥和终结点"中获取语言API终结点
• AZURE_OPENAI_API_KEY：同上位置，复制任一管理密钥
• AZURE_OPENAI_API_VERSION：参考最新的GA API版本

4. AI搜索服务配置

AZURE_SEARCH_SERVICE_ENDPOINT和AZURE_SEARCH_API_KEY都可以在Azure AI搜索资源中获取：

• 终结点URL在资源概览页面
• API密钥在"设置→密钥"部分

5. 模型部署信息

在"模型+终结点"页面可以获取：

• AZURE_OPENAI_EMBEDDING_DEPLOYMENT_NAME：选择嵌入模型(如text-embedding-ada-002)后查看部署名称
• AZURE_OPENAI_CHAT_DEPLOYMENT_NAME：选择聊天模型(如gpt-4o-mini)后查看部署名称

配置建议与最佳实践

1. 安全性考虑：所有密钥类配置都应妥善保管，建议使用环境变量而非硬编码在配置文件中
2. 版本控制：API版本应选择稳定的GA版本，避免使用即将弃用的版本
3. 资源组织：确保所有相关资源位于同一资源组中，便于管理和维护
4. 权限管理：遵循最小权限原则，仅授予必要的访问权限

通过以上步骤，开发者可以顺利完成微软AI初学者项目的Azure环境配置，为后续的AI应用开发奠定基础。