本文详细介绍了如何使用 AutoGen 框架构建 AI Agent 以实现自动化任务。文章首先解释了 AI Agent 的基本概念及其感知、决策、执行三大模块。接着重点讲解了 AutoGen 的核心组件，包括 AssistantAgent 和 UserProxyAgent，以及代码执行器的两种模式：本地执行与 Docker 容器隔离。通过绘制股票趋势图的实战案例，演示了 Agent 如何自动生成代码、执行、捕获错误并自我修正的完整闭环流程。此外，文章还补充了关于依赖管理、成本优化、安全性考量及上下文窗口限制的最佳实践建议，帮助开发者安全高效地部署 Agent 应用。
AI Agent（智能体）是指具有自主决策能力和自我学习能力的计算机程序或机器人。与传统脚本不同，Agent 能够通过感知环境、分析信息、制定决策并执行行动来完成任务。一个典型的智能体架构通常包含三个核心模块：
这种架构使得 Agent 能够处理复杂的、非确定性的任务，而不仅仅是执行预设的线性流程。
AutoGen 是由微软开源的一个多智能体对话框架，旨在简化开发者的工作流。它允许开发者定义多个具有不同角色的智能体，通过对话协作完成复杂任务。在 AutoGen 中，最核心的组件包括：
使用 AutoGen 的核心优势在于其内置的对话循环机制。当 Agent 生成的代码无法运行时，它会接收错误信息，自动尝试修复代码，直到任务成功完成。这种自我修正能力大大降低了开发调试的成本。
在开始编写代码之前，需要确保 Python 环境已就绪。推荐使用 Python 3.8 及以上版本。
首先，通过 pip 安装 AutoGen 库：
pip install pyautogen
此外，为了运行绘图和数据分析任务，还需要安装以下依赖库：
pip install matplotlib yfinance pandas
其中，yfinance 用于获取股票数据，matplotlib 用于绘制图表，pandas 用于数据处理。
配置 LLM 是至关重要的一步。你需要拥有一个遵循 OpenAI 规范的大模型 API Key。虽然本文不推荐具体平台，但请确保你的模型支持函数调用或代码解释功能，以获得最佳效果。
最简单的实现方式是在本地 Python 环境中直接运行代码。这种方式适合快速原型验证，但存在安全风险，因为代码将在你的机器上以当前用户权限运行。
以下是基础代码示例：
import os
import autogen
from autogen import AssistantAgent, UserProxyAgent
# 配置 LLM 参数
llm_config = {
"model": "gpt-4-turbo", # 替换为你的模型名称
"api_key": "sk-xxxxx", # 替换为你的 API Key
"base_url": "https://api.openai.com/v1" # 如果是兼容接口需修改
}
# 初始化助手
assistant = AssistantAgent(
name="assistant",
llm_config=llm_config,
system_message="You are a helpful assistant. You can write and execute code."
)
# 初始化用户代理，绑定本地代码执行器
user_proxy = UserProxyAgent(
name="user_proxy",
code_execution_config={
"executor": autogen.coding.LocalCommandLineCodeExecutor(work_dir="coding_local")
},
human_input_mode="NEVER" # 设置为 NEVER 可自动执行，设为 ALWAYS 则每次询问
)
# 发起对话
user_proxy.initiate_chat(
assistant,
message="绘制 NVDA 和 TESLA 股价本年迄今变化图。将绘图保存到名为 plot.png 的文件中。"
)
在这个例子中，human_input_mode 设置为 NEVER 意味着 Agent 生成的代码将自动执行，无需人工干预。如果设置为 ALWAYS，每次执行代码前都会暂停等待用户确认，这在生产环境中更安全。
为了提升安全性，避免恶意代码对宿主系统造成损害，建议使用 Docker 容器来执行代码。AutoGen 原生支持 Docker 命令行代码执行器。
使用前请确保系统已安装 Docker 服务。以下是使用 Docker 容器的配置代码：
import os
import autogen
from autogen import AssistantAgent, UserProxyAgent
llm_config = {
"model": "gpt-4-turbo",
"api_key": "sk-xxxxx",
"base_url": "https://api.openai.com/v1"
}
# 使用 Docker 作为代码执行环境
with autogen.coding.DockerCommandLineCodeExecutor(work_dir="deepseek-coding") as code_executor:
assistant = AssistantAgent("assistant", llm_config=llm_config)
user_proxy = UserProxyAgent(
"user_proxy",
code_execution_config={"executor": code_executor},
human_input_mode="NEVER"
)
user_proxy.initiate_chat(
assistant,
message="绘制 NVDA 和 TESLA 股价本年迄今变化图。将绘图保存到名为 plot.png 的文件中。"
)
当代码执行时，AutoGen 会自动启动一个名为 autogen-code-exec-xx 的 Docker 容器。代码在容器内运行，执行完毕后容器会被清理。这有效隔离了文件系统和网络访问权限。
AutoGen 的强大之处在于其闭环调试能力。让我们分析一下上述任务的执行流程：
yfinance 下载数据并使用 matplotlib 绘图。在实际运行中，你可能会遇到依赖缺失的问题。例如，初次运行可能报错 ModuleNotFoundError: No module named 'yfinance'。此时，Agent 会识别错误，生成 pip install yfinance 命令，并在容器中安装依赖，然后再次尝试运行绘图脚本。这种机制模拟了人类程序员调试问题的过程。
在 Docker 环境中，每次启动新容器都需要重新安装依赖。为了优化性能，可以在 Dockerfile 中预装常用库，或者让 Agent 自行处理依赖安装。对于生产环境，建议将依赖锁定在 requirements.txt 中，并在容器启动时统一安装。
调用 LLM 会产生费用。在长对话或多轮迭代中，Token 消耗会增加。可以通过以下方式优化：
temperature 参数，降低随机性。尽管 Docker 提供了隔离，但仍需注意敏感信息泄露。不要在代码中硬编码 API Key 或数据库密码。建议在环境变量中配置敏感信息，并通过 os.environ 读取。
LLM 的上下文窗口有限。如果任务涉及大量历史对话或超长代码，可能会导致截断。定期总结对话历史或使用摘要技术有助于保持上下文完整性。
通过 AutoGen 框架，我们可以用极少的代码构建出具备自主执行能力的 AI Agent。从简单的本地执行到安全的 Docker 隔离，该框架展示了多智能体协作的潜力。无论是数据分析、自动化运维还是内容生成，Agent 都能显著提高效率。
本文介绍了 AutoGen 的基础用法、环境配置及核心组件。随着技术的演进，未来 Agent 将能处理更复杂的跨应用任务，成为个人和企业数字化的重要助手。开发者应关注其安全机制与成本控制，以便在实际项目中落地应用。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
使用加密算法（如AES、TripleDES、Rabbit或RC4）加密和解密文本明文。 在线工具，加密/解密文本在线工具，online
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具，curl 转代码在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online