AutoGen for .NET 入门实战安装 AutoGen 包并构建第一个可对话 Agent【免费下载链接】autogenA programming framework for agentic AI项目地址: https://gitcode.com/GitHub_Trending/au/autogen本篇是 AutoGen.NET 版的入门指南。你将学会如何通过一条 NuGet 命令安装AutoGen包并使用OpenAIChatAgent与UserProxyAgent创建第一个可对话 agent完成从代码片段到可运行程序的完整落地读完之后你不仅掌握官方 Quick Start 代码还能看懂每个参数背后的源码实现原理。1. 安装 AutoGen 包入门的第一步是把AutoGen包添加到你的 .NET 项目中dotnet add package AutoGenAutoGen是一体化的全家桶包。它内部依赖AutoGen.Core、AutoGen.OpenAI、AutoGen.LMStudio、AutoGen.SemanticKernel和AutoGen.SourceGenerator因此只装这一个包就能覆盖入门场景所需的 OpenAI 集成、核心抽象和类型安全函数调用生成能力。如果你只想引入某个特定平台或避免多余依赖也可以按需安装单独的子包完整的包清单与选型建议例如只想要核心抽象就选AutoGen.Core只想做函数调用的源码生成就只装AutoGen.SourceGenerator见 安装指南。2. 创建第一个可对话 Agent安装完成后官方 Quick Start 的核心代码片段如下该片段定义在 GetStartCodeSnippet.cs 中可直接复制到你的项目using AutoGen; using AutoGen.Core; using AutoGen.OpenAI; using AutoGen.OpenAI.Extension; using OpenAI; var openAIKey Environment.GetEnvironmentVariable(OPENAI_API_KEY) ?? throw new Exception(Please set OPENAI_API_KEY environment variable.); var openAIClient new OpenAIClient(openAIKey); var model gpt-4o-mini; var assistantAgent new OpenAIChatAgent( name: assistant, systemMessage: You are an assistant that help user to do some tasks., chatClient: openAIClient.GetChatClient(model)) .RegisterMessageConnector() .RegisterPrintMessage(); // register a hook to print message nicely to console // set human input mode to ALWAYS so that user always provide input var userProxyAgent new UserProxyAgent( name: user, humanInputMode: HumanInputMode.ALWAYS) .RegisterPrintMessage(); // start the conversation await userProxyAgent.InitiateChatAsync( receiver: assistantAgent, message: Hey assistant, please do me a favor., maxRound: 10);运行前请确保已设置环境变量OPENAI_API_KEY。下面逐段拆解这段代码的每个环节。2.1 构造 OpenAIChatAgentOpenAIChatAgent是 AutoGen 对 OpenAI 模型的薄封装实现自IStreamingAgent接口见 OpenAIChatAgent.cs。从源码结构看它的构造函数参数为chatClient由openAIClient.GetChatClient(model)得到的ChatClient即绑定具体模型示例中使用gpt-4o-mini的 OpenAI 聊天客户端nameagent 名称在消息信封MessageEnvelopeT中作为from字段标识消息来源systemMessage系统提示词默认为You are a helpful AI assistant其他可选参数temperature静态工厂默认值 0.7f、maxTokens静态工厂默认值 1024、seed启用确定性输出、responseFormat设置为ChatResponseFormat即可启用 JSON mode、functions注册工具。从 OpenAIChatAgent.cs 的CreateChatMessages方法可以确认一个细节如果传入的历史消息中不存在SystemChatMessageagent 会自动把构造时指定的systemMessage拼接到消息序列头部因此系统提示词始终生效且不会与用户提供的系统消息重复。2.2 注册消息连接器RegisterMessageConnector().RegisterMessageConnector()这行看起来不起眼却是使用 AutoGen 内置消息类型如TextMessage、ImageMessage的前提。从 OpenAIAgentExtension.cs 的源码看它的作用是向 agent 注册一个OpenAIChatRequestMessageConnector流式中间件——把 AutoGen 的抽象消息类型转换为 OpenAI SDK 的ChatMessage类型不传参数时会自动 new 一个默认连接器实例也可以传入自定义连接器以替换行为。没有这个中间件OpenAIChatAgent只能处理原始的 OpenAIChatMessage无法消费 AutoGen 核心的IMessage抽象。紧随其后的.RegisterPrintMessage()则注册一个打印钩子把流经的中间消息和最终回复格式化输出到控制台方便调试对话过程。2.3 创建 UserProxyAgent 并发起对话UserProxyAgent代表人类参与方humanInputMode: HumanInputMode.ALWAYS表示每一轮都由用户在控制台手动输入其他模式可让 agent 在满足终止条件时自动结束。对话通过userProxyAgent.InitiateChatAsync发起三个关键参数为receiver接收方 agent这里是assistantAgentmessage首条消息示例中为Hey assistant, please do me a favor.maxRound对话最大轮数示例中为 10达到上限后自动结束防止无限循环。调用后程序会进入交互式循环控制台显示 assistant 的回复随后等待用户在终端输入下一句话如此往复直到达到maxRound或用户主动退出。3. 继续深入教程与更多示例想按步骤系统学习用 agent 生成回复包括带历史消息的对话、流式响应GenerateStreamingReplyAsync等可跟随官方教程 Chat-with-an-agent更多可运行的完整示例两 agent 数学对话、函数调用、动态群组聊天、ReAct agent、接入 DALL·E 与 GPT-4V 等集中在 AutoGen.Basic.Sample 示例项目例如 Example02_TwoAgent_MathChat.cs 与 Example03_Agent_FunctionCall.cs如果你的场景不是 OpenAI官方也提供了SemanticKernelAgent、LMStudioAgent、MistralClientAgent、AnthropicClientAgent、OllamaAgent、GeminiChatAgent等 agent生成回复的方式与上文示例基本一致详见 安装指南 中的包说明。4. 反馈渠道如果在入门过程中遇到 bug 或有功能诉求可以在上游项目的 issue 跟踪系统中创建 issue 并指定dotnet标签。仓库内 FAQ.md 与 CONTRIBUTING.md 也提供了问题排查与社区参与的一般性指引。【免费下载链接】autogenA programming framework for agentic AI项目地址: https://gitcode.com/GitHub_Trending/au/autogen创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考