Windows下AutoGen全家桶部署与优化指南

1. Windows环境下的AutoGen全家桶部署指南

上周在本地环境折腾AutoGen时踩了不少坑，今天把完整的Windows部署流程整理成文档。不同于简单的pip install，这里会涵盖AutoGen核心框架、可视化工具AutoGenStudio以及LiteLLM代理服务的完整配置方案，特别针对Windows特有的环境问题给出解决方案。

2. 环境准备与基础配置

2.1 系统环境要求

• Windows 10/11 64位（建议版本21H2以上）
• Python 3.8-3.11（实测3.10最稳定）
• 至少8GB内存（运行AutoGenStudio建议16GB）
• 管理员权限的PowerShell

注意：避免使用中文用户名路径，可能引发包依赖解析错误

2.2 Python环境配置

推荐使用Miniconda创建独立环境：

bash复制conda create -n autogen python=3.10
conda activate autogen

安装基础依赖：

bash复制pip install --upgrade pip setuptools wheel

3. AutoGen核心框架安装

3.1 标准安装方式

bash复制pip install pyautogen

3.2 开发模式安装（推荐）

适合需要自定义agent的场景：

bash复制git clone https://github.com/microsoft/autogen.git
cd autogen
pip install -e .

3.3 验证安装

创建test_autogen.py：

python复制import autogen
print(autogen.__version__)
config_list = autogen.config_list_from_json("OAI_CONFIG_LIST")
print(config_list)

4. AutoGenStudio可视化工具部署

4.1 前端依赖安装

需要Node.js环境（建议16.x）：

bash复制choco install nodejs # 或用官方安装包
node -v
npm -v

4.2 项目克隆与构建

bash复制git clone https://github.com/microsoft/autogenstudio.git
cd autogenstudio/frontend
npm install
npm run build

4.3 后端服务启动

bash复制cd ../backend
pip install -r requirements.txt
python app.py

访问 http://localhost:8080 即可使用

5. LiteLLM代理服务配置

5.1 基础安装

bash复制pip install litellm

5.2 环境变量配置

在.env文件中添加：

ini复制OPENAI_API_KEY=sk-xxxx
ANTHROPIC_API_KEY=sk-xxxx

5.3 启动代理

bash复制litellm --model gpt-3.5-turbo

测试代理：

bash复制curl http://localhost:8000/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-3.5-turbo",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

6. 常见问题解决方案

6.1 DLL加载失败问题

症状：ImportError: DLL load failed

解决方案：

1. 安装最新VC++运行库
2. 重装对应版本的Python

6.2 端口冲突处理

修改AutoGenStudio默认端口：

python复制# backend/app.py
app.run(host='0.0.0.0', port=5000) 

6.3 证书错误修复

设置环境变量：

bash复制set REQUESTS_CA_BUNDLE=C:\path\to\cert.pem

7. 性能优化建议

1. 为AutoGenStudio配置Redis缓存：

bash复制pip install redis
docker run -p 6379:6379 redis

2. 启用LiteLLM的批处理模式：

bash复制litellm --batch --model gpt-3.5-turbo

3. Windows专属优化：

powershell复制Set-ItemProperty -Path 'HKLM:\SYSTEM\CurrentControlSet\Control\Session Manager\Memory Management' -Name 'LargeSystemCache' -Value 1