🔍 探索 Microsoft Agent Framework - 基础代理 (.NET)

📋 学习目标

本示例通过在 .NET 中实现基础代理，探索 Microsoft Agent Framework 的基本概念。您将学习核心代理模式，并通过 C# 和 .NET 生态系统了解智能代理的运行原理。

您将发现

• 🏗️ 代理架构：理解 .NET 中人工智能代理的基本结构
• 🛠️ 工具集成：代理如何使用外部函数扩展功能
• 💬 对话流程：通过线程管理管理多轮对话与上下文
• 🔧 配置模式：.NET 中代理设置和管理的最佳实践

🎯 涉及的关键概念

代理框架原则

• 自治性：代理如何使用 .NET AI 抽象独立决策
• 响应性：响应环境变化和用户输入
• 主动性：基于目标和上下文主动采取行动
• 社交能力：通过自然语言和对话线程进行交互

技术组件

• AIAgent：核心代理协调和对话管理 (.NET)
• 工具函数：通过 C# 方法和特性扩展代理功能
• Azure OpenAI 集成：利用 Azure OpenAI Responses API 调用语言模型
• 安全配置：基于环境的端点管理

🔧 技术栈

核心技术

• Microsoft Agent Framework (.NET)
• Azure OpenAI（Responses API）集成
• Azure.AI.OpenAI 客户端模式
• 使用 DotNetEnv 进行基于环境的配置

代理能力

• 自然语言理解与生成
• 使用 C# 特性进行函数调用和工具使用
• 具备上下文感知的对话会话响应
• 通过依赖注入模式实现可扩展架构

📚 框架比较

本示例演示 Microsoft Agent Framework 方法与其他代理框架的对比：

特性	Microsoft Agent Framework	其他框架
集成	原生微软生态系统	兼容性多样
简洁性	清晰直观的 API	通常设置复杂
可扩展性	轻松集成工具	依赖于框架
企业级	面向生产环境构建	取决于框架

🚀 入门

前置条件

• .NET 10 SDK 或更高版本
• 拥有 Azure OpenAI 资源和模型部署的 Azure 订阅
• 安装 Azure CLI 并使用 az login 登录

所需环境变量

# zsh/bash