07 · 07-dotnet-agent-framework

原课程补充材料

根据对应简体中文译本整理。原代码片段未进行云端验证。

🎯 使用 Azure OpenAI (Responses API) 进行规划与设计模式 (.NET)

📋 学习目标

本笔记本演示了使用 Microsoft Agent Framework 在 .NET 中结合 Azure OpenAI (Responses API) 构建智能 Agent 的企业级规划和设计模式。你将学习如何创建能够分解复杂问题、规划多步解决方案，并利用 .NET 企业功能执行复杂工作流的 Agent。

⚙️ 前提条件及设置

开发环境：

.NET 9.0 SDK 或更高版本
Visual Studio 2022 或带有 C# 扩展的 VS Code
拥有 Azure 订阅，并配置了 Azure OpenAI 资源及模型部署
Azure CLI — 使用 az login 登录

所需依赖：

xml

<PackageReference Include="Microsoft.Extensions.AI" Version="10.*" />
<PackageReference Include="Microsoft.Agents.AI" Version="1.*-*" />
<PackageReference Include="Microsoft.Agents.AI.OpenAI" Version="1.*-*" />
<PackageReference Include="Azure.AI.OpenAI" Version="2.1.0" />
<PackageReference Include="Azure.Identity" Version="1.13.1" />
<PackageReference Include="DotNetEnv" Version="3.1.1" />

环境配置 (.env 文件)：

text

AZURE_OPENAI_ENDPOINT=https://<your-resource>.openai.azure.com
AZURE_OPENAI_DEPLOYMENT=gpt-5-mini

运行代码

本课程包含一个 .NET 单文件应用实现。运行方式：

bash

# 使文件可执行（Linux/macOS）
chmod +x 07-dotnet-agent-framework.cs

# 运行应用程序
./07-dotnet-agent-framework.cs

或者使用 dotnet run 命令：

bash

dotnet run 07-dotnet-agent-framework.cs

代码实现

详细实现位于 07-dotnet-agent-framework.cs，示范：

通过 DotNetEnv 加载环境配置
配置 Azure OpenAI 客户端并使用 GetChatClient().AsAIAgent() 创建 AI Agent
使用 JSON 序列化定义结构化数据模型（Plan 和 TravelPlan）
创建输出结构化且使用 JSON 模式的 AI Agent
执行带类型安全响应的规划请求

关键概念

使用类型安全模型进行结构化规划

Agent 使用 C# 类定义规划输出的结构：

csharp

public class Plan
{
    [JsonPropertyName("assigned_agent")]
    public string? Assigned_agent { get; set; }

    [JsonPropertyName("task_details")]
    public string? Task_details { get; set; }
}

public class TravelPlan
{
    [JsonPropertyName("main_task")]
    public string? Main_task { get; set; }

    [JsonPropertyName("subtasks")]
    public IList<Plan> Subtasks { get; set; }
}

用于结构化输出的 JSON 模式

Agent 配置为返回符合 TravelPlan 模式的响应：

csharp

ChatClientAgentOptions agentOptions = new()
{
    Name = AGENT_NAME,
    Description = AGENT_INSTRUCTIONS,
    ChatOptions = new()
    {
        ResponseFormat = ChatResponseFormatJson.ForJsonSchema(
            schema: AIJsonUtilities.CreateJsonSchema(typeof(TravelPlan)),
            schemaName: "TravelPlan",
            schemaDescription: "Travel Plan with main_task and subtasks")
    }
};

规划 Agent 指令

Agent 充当协调者，将任务分配给专门的子 Agent：

FlightBooking：负责预订航班及提供航班信息
HotelBooking：负责预订酒店及提供酒店信息
CarRental：负责租车及提供租车信息
ActivitiesBooking：负责预订活动及提供活动信息
DestinationInfo：负责提供目的地信息
DefaultAgent：负责处理通用请求

预期输出

运行 Agent 并发出旅行规划请求时，Agent 会分析请求并生成结构化计划，合理分配任务给专门 Agent，格式为符合 TravelPlan 模式的 JSON。

07 · 07-dotnet-agent-framework ​

🎯 使用 Azure OpenAI (Responses API) 进行规划与设计模式 (.NET) ​

📋 学习目标 ​

⚙️ 前提条件及设置 ​

运行代码 ​

代码实现 ​

关键概念 ​

使用类型安全模型进行结构化规划 ​

用于结构化输出的 JSON 模式 ​

规划 Agent 指令 ​

预期输出 ​