使用Azure AI Foundry SDK构建生成式AI聊天应用教程

概述

在本教程中，我们将学习如何使用Azure AI Foundry SDK构建一个能够与语言模型对话的聊天应用。这个项目是MicrosoftLearning/mslearn-ai-studio课程的一部分，旨在帮助开发者快速上手Azure AI服务。

准备工作

环境要求

• Azure订阅账户
• 基本的Python或C#编程知识
• 约40分钟的时间

技术栈

• Azure AI Foundry服务
• GPT-4o语言模型
• Azure AI Foundry SDK和Azure AI Model Inference SDK

第一步：部署AI模型

1. 登录Azure AI Foundry门户 使用Azure凭证登录Azure AI Foundry门户，这是管理AI项目的中心平台。

2. 选择模型

   • 在"Explore models and capabilities"部分搜索"gpt-4o"模型
   • 点击模型详情页的"Use this model"按钮

3. 创建项目

   • 输入项目名称
   • 展开"Advanced options"进行高级配置
   • 设置以下参数：
     • Azure AI Foundry资源名称
     • 订阅信息
     • 资源组（新建或选择现有）
     • 支持AI服务的区域

4. 完成部署

   • 点击"Create"按钮
   • 等待项目创建完成（约2-5分钟）
   • 记下模型部署名称（默认为"gpt-4o"）

注意：某些区域可能有配额限制，如果遇到问题可尝试更换区域

第二步：开发客户端应用

配置应用

1. 获取项目信息

   • 从项目概览页获取"Azure AI Foundry project endpoint"
   • 打开Azure门户并启动Cloud Shell（选择PowerShell环境）

2. 准备代码环境

   rm -r mslearn-ai-foundry -f
   git clone https://github.com/microsoftlearning/mslearn-ai-studio mslearn-ai-foundry
   

3. 安装依赖库

   • Python环境：

   python -m venv labenv
   ./labenv/bin/Activate.ps1
   pip install python-dotenv azure-identity azure-ai-projects azure-ai-inference
   

   • C#环境：

   dotnet add package Azure.Identity
   dotnet add package Azure.AI.Projects --version 1.0.0-beta.9
   dotnet add package Azure.AI.Inference --version 1.0.0-beta.5
   

4. 配置连接信息

   • 编辑配置文件（Python为.env，C#为appsettings.json）
   • 填入项目端点和模型部署名称

核心代码实现

1. 初始化项目客户端

   • 使用Azure凭证建立连接
   • 示例Python代码：

   projectClient = AIProjectClient(            
       credential=DefaultAzureCredential(
           exclude_environment_credential=True,
           exclude_managed_identity_credential=True
       ),
       endpoint=project_connection,
   )
   

2. 创建聊天客户端

   chat = projectClient.inference.get_chat_completions_client()
   

3. 设置系统消息

   prompt=[
       SystemMessage("You are a helpful AI assistant that answers questions.")
   ]
   

4. 实现聊天循环

   while True:
       input_text = input("You: ")
       if input_text.lower() == "quit":
           break
           
       prompt.append(UserMessage(input_text))
       response = chat.complete(
           model=model_deployment,
           messages=prompt)
       completion = response.choices[0].message.content
       print(completion)
       prompt.append(AssistantMessage(completion))
   

运行应用

1. Azure登录

   az login
   

   按照提示完成认证流程

2. 启动应用

   • Python：

   python chat-app.py
   

   • C#：

   dotnet run
   

3. 测试对话

   • 输入问题如："What is the fastest animal on Earth?"
   • 尝试后续问题："Where can I see one?"
   • 输入"quit"退出

常见问题解决

1. 配额不足错误

   • 等待几秒后重试
   • 如持续出现，考虑更换区域

2. 权限问题

   • 确保使用正确的Azure凭证
   • 检查项目权限设置

清理资源

完成实验后，为避免产生不必要费用：

1. 打开Azure门户
2. 导航至使用的资源组
3. 选择"Delete resource group"并确认删除

总结

通过本教程，我们完成了：

1. 在Azure AI Foundry中部署GPT-4o模型
2. 使用SDK构建聊天客户端应用
3. 实现与AI模型的持续对话功能

这个项目展示了Azure AI服务的强大能力，开发者可以基于此构建更复杂的AI应用场景。